tribe-cli/README.md

TRIBE multi-agent development system - Zero to productive with one command

# 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

```bash
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:

```bash
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

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

### Reviewing PRs

```bash
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

```bash
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](https://github.com/0zen/0zen) to contribute.

## 📖 Documentation

For detailed documentation, visit the [TRIBE Flow Guide](https://github.com/0zen/0zen/blob/main/TRIBE-SYSTEM-FLOW-GUIDE.md).

## 🆘 Troubleshooting

### Cluster not starting?
```bash
# Check if Colima is running
colima status

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

### Port conflicts?
```bash
# Check what's using ports
lsof -i :30080
lsof -i :3456
```

### Reset everything?
```bash
# Stop cluster
colima stop

# Remove TRIBE namespace
kubectl delete namespace tribe-system

# Start fresh
tribe start
```

## 📄 License

MIT License - see [LICENSE](https://github.com/0zen/0zen/blob/main/LICENSE) for details.