ggx：用 Codex、Claude 或 Copilot 自动生成分支、提交与 PR 文案的 Git 工具

Ship git work without writing the branch, commit, or PR copy yourself.

branch · commit · pull request · merge

Install

curl -fsSL https://github.com/maty-millien/ggx/releases/latest/download/ggx-installer.sh | sh
ggx setup

Works on macOS and Linux. You'll need git, GitHub CLI (gh), and Codex, Claude, or GitHub Copilot.

Setup and updates

Authenticate gh and your chosen AI CLI before running ggx setup. For Copilot, sign in once with the GitHub Copilot CLI or any editor with Copilot; ggx reuses that login and needs curl. Your provider choice applies to every repository. Run setup again at any time to switch.

To configure a provider without an interactive terminal, run ggx setup --provider codex, ggx setup --provider claude, or ggx setup --provider copilot. Setup validates credentials before saving the choice.

ggx checks for stable updates once a day in the background. To update now and see the current version, installed version, and elapsed time, run:

ggx update

The workflow

  local changes
       │
       ▼
  ggx branch ─── name branch, commit, push
       │
       ▼
  ggx commit ─── commit more work, push
       │
       ▼
  ggx pr ─────── open a pull request
       │
       ▼
  ggx merge ──── merge, sync, clean up

ggx branch "add billing webhook retries"
ggx commit
ggx pr --base dev --draft
ggx merge

Run ggx sync whenever you want to update the default branch and clean safe local branches. If the checked-out branch was deleted on its remote and has no ahead commits, cleanup deletes it and leaves you on the default branch.

Command guide

I want to…	Run
Choose Codex, Claude, or Copilot	`ggx setup [--provider codex\|claude\|copilot]`
Start work from pending changes	`ggx branch [prompt]`
Commit and push current changes	`ggx commit`
Open a pull request	`ggx pr [--draft]`
Sync and clean local branches	`ggx sync`
Merge the current pull request	`ggx merge`
Squash-merge the current pull request	`ggx squash`
Install the latest stable release	`ggx update`

Add -y or --yes after any command except setup to automatically confirm its actions without ggx menus or terminal input:

ggx commit -y
ggx pr --draft --yes
ggx sync -y

This also approves local branch cleanup in sync. Previews, progress, and errors remain visible, and normal validation still applies. update -y is accepted, though updates already need no confirmation. Git/SSH authentication prompts retain their existing behavior. For unattended setup, use --provider instead; setup does not accept -y or --yes.

Useful pull request and merge options

ggx pr --base dev       # Open against dev
ggx pr --closes 123     # Use issue 123 as context
ggx merge --keep-branch # Keep the branch after merging
ggx squash --keep-branch

Add --admin to merge or squash when GitHub requires elevated permissions.

What happens behind the scenes?

ggx reads the current git state and diff, then asks your chosen AI provider, using the login of its CLI, to generate the relevant branch name, commit message, or pull request copy. By default, you review and confirm the result before it stages, commits, or pushes anything. With -y/--yes, ggx displays the result and proceeds automatically.

It uses:

gpt-6-luna with no reasoning effort through Codex, calling its backend directly with your Codex login and needing curl
haiku through Claude, calling the Messages API directly with your Claude login and needing curl
the default inline completion engine through GitHub Copilot
GitHub CLI for pull requests, merges, and branch cleanup

Syncing and merging require a clean worktree. Pull request creation stops if the current branch already has an open pull request. Closed and merged pull requests do not prevent creating a new one from the same branch.

License

MIT