zero-effort git commits with coco.
npm install git-cocococo






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
``bashTry without installing
npx git-coco@latest init
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 wizardUsage Examples
$3
`bash
Make your changes
git add .Generate commit message (interactive mode recommended)
coco -iOr use stdout mode
git commit -m "$(coco)"
`$3
`bash
Enable conventional commits format
coco --conventionalWith additional context
coco -a "Fixes login timeout" --conventionalInclude ticket from branch name
coco --append-ticket --conventional
`$3
`bash
Generate changelog for releases
coco changelog --since-last-tagSummarize recent work
coco recap --yesterdayCode review before committing
coco review
`Configuration
Configure
coco for your workflow with the interactive setup wizard:`bash
Setup wizard
coco initProject-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"
}
}
``For comprehensive guides, advanced usage, and detailed configuration options, visit our complete documentation:
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
- Troubleshooting Guide - Comprehensive problem-solving resource
- GitHub Issues - Bug reports and feature requests
- Discord Community - Real-time help and discussion
We welcome contributions! Check out our CONTRIBUTING.md for more information.
!Alt
MIT © gfargo

Thanks for using coco ✨💜