Setup and Connect

opensana setup creates a saved profile.

opensana connect starts the long-running process that claims queued threads and streams agent output back to OpenSana.

Interactive Setup

opensana setup

The setup wizard guides you through:

Convex URL
API key
project selection
profile naming

Non-Interactive Setup

opensana setup \
  --url https://your-deployment.convex.cloud \
  --api-key sk_user_xxx \
  --project proj_abc123 \
  --profile-key work \
  --profile "Work"

Use this mode for scripts, bootstrap steps, or repeatable machine setup.

Connect

opensana connect
opensana connect --profile work
opensana connect --name "My Laptop"
opensana connect --concurrency 8

Debugging and Simulation

Use debug logging when you want to inspect runtime behavior:

OPENSANA_CLI_DEBUG=1 opensana connect

Use fixture replay when developing the UI without a live agent:

opensana connect --stream fixtures/claude-code-review.jsonl

Notes

connect is long-running.
It only processes threads that the selected profile can access.
The current production runtime is Claude Code. Additional runtimes may appear over time.