The AI git toolbelt & terminal workstation.

Commits, changelogs, reviews, PRs, and a 16-view keyboard workstation — one binary. Seven AI providers including fully local Ollama. Works on every major platform.

npx git-coco@latest init
$ coco ui~/project
coco ui — browsing history, opening diffs, and chord-switching views
see workstation
~/coco $ --help

Every command, intentionally crafted

Each command solves a real problem on its own. Pick the one you need, or use them all.

commit

Write your commits with AI

Generate intelligent commit messages from staged changes with optional Conventional Commits support and automatic commitlint validation.

$ coco commit

Key flags

  • -i, --interactiveOpen editor for review and editing
  • -s, --stage-allStage all changes and commit in one step
  • --conventionalForce conventional commits mode
  • --append [text]Add content to end of commit message
  • -t, --append-ticketAuto-append Jira/Linear ticket from branch
  • --open-in-editorOpen message in editor before committing

Dynamic model routing

coco supports dynamic model routing which selects the best model per task — a fast model for commits, a thorough one for changelogs and reviews. Works across seven providers: OpenAI, Anthropic, Gemini, Mistral, Azure OpenAI, AWS Bedrock, and Ollama for fully local, private operation.

~/coco $ ui

One surface for everything

A keyboard-driven Git workstation that lives in your terminal. All your tools, all your views, one screen.

coco ui — switching between history, status, branches, and diff views via chord navigation
chord nav

Keyboard-driven navigation

g + key chord navigation across all views — no mouse required.

16 specialized views

History, status, diff, compose, branches, tags, stash, worktrees, pull-request, PR triage, issues, conflicts, reflog, bisect, submodules, and changelog. Drill into any submodule with Enter — every view re-scopes to it.

Tactile hunk staging

Stage hunk by hunk with ● / ○ badges and ↑/↓ navigation — precise control over every commit, never the whole file by accident.

AI-assisted commits

Draft commit messages with AI right from the compose view.

PR workflows

Merge, approve, and comment on pull requests without leaving the terminal.

Fits any terminal

Down to an 80×24 tmux split, the panes fold to a single full-width view you Tab between — press v to peek the sidebar and snap back.

See the full workstation
~/coco $ features

Key Features

Powerful capabilities that adapt to your workflow and coding standards

AI-Powered Git Commands

Each command solves a specific problem: intelligent commits, automated changelogs, code recaps for standups, AI code reviews, and commit splitting for clean history.

$commit$changelog$recap$review$split

Terminal Workstation

A keyboard-driven Git workstation with 16 views — including a full stash workflow, tactile hunk staging, conflict resolution, reflog recovery, bisect, and recursive submodule drill-in — that works at any terminal width and brings every tool together in one surface.

coco ui
coco workstation — history view with commit graph and inspector

Dynamic Model Routing

Task-aware model selection picks the right model for each job. Fast models for commits, thorough models for reviews.

commit
fast
review
deep
changelog
deep

Multi-Provider AI

Seven providers: OpenAI, Anthropic, Gemini, Mistral, Azure OpenAI, AWS Bedrock, and Ollama. Run fully local for complete privacy and zero API costs. coco itself collects no telemetry, and any usage stats it keeps stay local on your machine.

OpenAIconnected
Anthropicconnected
Geminiconnected
Mistralconnected
Azure OpenAIconnected
AWS Bedrockconnected
Ollamalocal

Multi-forge (GitHub + GitLab)

PRs, issues, and the triage workstation work across GitHub, GitHub Enterprise, and GitLab. coco detects your forge and drives gh or glab — same commands, same TUI.

GitHubgh
GitHub Enterprisegh
GitLabglab

Conventional Commits & Commitlint

First-class support for Conventional Commits with automatic commitlint validation and intelligent retry logic.

✓ type-enum
✓ scope-case
✓ subject-max-length
⟳ auto-retry on failure

Instant Boot & Disk Cache

The workstation paints in under 100ms. A per-repo disk cache serves history from the first frame.

<100ms
cachedcold
~/coco $ prs

Works with GitHub and GitLab

coco detects your forge from the git remote and drives the matching CLI — gh for GitHub and GitHub Enterprise, glab for GitLab. The same commands and workstation work across both.

Forge detection

No flags to set. coco reads your remote and shells out to the right tool.

GitHub

Works out of the box — nothing changes.

gh
GitHub Enterprise

Same gh CLI, pointed at your instance.

gh
GitLab

Requires glab installed and authenticated.

glab

PRs & merge requests

coco prs lists and filters PRs/MRs with --json for pipelines. coco pr create opens a PR/MR with an AI-generated title and body.

Issues

coco issues lists, filters, and acts on issues across both forges — same flags, same --json output.

Triage workstation

The full coco ui workstation — PR/issue triage, inspectors, and every per-row action — drives gh or glab transparently.

AI descriptions

PR and MR titles and bodies are generated from your diff, so the same compose flow works wherever you push.

coco ui — GitLab merge-request triage
coco ui GitLab merge-request triage — browsing merge requests with a live inspector showing pipeline checks, approvals, and comments

GitLab merge-request triage in coco ui — draft, pipeline, and approval state with a live inspector. The same view, the same keys, on GitHub.

~/coco $ init

Get started

Get up and running in seconds. One command installs and configures everything.

Homebrew — no prerequisites
brew install gfargo/tap/coco
curl
curl -fsSL https://coco.griffen.codes/install.sh | sh
npm — or try it with npx, no install
npx git-coco@latest init

Then run any of these

One smart entry point, plus a sharp tool for each job.

$cocoSmart entry — opens the workstation in a repo, the setup wizard on a fresh install
$coco commitAI commit messages from your staged changes
$coco changelogGenerate changelogs for any branch or range
$coco reviewCatch issues before you push
$coco uiThe full workstation — every tool, one screen
$coco initSetup wizard — pick a provider, set preferences
~/coco — coco ui
coco ui booting up — the workstation loads a repo's history, branches and diffs the moment you launch it

coco ui — your repo, the moment it boots

~/coco $ docs

Documentation

Getting Started

Complete beginner's guide from installation to first commit

Configuration Overview

All configuration options and setup methods

Team Collaboration

Enterprise deployment and team adoption strategies

Using Ollama

Local AI setup for privacy and cost control

View all docs
~/coco $ community

Community

Drop us a line on Discord or open an issue on GitHub. We're always open to feedback and suggestions.

DiscordDiscussionsBug Report