| name | graphite |
| description | Manage stacked pull requests using Graphite CLI. Create, submit, and restack PR chains. |
Graphite Stacked PRs
Use Graphite CLI to manage stacked pull requests - a workflow for breaking large features into smaller, dependent PRs.
Commands
Create a stack
gt create -m "First PR in stack"
git add .
git commit -m "Implement feature A"
gt create -m "Second PR in stack"
git add .
git commit -m "Implement feature B"
Submit the stack
gt stack submit
This creates multiple PRs where each depends on the one before it.
Restack after changes
If you make changes to an earlier PR in the stack:
gt checkout <branch-name>
git add .
git commit -m "Update"
gt stack restack
View the stack
gt stack
gt log
Other useful commands
gt branch
gt branch delete <branch-name>
gt stack sync
Workflow Example
Building a feature that needs multiple PRs:
gt checkout main
gt sync
gt create -m "Add user preferences table"
git commit -m "Add migrations and models"
gt create -m "Add preferences API endpoints"
git commit -m "Implement CRUD endpoints"
gt create -m "Add preferences UI"
git commit -m "Build settings page"
gt stack submit
This creates 3 PRs:
- Database changes (based on main)
- API endpoints (based on #1)
- UI (based on #2)
When #1 is merged, Graphite automatically restacks #2 and #3 on main.
Tips
- Keep each PR focused and reviewable
- Write clear PR descriptions
- Use
gt stack frequently to visualize your work
- When a PR is approved, merge it from GitHub - Graphite will handle the rest
Authentication
Graphite CLI is pre-authenticated in OmniClaw containers using your GitHub token. No manual auth needed.
Documentation
Full docs: https://graphite.com/docs