CtrlK
BlogDocsLog inGet started
Tessl Logo

pleaseai/graphite

Stacked PR workflow with the Graphite CLI (gt) — create stacks, submit, sync, restack, split/squash/fold, track existing branches, collaborate on shared stacks, configure repo/CI for Graphite, and operate the merge queue.

70

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

get.mdcommands/

description:
Fetch a teammate's stack locally and start collaborating (gt get)
allowed-tools:
Bash, Read
argument-hint:
<branch-name> [--unfrozen | --force]

Pull a teammate's branch (and its full stack) into the local repo so you can review, extend, or build on top. User input: $ARGUMENTS.

Steps

  1. Confirm the working tree is clean (git status --short). If not, ask the user to commit or stash first.
  2. Run gt get <branch>. Graphite fetches the branch and every ancestor up to trunk, tracking each one.
  3. Branches arrive frozen by default — local edits are blocked until they're unfrozen. To start contributing immediately, run with --unfrozen.
  4. Run gt ls to show the user the new stack alongside any existing local stacks.

After fetching

To extend a teammate's stack:

gt co <their-branch>             # navigate to it
gt unfreeze <their-branch>       # if you'll modify it; otherwise skip
# make changes
gt create -am "your addition"    # stack your branch on top
gt submit                        # opens your own PR

To just review without editing, leave the branch frozen — gt sync will still keep it current with the remote.

Key flags

  • -d, --downstack — fetch only this branch's ancestors (default is full stack)
  • -u, --remote-upstack — also fetch children pushed by the teammate
  • --unfrozen — bring in unfrozen so local edits are immediately allowed
  • -f, --force — overwrite any local copies of the same branch

README.md

tile.json