GitCo ✨

A simple CLI tool for intelligent OSS fork management and contribution discovery.

GitCo transforms the tedious process of managing multiple OSS forks into an intelligent, context-aware workflow. It combines automated synchronization with AI-powered insights to help developers stay current with upstream changes and discover meaningful contribution opportunities.

🚀 Key Features

• 🔄 Intelligent Fork Synchronization - Automated sync with safe stashing and error recovery
• 🧠 AI-Powered Change Analysis - OpenAI integration for intelligent change analysis
• 🎯 Contribution Discovery - Skill-based matching for finding contribution opportunities
• 📊 Repository Health Monitoring - Comprehensive health metrics and activity tracking
• 💾 Backup & Recovery - Robust backup system with multiple backup types
• 🤖 Automation Support - Quiet mode and export functionality for CI/CD integration

📦 Installation

pip install gitco

🛠️ Quick Start

1. Initialize Configuration

gitco init --interactive

2. Set Up API Keys

export OPENAI_API_KEY="your-openai-api-key"
# GitHub authentication is automatic using your existing Git credentials!

3. Configure Repositories

Edit ~/.gitco/config.yml:

repositories:
  - name: django
    fork: username/django
    upstream: django/django
    local_path: ~/code/django
    skills: [python, web, orm]

settings:
  llm_provider: openai
  default_path: ~/code

4. Start Using GitCo

# Sync repositories
gitco sync

# Analyze changes
gitco analyze --repo django

# Discover opportunities
gitco discover --skill python

# Check repository health
gitco status

📖 Documentation

• Quick Start Guide - Get up and running in 5 minutes
• Configuration Guide - Detailed configuration options
• Usage Guide - Complete command reference and examples
• CLI Reference - Comprehensive CLI command reference
• Features Guide - Detailed feature overview
• Tutorials - Step-by-step tutorials and examples
• Workflows - User persona-based workflows
• Troubleshooting - Common issues and solutions
• FAQ - Frequently asked questions
• Releases - Release process and management

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

This project adheres to our Code of Conduct.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

GitCo makes OSS contribution management simple, intelligent, and rewarding. Start contributing more effectively today! 🚀