/ Documentation

Command syntax

gg <desc> [options]

<desc> = short human summary (used in fallback commit message if AI unavailable).

Subcommands

config <apikey> – Securely store Gemini API key.

Options

--type <type> Conventional Commit type (default: feat) --scope <scope> Optional scope, e.g. auth, api, ui --genie Enable AI commit generation (Gemini) --osc Open source contribution mode (see below) --no-branch Commit directly to main (skip prompt) --push-to-main After commit: merge current branch into main & push --remote <url> Add remote origin if repo just initialized --help Show help banner with onboarding guide

Types: feat | fix | docs | style | refactor | test | chore | ci | build | perf

Fallback commit format (no AI or failure): type(scope?): desc.

Command palette (interactive)

Run gg (or start a supported action without enough context) to open the interactive Command Palette.

Keyboard controls:

  • ↑ / ↓ — navigate
  • Enter — select highlighted action
  • Esc or Ctrl+C — cancel

Available actions (subject to evolve):

  • commit — Commit changes with optional AI support
  • config — Save your Gemini API key securely
  • cl — Clone repository
  • b — Create & switch to new branch
  • s — Switch to a branch
  • wt — Create Git worktree (auto-creates branch if missing)

Tip: See the “Command palette demo” section on the homepage for a visual walkthrough of the UI.