Skip to main content

Navigation

Sapling’s emphasis on editing stacks of commits means users move between commits more often than with other version control systems. To make this easy and intuitive, Sapling provides a number of ways to move around your repository.

Goto​

sl goto COMMIT or sl go COMMIT is the standard way to checkout a commit in your repository.

# The '@' indicates your currently checked out commit.
$ sl
@  b84224608  13 minutes ago  remote/main
╷
╷ o  15de72785  35 seconds ago  mary  my_feature
╭─╯  Implement glorious features
│
o  a555d064c  Wednesday at 09:06
│
~

$ sl goto 15de72785

$ sl
o  b84224608  13 minutes ago  remote/main
╷
╷ @  15de72785  35 seconds ago  mary  my_feature
╭─╯  Implement glorious features
│
o  a555d064c  Wednesday at 09:06
│
~

The argument passed to sl goto can be one of the following:

  • A full 40-character commit hash, such as b8422460814900d8f978a8a34a99ae83c6735a70.
  • A short, unique-prefix commit hash, such as b84224608.
  • A local bookmark name, such as my_feature in the example above.
  • A remote bookmark name, such as main in the example above. Note, the remote/ prefix is optional.
  • A revset query (see below).

Auto-pull​

By default, Sapling only clones the main bookmark of a repository. Even if you don’t have the remote bookmark locally yet, you can do sl goto remote/other_bookmark and it will automatically pull and checkout the remote bookmark for you.

To trigger an auto-pull, you must specify the remote/ prefix.

Next/Prev​

When working with a stack of commits, you can use sl next and sl prev to move up and down your stack with ease.

# The '@' indicates your currently checked out commit.
$ sl
o  5abffb82f  Wednesday at 09:39  remote/main
╷
╷ @  824cbba75  13 minutes ago  mary
╷ │  [eden] Support long paths in Windows FSCK
╷ │
╷ o  19340c083  Wednesday at 09:39  mary
╷ │  [eden] Close Windows file handle during Windows Fsck
╷ │
╷ o  b52192598  Wednesday at 09:39  mary
╭─╯  [eden] Use PathMap for WindowsFsck
│
o  2ac18611a  Wednesday at 05:00  remote/stable
╷
~

# Move down the stack from 824cbba75 to 19340c083.
$ sl prev

# Move back up the stack to 824cbba75.
$ sl next

# Move down the stack 2 commits to b52192598.
$ sl prev 2

Note, if a commit has multiple children or parents, next and prev may alert you and you have to choose.

Top/Bottom​

When in a stack, you can jump directly to the top or bottom using sl goto top and sl goto bottom.

# The '@' indicates your currently checked out commit.
$ sl
o  5abffb82f  Wednesday at 09:39  remote/main
╷
╷ @  824cbba75  13 minutes ago  mary
╷ │  [eden] Support long paths in Windows FSCK
╷ │
╷ o  19340c083  Wednesday at 09:39  mary
╷ │  [eden] Close Windows file handle during Windows Fsck
╷ │
╷ o  b52192598  Wednesday at 09:39  mary
╭─╯  [eden] Use PathMap for WindowsFsck
│
o  2ac18611a  Wednesday at 05:00  remote/stable
╷
~

# Move down to b52192598 at the bottom.
$ sl goto bottom

# Move back up to 824cbba75 at the top.
$ sl goto top

Revsets​

sl goto REVSET can use the revset query language to specify a commit to go to. See the Revset documentation for more details.

Example revsets:

  • . Your current commit.
  • .^ Parent of your current commit.
  • 824cbba75~2 Second ancestor of 824cbba75.
  • 19340c083~-1 Child of 19340c083.
  • ancestor(., main) The first common ancestor of your current commit and main (that is, 2ac18611a in the examples above).
  • pr42 Pull request #42 on GitHub repos.