This command displays a list of repositories in a separate buffer.
magit-repository-directories-depth control which repositories are displayed.
user option magit-repolist-columns
This option controls what columns are displayed by the command
magit-list-repositories and how they are displayed.
Each element has the form
(HEADER WIDTH FORMAT PROPS).
HEADER is the string displayed in the header. WIDTH is the width of the column. FORMAT is a function that is called with one argument, the repository identification (usually its basename), and with
default-directory bound to the toplevel of its working tree. It has to return a string to be inserted or nil. PROPS is an alist that supports the keys
You may wish to display a range of numeric columns using just one character per column and without any padding between columns, in which case you should use an appropriate HEADER, set WIDTH to 1, and set
:pad-right to 0.
+ is substituted for numbers higher than 9.
The following functions can be added to the above option:
This function inserts the identification of the repository. Usually this is just its basename.
This function inserts the absolute path of the repository.
This function inserts a description of the repository’s
This function inserts the name of the current branch.
This function inserts the name of the upstream branch of the current branch.
This function inserts the number of branches.
This function inserts the number of stashes.
This function inserts a flag as specified by
By default this indicates whether there are uncommitted changes.
Nif there is at least one untracked file.
Uif there is at least one unstaged file.
Sif there is at least one staged file.
Only the first one of these that applies is shown.
This function inserts the number of upstream commits not in the current branch.
This function inserts the number of commits in the push branch but not the current branch.
This function inserts the number of commits in the current branch but not its upstream.
This function inserts the number of commits in the current branch but not its push branch.