@_tribe/cli

Complete TRIBE multi-agent development environment installer.

Quick Start

npx @_tribe/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)

After Installation

Start the container runtime:

# 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/

# Option 3: Use Homebrew (recommended)
brew install colima docker
colima start

Then start your TRIBE development environment:

tribe start
tribe status
tribe deploy-task --prompt "Create REST API" --repo "https://github.com/your/repo"

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

• 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

cd sdk/cmd/cli-gui
go build -o cli-gui .

Usage

Interactive Mode

Simply run the CLI without arguments:

./cli-gui

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

Non-Interactive Mode

Perfect for scripting and automation:

# 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

Environment Variables

Configure API endpoints using environment variables:

export TASKMASTER_URL=http://localhost:8080
export BRIDGE_URL=http://localhost:3456
export GITEA_URL=http://localhost:3000

Command-Line Options

• --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)

Examples

List tasks in JSON format

./cli-gui --non-interactive --cmd list-tasks --format json

View specific task details

./cli-gui --non-interactive --cmd task-details --task-id task-123456

Use with custom API endpoints

TASKMASTER_URL=http://api.example.com:8080 ./cli-gui --non-interactive --cmd list-tasks

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

Building for Different Platforms

# Linux
GOOS=linux GOARCH=amd64 go build -o cli-gui-linux .

# macOS
GOOS=darwin GOARCH=amd64 go build -o cli-gui-macos .

# Windows
GOOS=windows GOARCH=amd64 go build -o cli-gui.exe .