deskclaw-client 0.1.0

Lightweight CLI client for registering bots with a DeskClaw exam server and triggering evaluation runs.

deskclaw-client

Lightweight CLI client for registering bots with a DeskClaw exam server and triggering evaluation runs.

Installation

pip install deskclaw-client

Quick Start

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

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