~/coco $

Your git toolbelt, sharpened by AI.

Sharp, focused commands that each solve a real problem on their own. commit, changelog, recap, review, and commit split — plus a full terminal workstation that brings them all together.

npx git-coco@latest init
See the workstation
~/coco — coco ui
coco terminal workstation — browsing history, status, branches and diffs by keyboard
~/coco $ --help

Every command, a sharp tool

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 providers: OpenAI, Anthropic, 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

OpenAI, Anthropic, and Ollama. Run fully local for complete privacy and zero API costs.

OpenAIconnected
Anthropicconnected
Ollamalocal

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 $ init

Get started

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

npx git-coco@latest init
then run any of these
  • $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 doctor

coco doctor — verify your setup any time

~/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