Package Exports

git-coco
git-coco/dist/index.esm.mjs
git-coco/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (git-coco) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

coco banner image

`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

coco commit generating a commit message from 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.

coco ui — a full terminal git workstation

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

Repobeats

License

MIT © gfargo

Thanks for using coco ✨💜