hivespace 0.1.7.dev1

Hivespace CLI — talk to your team's Hivespace workspace from the terminal

Hivespace CLI

Talk to your team's Hivespace workspace from the terminal — read and write the shared team drive, manage agents, and run workflows.

uv tool install hivespace      # or: pipx install hivespace / pip install hivespace
hivespace auth login           # paste a personal access token from the web UI
hivespace --help

The CLI talks to https://hivespace.app by default; point it elsewhere with HIVESPACE_SERVER=https://your-host.

This is a thin HTTP client (only typer, click, httpx, rich) — it does not contain or run the Hivespace server.

Honeycomb observability agent

Create an observability PAT in Admin → Evaluation → Honeycomb, then log the agent's machine into the CLI:

hivespace auth login

The judged seed queue and its trajectory drill-down are available under hivespace observability. Agent integrations should pass --json:

hivespace observability seeds list --status accepted --json
hivespace observability seeds get 123 --json
hivespace observability units get 456 --json
hivespace observability units search 456 --event-type tool_call --json
hivespace observability turns get 456 TURN_ID --raw --json
hivespace observability events get EVENT_ID --json

After reviewing a pending seed, a write-capable observability PAT can place it in the Honeycomb queue explicitly:

hivespace observability seeds accept 123 --note "useful regression" --json
hivespace observability seeds reject 124 --note "not actionable" --json

After the Honeycomb task is successfully created, a write-capable observability PAT can acknowledge consumption. Reading a seed never changes its status, and failed downstream work must not be acknowledged:

hivespace observability seeds export 123 \
  --metadata '{"honeycomb_task_id":"hc-123"}' --json