Command Reference
For info about the flags and arguments of any command, just run `gt <command> --help`
The aliases listed in the table are the shortest possible way to invoke each command. A noun-verb command can be typed all of the following ways:
  • gt branch create
  • gt b create
  • gt branch c
  • gt b c
  • gt bc
Command group
Command
Alias
Description
auth
Add your auth token to enable Graphite CLI to create and update your PRs on GitHub.
branch
bottom
bb
Switch to the first branch from trunk in the current stack.
branch
checkout
bco
Switch to a branch.
branch
create
bc
Create a new branch stacked on top of the current branch and commit staged changes. If no branch name is specified but a commit message is passed, generate a branch name from the commit message.
branch
delete
bdl
Delete a branch and its corresponding Graphite metadata.
branch
down
bd
Switch to the parent of the current branch.
branch
edit
be
Run an interactive rebase on the current branch's commits and restack upstack branches.
branch
fold
bf
Fold a branch's changes into its parent, update dependencies of descendants of the new combined branch, and restack.
branch
rename
brn
Rename a branch and update metadata referencing it. Note that this removes any associated GitHub pull request.
branch
restack
br
Ensure the current branch is based on its parent, rebasing if necessary.
branch
info
bi
Display information about the current branch.
branch
split
bsp
Split the current branch into multiple branches.
branch
squash
bsq
Squash all commits in the current branch and restack upstack branches.
branch
submit
bs
Idempotently force push the current branch to GitHub, creating or updating a pull request.
branch
top
bt
Switch to the tip branch of the current stack. Prompts if ambiguous.
branch
track
btr
Start tracking the current branch (by default) with Graphite by selecting its parent. This command can also be used to fix corrupted Graphite metadata.
branch
untrack
but
Stop tracking a branch with Graphite. If the branch has children, they will also be untracked.
branch
up
bu
Switch to the child of the current branch. Prompts if ambiguous.
changelog
Show the Graphite CLI changelog.
commit
amend
ca
Amend the most recent commit and restack upstack branches.
Export as PDF
Copy link