Skip to content

Audit and update completion spec: Graphite CLI (gt)#231

Merged
lucieleblanc merged 3 commits into
mainfrom
app-3518/command-spec-gt-audit
Apr 3, 2026
Merged

Audit and update completion spec: Graphite CLI (gt)#231
lucieleblanc merged 3 commits into
mainfrom
app-3518/command-spec-gt-audit

Conversation

@lucieleblanc
Copy link
Copy Markdown
Contributor

@lucieleblanc lucieleblanc commented Apr 1, 2026

Summary

Audited the Graphite CLI (gt) completion spec against the official command reference and filled in all identified gaps.

New commands added (9)

  • gt abort — Abort a rebase conflict
  • gt absorb (alias: ab) — Amend staged changes to relevant commits
  • gt add — git add passthrough
  • gt cherry-pick — git cherry-pick passthrough
  • gt demo — Run interactive demos
  • gt freeze — Freeze a branch to prevent local modifications
  • gt guide — Read extended guides
  • gt unfreeze — Unfreeze a previously frozen branch
  • gt unlink — Unlink a branch from its associated PR

Updated commands (11)

  • aliases: Added --legacy flag
  • checkout: Added --all, --stack, --trunk flags
  • create: Added --ai, --no-ai, --update, --verbose flags
  • delete: Added --close, --downstack, --upstack flags; made name arg optional
  • feedback: Updated flags to match current docs (-d shorthand for --with-debug-context)
  • get: Added --downstack, --restack, --unfrozen, --remote-upstack flags
  • info: Added optional [branch] argument with local_branches generator
  • merge: Added mg alias
  • modify: Added --into flag with local_branches generator
  • pop: Fixed typo in description ("reaint" → "retain")
  • trunk: Added --add flag

Generator verification screenshots

1. gt checkout — local_branches generator + new flags
gt checkout completions

2. gt revert — commits generator
gt revert completions

3. gt freeze (new command) — local_branches generator
gt freeze completions

4. gt info — local_branches generator (new branch argument)
gt info completions

5. gt delete — local_branches generator + new flags
gt delete completions

Test Plan

  • script/presubmit passes (formatting, clippy, all tests)
  • Tested all generators (local_branches, commits) end-to-end in a local Warp build against a test repository with multiple branches and commits
  • Verified completions for both existing commands (checkout, delete, revert, info) and new commands (freeze, unfreeze)

Conversation: https://staging.warp.dev/conversation/f589d813-9305-468f-8cb3-42af69f5d06f
Run: https://oz.staging.warp.dev/runs/019d4b07-78b4-7955-bc0f-dbb28223126d

This PR was generated with Oz.

Add 9 missing commands: abort, absorb, add, cherry-pick, demo, freeze,
guide, unfreeze, unlink.

Update 11 existing commands with missing flags/options:
- aliases: add --legacy flag
- checkout: add --all, --stack, --trunk flags
- create: add --ai, --no-ai, --update, --verbose flags
- delete: add --close, --downstack, --upstack flags; make name arg optional
- feedback: update flags to match current docs (-d shorthand)
- get: add --downstack, --restack, --unfrozen, --remote-upstack flags
- info: add optional branch argument with local_branches generator
- merge: add mg alias
- modify: add --into flag with local_branches generator
- pop: fix typo in description (reaint -> retain)
- trunk: add --add flag

Co-Authored-By: Oz <oz-agent@warp.dev>
@linear
Copy link
Copy Markdown

linear Bot commented Apr 1, 2026

APP-3518 Audit Graphite CLI (gt) completions spec for gaps

gt.json spec exists with a gt.rs generator. Audit the current Graphite CLI commands against our completions spec to see if there's anything missing or outdated.

Co-Authored-By: Oz <oz-agent@warp.dev>
@lucieleblanc
Copy link
Copy Markdown
Contributor Author

Screenshots:

image image image image image

@lucieleblanc lucieleblanc marked this pull request as ready for review April 3, 2026 15:00
@lucieleblanc lucieleblanc merged commit 3b3ce21 into main Apr 3, 2026
3 checks passed
@lucieleblanc lucieleblanc deleted the app-3518/command-spec-gt-audit branch April 3, 2026 16:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants