Metadata-Version: 2.4
Name: zoro-cli
Version: 0.1.8
Summary: Command-line interface for Zoro deployments and chat workflows
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx<1,>=0.28
Requires-Dist: prompt_toolkit<4,>=3.0
Requires-Dist: rich<15,>=13
Requires-Dist: textual<1,>=0.86
Requires-Dist: typer<1,>=0.16
Requires-Dist: websockets<16,>=13

# Zoro CLI

Command-line interface for Zoro deployments and chat workflows.

## Installation

### Quick Install (Recommended)

```bash
curl -fsSL https://get.zoro.algohub.cc | bash
```

Or with wget:

```bash
wget -qO- https://get.zoro.algohub.cc | bash
```

The same command also **updates** to the latest version when run again.

### From PyPI

```bash
pip install -U zoro-cli
```

### From Source

```bash
git clone <repository>
cd zoro_cli
pip install -e .
```

### Binary Install (No Python Required)

Download pre-built binaries from [GitHub Releases](https://github.com/yourorg/zoro/releases):

```bash
# macOS (Apple Silicon)
curl -L -o zoro https://github.com/yourorg/zoro/releases/latest/download/zoro-x.x.x-darwin-arm64
chmod +x zoro
sudo mv zoro /usr/local/bin/

# macOS (Intel)
curl -L -o zoro https://github.com/yourorg/zoro/releases/latest/download/zoro-x.x.x-darwin-x86_64
chmod +x zoro
sudo mv zoro /usr/local/bin/

# Linux (x86_64)
curl -L -o zoro https://github.com/yourorg/zoro/releases/latest/download/zoro-x.x.x-linux-x86_64
chmod +x zoro
sudo mv zoro /usr/local/bin/

# Linux (ARM64)
curl -L -o zoro https://github.com/yourorg/zoro/releases/latest/download/zoro-x.x.x-linux-arm64
chmod +x zoro
sudo mv zoro /usr/local/bin/
```

## Configuration

Default API base URL: `https://api.zoro.algohub.cc/api/v1`

### First Login

```bash
# Using API token (recommended)
zoro login --token <your-token>

# Using email/password
zoro login --email you@example.com
```

Release model:

- Public distribution is via PyPI (`pip install zoro-cli`)
- The source repository can remain private
- Binary release assets are available on GitHub Releases for users without Python
- GitHub Actions automatically builds and publishes on every tag push (`cli/v*` or `v*`)

Interactive mode:

- `zoro` launches the terminal UI
- `zoro ui` explicitly launches the terminal UI
- plain text sends chat messages through the existing Zoro chat session
- slash commands control sessions, plans, approvals, and log views

TUI slash commands:

- `/help`
- `/new`
- `/sessions`
- `/use <session_id>`
- `/projects`
- `/servers`
- `/envs <project_id>`
- `/plan <project_id> <env_id> <branch> [method]`
- `/show <deployment_id>`
- `/approve <deployment_id>`
- `/cancel <deployment_id>`
- `/logs <deployment_id>`

Current commands:

- `zoro login`
- `zoro ui`
- `zoro logout`
- `zoro whoami`
- `zoro resume` - Resume last chat session
- `zoro projects list`
- `zoro servers list`
- `zoro envs list --project-id <id>`
- `zoro deploy plan`
- `zoro deploy show`
- `zoro deploy approve`
- `zoro deploy cancel`
- `zoro deploy logs`
