coco

AI commits, changelogs, code review, PR creation, and a full keyboard-driven git workstation — all from one CLI. coco commit turns your staged diff into a Conventional-Commits-ready message. coco commit --split breaks a large staging area into logical multi-commit groups. coco changelog writes your release notes. coco review catches issues before they ship. coco pr create generates a title and body and opens it on your forge. And coco ui ties it all together in a terminal workstation with 16 views, chord navigation, and one-keystroke workflows. Seven AI providers — including fully local Ollama — on GitHub, GitHub Enterprise, GitLab, and Bitbucket.

The package is git-coco; the command is coco.

git add .
coco commit          # AI writes the message from your staged changes

That's the core. Everything else — changelogs, code review, PRs, and the workstation — is the same engine pointed at more of your git workflow.

Why coco

• 🤖 Smart commits — contextual AI messages from your staged diff, with Conventional Commits and commitlint validation built in
• 🏠 Local-first — run fully offline with Ollama (no API costs, nothing leaves your machine)
• 🖥️ Terminal workstation — 16 views (history, status, diff, branches, PRs, issues, and more) via g-chord navigation + command palette
• 🌐 Multi-forge — GitHub, GitHub Enterprise, GitLab, and Bitbucket from the same tool
• 🎨 120+ themes — Catppuccin, Gruvbox, Dracula, Tokyo Night, and many more, with a live picker (gC)
• 🩺 Self-diagnosing — coco doctor audits your config, providers, and model routing in one command

Install

# Homebrew (macOS/Linux)
brew install gfargo/tap/coco

# curl
curl -fsSL https://coco.griffen.codes/install.sh | sh

# npm (needs Node 22+)
npm install -g git-coco

# try without installing
npx git-coco@latest init

Quick Start

coco init            # pick a provider, set preferences
git add .
coco commit -i       # generate your first commit (interactive)

Commands

| Command | What it does | |---------|-------------| | coco commit | Generate commit messages from staged changes | | coco commit --split | Break a large diff into logical multi-commit groups | | coco amend | Regenerate and rewrite the last commit message | | coco changelog | Create changelogs from commit history (by branch, tag, or range) | | coco pr create | Generate PR title + body and open via gh / glab / Bitbucket API | | coco recap | Summarize recent changes for standups or handoffs | | coco review | AI code review with severity gating for CI (--severity) | | coco ui | Full-screen git workstation — 16 views, keyboard-driven | | coco workspace | Multi-repo overview; drill into any repo as a coco ui session | | coco log | Commit history with graph, filters, and JSON output | | coco prs / coco issues | List PRs or issues across GitHub, GitLab, or Bitbucket | | coco doctor | Diagnose config, providers, model routing, and usage stats | | coco init | Interactive setup wizard |

Global flags: --repo <dir> targets any repo without cd, --json for machine output, --quiet suppresses chrome.

Configuration

coco init                    # interactive setup
coco init --scope project    # project-specific config

Seven providers out of the box — OpenAI, Anthropic, Google Gemini, Mistral, Azure OpenAI, AWS Bedrock, Ollama — plus any OpenAI-compatible endpoint. Keys read from config or environment (OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, etc.).

{
  "service": { "provider": "openai", "model": "gpt-4o" },
  "conventionalCommits": true
}

See the Configuration Overview for every option — themes, per-task model routing, output modes, and more.

Documentation

📚 Wiki — Getting Started, Command Reference, Configuration, Coco UI, Using Ollama, Team Collaboration, Troubleshooting

💬 Discord — real-time help and discussion

🐛 Issues — bug reports and feature requests

Contributing

We welcome contributions — see CONTRIBUTING.md to get started.

Project Stats

License

MIT © gfargo