Index

Common CLI commands

While you can find a full list of gt commands in the command reference, there are a handful of common commands and combinations to remember.

This list is grouped by primary function.

Basic workflow commands

These commands are constantly in use when creating and pushing changes to a repository with Graphite.

Command	Alias	Description
`gt log short`	`gt ls`	Run any time branches are created/manipulated/changed
`gt branch create --all --message <COMMIT_MESSAGE>`	`gt bc -am <COMMIT_MESSAGE>`	Create changes, stage the changes, create a new branch and commit the changes to the new branch all at once
`gt commit create --message <COMMIT_MESSAGE>`	`gt cc -m <COMMIT_MESSAGE>`	Update an existing branch with new changes by creating an entirely new commit on that branch
`gt commit amend`	`gt ca`	Update an existing branch with new changes by amending the existing commit on that branch
`gt repo sync --restack`	`gt rs -r`	Pull changes from your trunk branch and subsequently restack upstack changes
`gt stack submit`	`gt ss`	Submit your changes across all PRs on a stack

Commands to view teammates' code and communicate changes.

Command	Alias	Description
`gt downstack get <BRANCH_NAME>`	`gt dsg <BRANCH_NAME>`	Get a stack locally that's been created or manipulated by someone else. Often followed up with `gt bdl` to delete irrelevant branches locally.
`gt branch checkout`	`gt bco`	Often used when to check out a singular branch for collaboration OR personal use

Commands to move up and down the stack, and to restack branches (if necessary).

Command	Alias	Description
`gt branch up, gt branch down`	`gt bu, gt bd`	Quickly move up and down a stack of branches. By default, it takes a step argument of 1, but can add a step value (for example, `gt branch up 2`) to skip a certain number of branches.
`gt branch bottom, gt branch top`	`gt bb, gt bt`	Quickly move all the way down (`bb`) or all the way up (bt) a stack

Last modified 5 days ago

On this page

Basic workflow commands