Skip to content

Home

Jump to bottom
Griffen Fargo edited this page Oct 6, 2025 · 6 revisions

🚀 Quick Start

New to coco? Start here for a complete walkthrough from installation to your first AI-generated commit.

📖 Getting Started Guide

  • Installation methods (npm, npx, global vs local)
  • First-time setup with AI provider selection
  • Your first commit walkthrough
  • Essential commands and workflows
  • Quick troubleshooting for beginners

⚙️ Configuration & Setup

Core Configuration

🔧 Configuration Overview

  • Complete configuration reference with all options
  • Multiple configuration methods (CLI, env vars, config files)
  • AI provider setup (OpenAI, Anthropic, Ollama)
  • Priority system and best practices

📁 Ignoring Files & Extensions

  • Advanced pattern matching with minimatch
  • Project-specific ignore configurations
  • Performance optimization through file filtering
  • Real-world examples for different project types

AI Providers

🏠 Using Ollama

  • Complete local AI setup guide
  • Model recommendations by hardware
  • Performance optimization and GPU acceleration
  • Privacy-focused development workflows

👥 Team & Enterprise

🤝 Team Collaboration

  • Shared configuration strategies
  • Git hooks and CI/CD integration
  • Security best practices for API keys
  • Team onboarding and training materials
  • Enterprise-scale deployment

🔧 Advanced Features

⚡ Advanced Usage

  • Custom prompts and templates
  • Multi-project configurations
  • Automation and scripting
  • Performance optimization techniques
  • Integration with development tools

🆘 Help & Support

🔍 Troubleshooting Guide

  • Common issues and solutions
  • Diagnostic commands and debugging
  • Platform-specific problems (Windows, macOS, Linux)
  • API and connectivity issues
  • Performance troubleshooting

🎯 Use Cases

Individual Developers

  • Consistent Commits: Never write generic commit messages again
  • Learning Tool: Understand conventional commits through examples
  • Time Saving: Generate contextual messages in seconds
  • Offline Capable: Use Ollama for complete privacy and offline work

Development Teams

  • Standardization: Enforce consistent commit message formats
  • Onboarding: Help new team members learn project conventions
  • Code Review: Better commit messages improve review efficiency
  • Release Management: Conventional commits enable automated changelogs

Enterprise Organizations

  • Compliance: Audit trails and consistent documentation
  • Security: Local AI models keep code completely private
  • Cost Control: Shared Ollama servers eliminate per-request costs
  • Integration: Seamless integration with existing development workflows

🔗 Quick Links

Essential Commands

# Interactive commit (recommended)
coco -i

# Conventional commits format
coco --conventional

# Add context for complex changes
coco -a "Resolves login timeout issue"

# Include ticket from branch name
coco --append-ticket

# Generate changelog
coco changelog

# Summarize recent work
coco recap --yesterday

Configuration Examples

# Quick setup
coco init

# Project-specific setup
coco init --scope project

# Global user setup
coco init --scope global

Common Workflows

# Daily development
git add .
coco -i

# Team workflow with validation
git add .
coco --conventional -i

# Release workflow
coco changelog --since-last-tag

📖 Additional Resources

Community & Support

Development

🎉 Get Started Today

Ready to transform your git workflow? Choose your path:

This documentation is continuously updated. For the latest information, visit the GitHub repository or join our Discord community.

Clone this wiki locally