Metadata-Version: 2.4
Name: deskclaw-client
Version: 0.1.0
Summary: Lightweight CLI client for registering bots with a DeskClaw exam server and triggering evaluation runs.
Author: DeskClaw Team
License-Expression: MIT
Project-URL: Homepage, https://codeup.aliyun.com/67d19229c732761f79422341/DeskClaw-Arena
Project-URL: Repository, https://codeup.aliyun.com/67d19229c732761f79422341/DeskClaw-Arena
Keywords: deskclaw,benchmark,agent,evaluation,testing
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Testing
Classifier: Intended Audience :: Developers
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: httpx>=0.25

# deskclaw-client

Lightweight CLI client for registering bots with a [DeskClaw](https://codeup.aliyun.com/67d19229c732761f79422341/DeskClaw-Arena) exam server and triggering evaluation runs.

## Installation

```bash
pip install deskclaw-client
```

## Quick Start

```bash
# Register your bot with the exam server
deskclaw-client register \
  --server http://EXAM_SERVER_IP:8420 \
  --name my-bot \
  --url http://localhost:8080/v1/chat/completions

# Trigger a test run (waits for completion by default)
deskclaw-client run --server http://EXAM_SERVER_IP:8420 --name my-bot

# Check run status
deskclaw-client status --server http://EXAM_SERVER_IP:8420 --name my-bot

# List all registered bots
deskclaw-client list --server http://EXAM_SERVER_IP:8420
```

### Environment Variable

Set `DESKCLAW_SERVER` to avoid repeating the server URL:

```bash
export DESKCLAW_SERVER=http://EXAM_SERVER_IP:8420
deskclaw-client register --name my-bot --url http://localhost:8080/v1/chat/completions
deskclaw-client run --name my-bot
```

## Commands

| Command | Description |
|---------|-------------|
| `register` | Register a bot with the exam server |
| `run` | Trigger a test run for your bot |
| `status` | Check the status of test runs |
| `list` | List all registered bots |

### Register Options

- `--server` — Exam server URL (or `DESKCLAW_SERVER` env var)
- `--name` — Unique bot name
- `--url` — Your bot's HTTP API endpoint
- `--protocol` — API protocol: `openai` (default), `anthropic`, `custom`
- `--capabilities` — Comma-separated capabilities (e.g. `text_generation,tool_use,multi_turn`)
- `--auth` — Bearer auth token (if your bot requires authentication)

## Supported Protocols

- **OpenAI** — `/v1/chat/completions` compatible endpoints
- **Anthropic** — `/v1/messages` compatible endpoints
- **Custom** — Any HTTP endpoint (configure via exam server)

## License

MIT
