Skip to main content


status | st

list files with pending changes

Show status of files in the working copy using the following status indicators:

M = modified
A = added
R = removed
C = clean
! = missing (deleted by a non-sl command, but still tracked)
? = not tracked
I = ignored
= origin of the previous file (with --copies)

By default, shows files that have been modified, added, removed, deleted, or that are unknown (corresponding to the options -mardu, respectively). Files that are unmodified, ignored, or the source of a copy/move operation are not listed.

To control the exact statuses that are shown, specify the relevant flags (like -rd to show only files that are removed or deleted). Additionally, specify -q/--quiet to hide both unknown and ignored files.

To show the status of specific files, provide a list of files to match. To include or exclude files using patterns or filesets, use -I or -X.

If --rev is specified and only one revision is given, it is used as the base revision. If two revisions are given, the differences between them are shown. The --change option can also be used as a shortcut to list the changed files of a revision from its first parent.

sl status might appear to disagree with sl diff if permissions have changed or a merge has occurred, because the standard diff format does not report permission changes and sl diff only reports changes relative to one merge parent.

The -t/--terse option abbreviates the output by showing only the directory name if all the files in it share the same status. The option takes an argument indicating the statuses to abbreviate: 'm' for 'modified', 'a' for 'added', 'r' for 'removed', 'd' for 'deleted', 'u' for 'unknown', 'i' for 'ignored' and 'c' for clean.

It abbreviates only those statuses which are passed. Note that clean and ignored files are not displayed with --terse ic unless the -c/--clean and -i/--ignored options are also used.

The -v/--verbose option shows information when the repository is in an unfinished merge, shelve, rebase state, etc. You can have this behavior turned on by default by enabling the commands.status.verbose config option.

You can skip displaying some of these states by setting commands.status.skipstates to one or more of: 'bisect', 'graft', 'histedit', 'merge', 'rebase', or 'unshelve'.


  • show changes in the working directory relative to a commit:
sl status --rev 88a692db8
  • show changes in the working copy relative to the current directory (see sl help patterns for more information):
sl status re:
  • show all changes including copies in a commit:
sl status --copies --change 88a692db8
  • get a NUL separated list of added files, suitable for xargs:
sl status -an0
  • show more information about the repository status, abbreviating added, removed, modified, deleted, and untracked paths:
sl status -v -t mardu

Returns 0 on success.


-A--allfalseshow status of all files
-m--modifiedfalseshow only modified files
-a--addedfalseshow only added files
-r--removedfalseshow only removed files
-d--deletedfalseshow only deleted (but tracked) files
-c--cleanfalseshow only files without changes
-u--unknownfalseshow only unknown (not tracked) files
-i--ignoredfalseshow only ignored files
-n--no-statusfalsehide status prefix
-C--copiesfalseshow source of copied files
-0--print0falseend filenames with NUL, for use with xargs
--revshow difference from revision
--changelist the changed files of a revision
--root-relativefalseshow status relative to root
-I--includeinclude files matching the given patterns
-X--excludeexclude files matching the given patterns