Workflows & Internals

How it works

1. Parse command arguments.
2. Check whether the current folder is a Git repository.
3. Add a remote when --remote is provided.
4. Detect first commit state.
5. Handle branch selection, creation, or open source mode.
6. Stage files when no staged diff exists.
7. Generate an AI commit message when --genie and a key are available.
8. Commit the final message.
9. Push, merge, or clean up branches depending on flags.

Common workflows

Feature with AI and push:

gg "add oauth flow" --type feat --scope auth --genie

Direct quick fix on main:

gg "fix typo in README" --no-branch --genie

Initialize a new repo with remote:

gg "initial commit" --no-branch --remote https://github.com/you/repo.git --genie