Skip to main content

Commit syntax

All commands that accept a commit reference support the following syntax:

A commit can be identified by either its local ID (#<n>) or its server ID (c/<n>). Both forms may optionally specify a version (v<number>).

Local​

  • <number>
    Example: 1 → Refers to local commit 1 at its latest version.
  • <number><v or V><number>
    Example: 1v2, 1V2 → Refers to local commit 1, version 2.

Server​

  • c<optional "/"><number>
    Example: c1, c/1 → Refers to server commit 1 at its latest version.

  • c<optional "/"><number><v or V><number>
    Example: c1v2, c1V2, c/1v2, c/1V2 → Refers to server commit 1, version 2.

Aliases​

Shortcuts for referencing specific commits.

  • top → Last submitted commit.
    Example: tw rebase top rebase the current commit onto the last submitted commit.
  • up → Latest version of one of the children of the current commit.
    Example: tw hide up, hide child commit.
  • down → Latest version of parent commit.
    Example: tw down, navigate to parent commit latest version.