!coco banner image

coco


An AI-powered git assistant that generates meaningful commit messages, creates changelogs, and streamlines your development workflow.

✨ Key Features:

- 🤖 AI-Powered Commit Messages - Generate contextual commits from your staged changes
- 📋 Conventional Commits - Full support with automatic validation and formatting
- 🔧 Commitlint Integration - Seamless integration with your existing commitlint configuration
- 🏠 Local AI Support - Run completely offline with Ollama (no API costs, full privacy)
- 📦 Package Manager Friendly - Works with npm, yarn, and pnpm
- 👥 Team Ready - Shared configurations and enterprise deployment

Quick Start

``bash


Try without installing

npx git-coco@latest init

Install globally

npm install -g git-coco

Setup and configure

coco init

Generate your first commit

git add .
coco -i
`

Commands

- coco commit - Generate commit messages from staged changes
- coco changelog - Create changelogs from commit history
- coco recap - Summarize recent changes and activity
- coco review - AI-powered code review of your changes
- coco init - Interactive setup wizard

Usage Examples

$3

`bash


Make your changes

git add .

Generate commit message (interactive mode recommended)

coco -i

Or use stdout mode

git commit -m "$(coco)"
`

$3

`bash


Enable conventional commits format

coco --conventional

With additional context

coco -a "Fixes login timeout" --conventional

Include ticket from branch name

coco --append-ticket --conventional
`

$3

`bash


Generate changelog for releases

coco changelog --since-last-tag

Summarize recent work

coco recap --yesterday

Code review before committing

coco review
`

Configuration

Configure coco for your workflow with the interactive setup wizard:

`bash


Setup wizard

coco init

Project-specific setup

coco init --scope project
`

AI Providers:
- OpenAI - GPT-4o, GPT-4o-mini (API key required)
- Anthropic - Claude 3.5 Sonnet (API key required)
- Ollama - Local models, no API costs, full privacy

Example Configuration:
`json
{
"mode": "interactive",
"conventionalCommits": true,
"service": {
"provider": "openai",
"model": "gpt-4o"
}
}
``

Documentation

For comprehensive guides, advanced usage, and detailed configuration options, visit our complete documentation:

$3

Essential Guides:
- Getting Started - Complete beginner's guide from installation to first commit
- Command Reference - Detailed command options and examples
- Configuration Overview - All configuration options and setup methods
- Team Collaboration - Enterprise deployment and team adoption strategies

Advanced Resources:
- Using Ollama - Local AI setup for privacy and cost control
- Advanced Usage - Custom prompts, automation, and power-user features
- Troubleshooting - Solutions for common issues and debugging

$3

- Troubleshooting Guide - Comprehensive problem-solving resource
- GitHub Issues - Bug reports and feature requests
- Discord Community - Real-time help and discussion

Contribution

We welcome contributions! Check out our CONTRIBUTING.md for more information.

Project Stats

!Alt

License

MIT © gfargo