85 lines
2.4 KiB
Markdown
85 lines
2.4 KiB
Markdown
# Graphite Command Reference
|
|
|
|
Quick reference organized by task.
|
|
|
|
## Creating Branches
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt create 'name'` | Create branch (explicit name) |
|
|
| `gt create -m "msg"` | Create branch (name from message) |
|
|
| `gt create 'name' -am "msg"` | Create + stage all + commit |
|
|
| `gt create 'name' --insert -am "msg"` | Insert between current and child |
|
|
|
|
## Modifying Branches
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt modify` | Amend with staged changes |
|
|
| `gt modify -a` | Stage all + amend |
|
|
| `gt modify -acm "msg"` | Stage all + new commit (same branch) |
|
|
| `gt modify --into branch -m "msg"` | Commit staged to different branch |
|
|
|
|
## Absorbing Changes
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt absorb` | Route staged changes to appropriate branch |
|
|
| `gt absorb -a` | Stage all + route to appropriate branches |
|
|
|
|
Use from top of stack when addressing multi-PR feedback.
|
|
|
|
## Stack Reorganization
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt move --onto target` | Move current branch to new parent |
|
|
| `gt move --source src --onto target` | Move specific branch |
|
|
| `gt restack` | Rebase all branches onto updated parents |
|
|
| `gt split` | Split multi-commit branch into stack |
|
|
|
|
## Stack Visualization
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt status` | JSON with parent relationships (scripting) |
|
|
| `gt ls` | Visual tree of stack |
|
|
| `gt log` | Stack history |
|
|
|
|
## Submitting
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt submit` | Submit current + downstack |
|
|
| `gt submit --stack` | Submit entire stack |
|
|
| `gt submit --no-interactive` | Non-interactive (automation) |
|
|
|
|
## Sync and Maintenance
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt sync` | Pull trunk, rebase, clean merged |
|
|
| `gt restack` | Rebase branches onto updated parents |
|
|
| `gt undo` | Undo last gt operation |
|
|
|
|
## Metadata Management
|
|
|
|
| Command | Purpose |
|
|
| ------- | ------- |
|
|
| `gt track branch` | Add branch to Graphite tracking |
|
|
| `gt untrack branch` | Remove from Graphite tracking |
|
|
| `gt repo fix` | Attempt automatic repair |
|
|
|
|
## Flags
|
|
|
|
Common flags across commands:
|
|
|
|
| Flag | Meaning |
|
|
| ---- | ------- |
|
|
| `-a` | Stage all changes |
|
|
| `-m "msg"` | Commit message |
|
|
| `-am "msg"` | Stage all + commit message |
|
|
| `--insert` / `-i` | Insert between current and child |
|
|
| `--no-interactive` | Skip prompts (automation) |
|
|
| `--stack` | Apply to entire stack |
|