{"id":15282763,"url":"https://github.com/gfargo/coco","last_synced_at":"2026-05-11T05:08:55.030Z","repository":{"id":179210878,"uuid":"663130268","full_name":"gfargo/coco","owner":"gfargo","description":"AI-powered Git Assistant for CLI","archived":false,"fork":false,"pushed_at":"2026-04-26T21:02:35.000Z","size":4234,"stargazers_count":9,"open_issues_count":18,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-26T21:05:31.870Z","etag":null,"topics":["ai-git","anthropic","cli","coco","git","git-commit","langchain","langchain-typescript","llms","node","ollama","openai"],"latest_commit_sha":null,"homepage":"https://coco.griffen.codes","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gfargo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.MD","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-07-06T16:05:30.000Z","updated_at":"2026-04-26T19:11:51.000Z","dependencies_parsed_at":"2026-04-26T21:03:25.901Z","dependency_job_id":null,"html_url":"https://github.com/gfargo/coco","commit_stats":null,"previous_names":["gfargo/coco"],"tags_count":91,"template":false,"template_full_name":null,"purl":"pkg:github/gfargo/coco","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfargo%2Fcoco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfargo%2Fcoco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfargo%2Fcoco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfargo%2Fcoco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gfargo","download_url":"https://codeload.github.com/gfargo/coco/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfargo%2Fcoco/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32542202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-git","anthropic","cli","coco","git","git-commit","langchain","langchain-typescript","llms","node","ollama","openai"],"created_at":"2024-09-30T14:39:26.291Z","updated_at":"2026-05-11T05:08:55.024Z","avatar_url":"https://github.com/gfargo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![coco banner image](https://repository-images.githubusercontent.com/663130268/2fc2b7a1-2626-4f9a-9938-a5b410db1b0e)\n\n# `coco`\n\n[![NPM Version](https://img.shields.io/npm/v/git-coco.svg)](https://www.npmjs.com/package/git-coco)\n[![Typescript Support](https://img.shields.io/npm/types/git-coco.svg)](https://www.npmjs.com/package/git-coco)\n[![NPM Downloads](https://img.shields.io/npm/dt/git-coco.svg)](https://www.npmjs.com/package/git-coco)\n[![GitHub issues](https://img.shields.io/github/issues/gfargo/coco)](https://github.com/gfargo/coco/issues)\n[![GitHub pull requests](https://img.shields.io/github/issues-pr/gfargo/coco)](https://github.com/gfargo/coco/pulls)\n[![Last Commit](https://img.shields.io/github/last-commit/gfargo/coco)](https://github.com/gfargo/coco/tree/main)\n[![Discord](https://img.shields.io/discord/1176716060825767948)](https://discord.gg/KGu9nE9Ejx)\n\nAn AI-powered git assistant that generates meaningful commit messages, creates changelogs, explores repository history, and streamlines your development workflow.\n\n**✨ Key Features:**\n\n- 🤖 **AI-Powered Commit Messages** - Generate contextual commits from your staged changes\n- 📋 **Conventional Commits** - Full support with automatic validation and formatting  \n- 🔧 **Commitlint Integration** - Seamless integration with your existing commitlint configuration\n- 🏠 **Local AI Support** - Run completely offline with Ollama (no API costs, full privacy)\n- 🖥️ **Coco UI Git Workstation** - Twelve top-level views (history, status, diff, compose, branches, tags, stash, worktrees, pull-request, conflicts, reflog, bisect) reachable via `g`-prefixed chords, with an interactive command palette (`:`), global search (`/`), and cross-view flows like compare-two-refs and the bisect decision keys\n- 📦 **Package Manager Friendly** - Works with npm, yarn, and pnpm\n- 👥 **Team Ready** - Shared configurations and enterprise deployment\n\n## Quick Start\n\n```bash\n# Try without installing\nnpx git-coco@latest init\n\n# Install globally  \nnpm install -g git-coco\n\n# Setup and configure\ncoco init\n\n# Generate your first commit\ngit add .\ncoco -i\n```\n\n## Commands\n\n- **`coco commit`** - Generate commit messages from staged changes\n- **`coco changelog`** - Create changelogs from commit history  \n- **`coco recap`** - Summarize recent changes and activity\n- **`coco review`** - AI-powered code review of your changes\n- **`coco log`** - Explore commit history with graph, filters, JSON output, and commit details\n- **`coco ui`** - Open the full-screen Git workstation TUI\n- **`coco init`** - Interactive setup wizard\n\n## Usage Examples\n\n### Basic Workflow\n\n```bash\n# Make your changes\ngit add .\n\n# Generate commit message (interactive mode recommended)\ncoco -i\n\n# Or use stdout mode\ngit commit -m \"$(coco)\"\n```\n\n### Conventional Commits\n\n```bash\n# Enable conventional commits format\ncoco --conventional\n\n# With additional context\ncoco -a \"Fixes login timeout\" --conventional\n\n# Include ticket from branch name\ncoco --append-ticket --conventional\n```\n\n### Team Workflows\n\n```bash\n# Generate changelog for releases\ncoco changelog --since-last-tag\n\n# Summarize recent work\ncoco recap --yesterday\n\n# Code review before committing\ncoco review\n\n# Explore commit history\ncoco ui\ncoco ui --view status\ncoco log --limit 20\ncoco log -i\ncoco log --view full --limit 20\ncoco log --all --limit 20\ncoco log --author \"Grace Hopper\" --path src\ncoco log --commit HEAD\ncoco log --format json\n```\n\n### Navigating the TUI\n\n`coco ui` and `coco log -i` share a chord-driven navigation model. Press `g` and then a second key to jump anywhere; `\u003c` (or `Esc`) pops the navigation stack back.\n\n```text\ng h   history          g c   compose         g x   conflicts\ng s   status           g b   branches        g r   reflog\ng d   diff             g t   tags            \u003c     back\n                       g z   stash           Esc   back / close modal\n                       g w   worktrees       ?     help overlay\n                       g p   pull request    :     command palette\n```\n\nThe command palette (`:`) is an interactive launcher with fuzzy filter and recently-used at the top — every keybinding and workflow action is reachable from there. `/` searches the active view (history, branches, tags, stash, or reflog). On branches, tags, and history, press `m` to mark a ref as the compare base — then `Enter` on a second ref opens a `git diff \u003cbase\u003e..\u003chead\u003e` view. See the [Coco UI](https://github.com/gfargo/coco/wiki/Coco-UI) and [TUI Navigation](https://github.com/gfargo/coco/wiki/TUI-Navigation) wiki pages for the full keymap.\n\n## Configuration\n\nConfigure `coco` for your workflow with the interactive setup wizard:\n\n```bash\n# Setup wizard\ncoco init\n\n# Project-specific setup\ncoco init --scope project\n```\n\n**AI Providers:**\n- **OpenAI** - GPT-4o, GPT-4o-mini (API key required)\n- **Anthropic** - Claude 3.5 Sonnet (API key required)  \n- **Ollama** - Local models, no API costs, full privacy\n\n**Example Configuration:**\n```json\n{\n  \"mode\": \"interactive\",\n  \"conventionalCommits\": true,\n  \"logTui\": {\n    \"theme\": {\n      \"preset\": \"catppuccin\"\n    }\n  },\n  \"service\": {\n    \"provider\": \"openai\",\n    \"model\": \"gpt-4o\"\n  }\n}\n```\n\n## Documentation\n\nFor comprehensive guides, advanced usage, and detailed configuration options, visit our complete documentation:\n\n### 📚 **[Coco Wiki](https://github.com/gfargo/coco/wiki)**\n\n**Essential Guides:**\n- **[Getting Started](https://github.com/gfargo/coco/wiki/Getting-Started)** - Complete beginner's guide from installation to first commit\n- **[Command Reference](https://github.com/gfargo/coco/wiki/Command-Reference)** - Detailed command options and examples\n- **[Configuration Overview](https://github.com/gfargo/coco/wiki/Config-Overview)** - All configuration options and setup methods\n- **[Coco UI](https://github.com/gfargo/coco/wiki/Coco-UI)** - GitKraken-style terminal workstation guide\n- **[Interactive Log TUI](https://github.com/gfargo/coco/wiki/Interactive-Log-TUI)** - History-focused `coco log -i` guide\n- **[Team Collaboration](https://github.com/gfargo/coco/wiki/Team-Collaboration)** - Enterprise deployment and team adoption strategies\n\n**Advanced Resources:**\n- **[Using Ollama](https://github.com/gfargo/coco/wiki/Using-Ollama)** - Local AI setup for privacy and cost control\n- **[Advanced Usage](https://github.com/gfargo/coco/wiki/Advanced-Usage)** - Custom prompts, automation, and power-user features\n- **[Troubleshooting](https://github.com/gfargo/coco/wiki/Troubleshooting)** - Solutions for common issues and debugging\n\n### 🆘 **Need Help?**\n\n- **[Troubleshooting Guide](https://github.com/gfargo/coco/wiki/Troubleshooting)** - Comprehensive problem-solving resource\n- **[GitHub Issues](https://github.com/gfargo/coco/issues)** - Bug reports and feature requests\n- **[Discord Community](https://discord.gg/KGu9nE9Ejx)** - Real-time help and discussion\n\n## Contribution\n\nWe welcome contributions! Check out our [CONTRIBUTING.md](CONTRIBUTING.md) for more information.\n\n## Project Stats\n\n![Alt](https://repobeats.axiom.co/api/embed/ea76b881139f16595a343046d4f2bc9125a47e26.svg \"Repobeats analytics image\")\n\n## License\n\nMIT © [gfargo](https://github.com/gfargo/)\n\n\u003cdiv style=\"text-align:center; padding-top: 2rem;\"\u003e\n\u003cimg src=\"https://coco.griffen.codes/mascott/mascott_d.png\" width=\"200px\"\u003e\n\u003cp\u003eThanks for using \u003ccode\u003ecoco\u003c/code\u003e ✨💜\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfargo%2Fcoco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgfargo%2Fcoco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfargo%2Fcoco/lists"}