TRIBE CLI - Zero to Productive in One Command

TRIBE is an AI-powered multi-agent development system that manages your entire development workflow. From project creation to task implementation and PR reviews, TRIBE's AI agents handle it all.

🚀 One-Command Installation

npx @0zen/tribe-cli

That's it! This single command will:

• ✅ Install all required tools (Docker, Kubernetes, kubectl)
• ✅ Set up Colima container runtime (macOS)
• ✅ Deploy the complete TRIBE cluster
• ✅ Configure everything automatically
• ✅ Guide you through creating your first project

🎯 What is TRIBE?

TRIBE is a complete development ecosystem where AI agents:

• 📝 Implement features based on your descriptions
• 🔧 Fix bugs autonomously
• 🔀 Create pull requests
• 👀 Handle code reviews
• 🚀 Manage the entire development lifecycle

💡 Quick Start

After installation, just run:

tribe

The interactive CLI will:

1. First time? Guide you through creating your first project
2. Returning? Show your projects, tasks, and agent activity

Creating Tasks

tribe create-task
# Select project, describe what you want built
# An AI agent picks it up and implements it!

Reviewing PRs

tribe review-task
# See PRs created by agents
# Review diffs, add comments, merge

🛠️ System Requirements

• macOS or Linux
• 4GB RAM minimum (8GB recommended)
• 20GB disk space
• Node.js 16+

📚 Common Commands

tribe                    # Interactive mode
tribe status            # Check system status
tribe create-task       # Create a new task
tribe review-task       # Review agent PRs
tribe list-projects     # Show all projects
tribe list-agents       # Show agent status

🔧 Architecture

TRIBE runs a local Kubernetes cluster with:

• Bridge - API gateway and orchestrator
• TaskMaster - Task queue and agent coordinator
• Claude Agents - AI workers powered by Claude
• Gitea - Local Git server for repositories
• PostgreSQL - Database for state management

🤝 Contributing

TRIBE is open source! Visit our GitHub repository to contribute.

📖 Documentation

For detailed documentation, visit the TRIBE Flow Guide.

🆘 Troubleshooting

Cluster not starting?

# Check if Colima is running
colima status

# Start manually if needed
colima start --kubernetes
tribe start

Port conflicts?

# Check what's using ports
lsof -i :30080
lsof -i :3456

Reset everything?

# Stop cluster
colima stop

# Remove TRIBE namespace
kubectl delete namespace tribe-system

# Start fresh
tribe start

📄 License

MIT License - see LICENSE for details.