@_tribe/cli/README.md

TRIBE multi-agent development system CLI installer

# @_tribe/cli

Complete TRIBE multi-agent development environment installer.

## Quick Start

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

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

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

Then start your TRIBE development environment:

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

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

## Usage

### Interactive Mode

Simply run the CLI without arguments:

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

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

### Environment Variables

Configure API endpoints using environment variables:

```bash
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
```bash
./cli-gui --non-interactive --cmd list-tasks --format json
```

### View specific task details
```bash
./cli-gui --non-interactive --cmd task-details --task-id task-123456
```

### Use with custom API endpoints
```bash
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

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