Get up and running with GitCo in 5 minutes! This guide will help you set up GitCo and start managing your OSS forks effectively.
- Python 3.9 or higher
- Git installed and configured
- GitHub account with personal access token
- LLM API key (OpenAI) - optional but recommended
pip install gitco# Interactive setup (recommended)
gitco init --interactive
# Or use defaults
gitco init --non-interactiveThe interactive setup will guide you through:
- Repository configuration
- LLM provider selection
- GitHub integration
# LLM provider
export OPENAI_API_KEY="your-openai-api-key"
# GitHub authentication is automatic using your existing Git credentials!
# No additional GitHub API keys are required.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# Validate configuration
gitco config validate
# Check GitHub connection
gitco github connection-status# Sync all repositories
gitco sync
# Sync specific repository
gitco sync --repo django
# Sync with analysis
gitco sync --analyze# Analyze changes in a repository
gitco analyze --repo django
# Get detailed analysis
gitco analyze --repo django --detailed# Find all opportunities
gitco discover
# Find Python-specific opportunities
gitco discover --skill python
# Find beginner-friendly issues
gitco discover --label "good first issue"# Check all repositories
gitco status
# Detailed health report
gitco status --detailed- Learn more: Check out the Usage Guide for detailed workflows
- Configure advanced settings: See the Configuration Guide
- Explore features: Read the Features Guide
- Get help: Visit the FAQ or Troubleshooting Guide