README.md

Wellcode CLI

Engineering Metrics Powered by AI

Free, open-source CLI tool that integrates with GitHub, Linear, and Split.io to gather and analyze engineering team metrics.

🚀 Installation

pip install wellcode-cli

🏃 Quick Start

1. Initial Setup

wellcode-cli config

This will guide you through:

• GitHub App installation for your organization
• Optional Linear integration
• Optional Split.io integration
• Optional Anthropic integration (for AI-powered insights)

2. Enable Shell Completion (Optional)

# For bash
wellcode-cli completion bash >> ~/.bashrc

# For zsh
wellcode-cli completion zsh >> ~/.zshrc

# For fish
wellcode-cli completion fish > ~/.config/fish/completions/wellcode-cli.fish

💻 Usage

Review Metrics

# Review last 7 days
wellcode-cli review

# Review specific date range
wellcode-cli review --start-date 2024-01-01 --end-date 2024-01-31

# Review specific user
wellcode-cli review --user johndoe

# Review specific team
wellcode-cli review --team engineering

Interactive Mode

wellcode-cli

# Then use natural language:
> check performance last week
> show metrics for team frontend
> how was johndoe doing yesterday

✨ Features

• 📊 GitHub metrics analysis
• 📈 Linear issue tracking integration
• 🔄 Split.io feature flag metrics
• 🤖 AI-powered insights (via Anthropic)
• 💬 Natural language interface
• 📱 Interactive mode

⚙️ Configuration

GitHub App Installation

1. Run wellcode-cli config
2. Enter your organization name
3. Follow the GitHub App installation link
4. Select your organization and repositories

Optional Integrations

• Linear: Issue tracking metrics
• Split.io: Feature flag analytics
• Anthropic: AI-powered insights

🆘 Support

• Documentation: https://cli.wellcode.ai
• Issues: https://github.com/wellcode-ai/wellcode-cli/issues
• Email: support@wellcode.ai

📄 Contributing

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

💖 Contributors

Thanks goes to these wonderful people:

📄 License

MIT License - see LICENSE file for details