Core Commands

Command syntax

gg <desc> [options]

<desc> is a short human summary used for the fallback commit message if AI is unavailable.

Subcommands

• config <apikey> — securely store your Gemini API key.

Options

• --type <type> — Conventional Commit type, default feat.
• --scope <scope> — optional scope such as auth, api, or ui.
• --genie — enable AI commit generation.
• --osc — open source contribution mode.
• --no-branch — commit directly to main and skip branch prompt.
• --push-to-main — merge current branch into main and push.
• --remote <url> — add remote origin for a new repository.
• --help — show the help banner.

Supported types: feat, fix, docs, style, refactor, test, chore, ci, build, perf.

Command palette

Run gg without enough context to open the interactive command palette. Use arrow keys to navigate, Enter to select, and Esc or Ctrl+C to cancel.