@_xtribe/cli 1.0.0-beta.4 → 1.0.0-beta.6

package/README.md

@@ -1,177 +1,123 @@
-# @_xtribe/cli
+# TRIBE CLI - Zero to Productive in One Command
 
-Complete TRIBE multi-agent development environment installer.
+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.
 
-## Quick Start
+## 🚀 One-Command Installation
 
 ```bash
 npx @_xtribe/cli
 ```
 
-This single command installs:
-- ✅ Docker CLI
-- ✅ Colima (lightweight container runtime for macOS)
-- ✅ Lima (virtualization layer) 
-- ✅ KIND (Kubernetes in Docker)
-- ✅ kubectl (Kubernetes CLI)
-- ✅ TRIBE CLI (multi-agent orchestration)
+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
 
-## After Installation
+## 🎯 What is TRIBE?
 
-Start the container runtime:
+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
 
-```bash
-# Option 1: Use installed Colima
-colima start --cpu 2 --memory 4
-
-# Option 2: Use Docker Desktop
-# Download from: https://docs.docker.com/desktop/install/mac-install/
+## 💡 Quick Start
 
-# Option 3: Use Homebrew (recommended)
-brew install colima docker
-colima start
-```
-
-Then start your TRIBE development environment:
+After installation, just run:
 
 ```bash
-tribe start
-tribe status
-tribe deploy-task --prompt "Create REST API" --repo "https://github.com/your/repo"
+tribe
 ```
 
-## What is TRIBE?
-
-TRIBE (Task-Review-Iterate-Branch-Execute) is a multi-agent AI development system that automates software development workflows using multiple Claude AI agents working in parallel.
-
-## System Requirements
-
-- macOS or Linux
-- Node.js 16+
-- Internet connection for downloads
-
-## Support
+The interactive CLI will:
+1. **First time?** Guide you through creating your first project
+2. **Returning?** Show your projects, tasks, and agent activity
 
-- Issues: https://github.com/0zen/0zen/issues
-- Documentation: https://github.com/0zen/0zen
-
-## License
-
-MIT
-
-## Overview
-
-The TRIBE CLI GUI provides both interactive and non-interactive modes for:
-- Listing and viewing tasks
-- Managing projects
-- Monitoring agents
-- Creating new tasks (interactive mode)
-
-## Installation
+### Creating Tasks
 
 ```bash
-cd sdk/cmd/cli-gui
-go build -o cli-gui .
+tribe create-task
+# Select project, describe what you want built
+# An AI agent picks it up and implements it!
 ```
 
-## Usage
-
-### Interactive Mode
-
-Simply run the CLI without arguments:
+### Reviewing PRs
 
 ```bash
-./cli-gui
+tribe review-task
+# See PRs created by agents
+# Review diffs, add comments, merge
 ```
 
-This will present a menu-driven interface where you can:
-1. List all tasks
-2. List all projects
-3. List all agents
-4. Create a new task
-5. View task details
+## 🛠️ System Requirements
 
-### Non-Interactive Mode
+- **macOS** or **Linux**
+- **4GB RAM** minimum (8GB recommended)
+- **20GB disk space**
+- **Node.js 16+**
 
-Perfect for scripting and automation:
+## 📚 Common Commands
 
 ```bash
-# List all tasks
-./cli-gui --non-interactive --cmd list-tasks
-
-# List all projects
-./cli-gui --non-interactive --cmd list-projects
-
-# List all agents
-./cli-gui --non-interactive --cmd list-agents
-
-# View task details
-./cli-gui --non-interactive --cmd task-details --task-id task-8e4999d6
-
-# Get JSON output
-./cli-gui --non-interactive --cmd list-tasks --format json
+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
 ```
 
-### Environment Variables
+## 🔧 Architecture
 
-Configure API endpoints using environment variables:
+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
 
-```bash
-export TASKMASTER_URL=http://localhost:8080
-export BRIDGE_URL=http://localhost:3456
-export GITEA_URL=http://localhost:3000
-```
+## 🤝 Contributing
 
-## Command-Line Options
+TRIBE is open source! Visit our [GitHub repository](https://github.com/0zen/0zen) to contribute.
 
-- `--non-interactive`: Run in non-interactive mode
-- `--cmd <command>`: Command to execute (required in non-interactive mode)
-  - `list-tasks`: List all tasks
-  - `list-projects`: List all projects
-  - `list-agents`: List all agents
-  - `task-details`: View details of a specific task
-- `--task-id <id>`: Task ID (required for task-details command)
-- `--format <format>`: Output format (text or json, default: text)
+## 📖 Documentation
 
-## Examples
+For detailed documentation, visit the [TRIBE Flow Guide](https://github.com/0zen/0zen/blob/main/TRIBE-SYSTEM-FLOW-GUIDE.md).
 
-### List tasks in JSON format
-```bash
-./cli-gui --non-interactive --cmd list-tasks --format json
-```
+## 🆘 Troubleshooting
 
-### View specific task details
+### Cluster not starting?
 ```bash
-./cli-gui --non-interactive --cmd task-details --task-id task-123456
+# Check if Colima is running
+colima status
+
+# Start manually if needed
+colima start --kubernetes
+tribe start
 ```
 
-### Use with custom API endpoints
+### Port conflicts?
 ```bash
-TASKMASTER_URL=http://api.example.com:8080 ./cli-gui --non-interactive --cmd list-tasks
+# Check what's using ports
+lsof -i :30080
+lsof -i :3456
 ```
 
-## Testing with Mock Data
-
-To test without a running TRIBE cluster, you can use mock endpoints or run against a local instance.
-
-## Development
-
-### Adding New Commands
-
-1. Add the command to the switch statement in `runNonInteractive()`
-2. Implement the corresponding function
-3. Add any necessary API methods to `api.go`
-4. Update this README with the new command
+### Reset everything?
+```bash
+# Stop cluster
+colima stop
 
-### Building for Different Platforms
+# Remove TRIBE namespace
+kubectl delete namespace tribe-system
 
-```bash
-# Linux
-GOOS=linux GOARCH=amd64 go build -o cli-gui-linux .
+# Start fresh
+tribe start
+```
 
-# macOS
-GOOS=darwin GOARCH=amd64 go build -o cli-gui-macos .
+## 📄 License
 
-# Windows
-GOOS=windows GOARCH=amd64 go build -o cli-gui.exe .
-``` 
+MIT License - see [LICENSE](https://github.com/0zen/0zen/blob/main/LICENSE) for details.