CLI

Spectron ships two binaries:

Binary	Role
`spectrond`	Server (runs in your container or cluster): `api`, `worker`, `scheduler`, `management`, `bootstrap`
`spectron`	Client: `remember`, `recall`, `chat`, `documents`, provisioning helpers

The spectron CLI is what integrators install locally. spectrond is operated via Docker, Kubernetes, or your platform team; start with Docker.

Connection flags (client)

Most spectron subcommands accept:

Flag	Environment variable	Description
`--url` / `-u`	`SPECTRON_URL`	Server base URL (for example `http://localhost:9090`)
`--api-key` / `-a`	`SPECTRON_API_KEY`	Context API key
`--context-id` / `-c`	`SPECTRON_CONTEXT_ID`	Context id in `/api/v1/{context_id}/...`

spectron login --url http://localhost:9090 \
  --api-key "$SPECTRON_API_KEY" \
  --context-id dev

Stores a named profile for later commands.

`spectrond` — server (operators)

Run inside the Spectron container or host image.

`bootstrap`

One-time control-plane initialisation. Prints management and context API keys.

docker compose exec spectron spectrond bootstrap \
  --connection-string "ws://surrealdb:8000;root;root"

Production roles

spectrond api start …          # REST + MCP
spectrond worker start …       # job queue consumer
spectrond scheduler start …    # periodic background work
spectrond management start …   # management REST only

Common flags:

Flag	Env	Default
`--connection-string`	`SURREALDB_CONNECTION`	—
`--embeddings-api-key`	`SPECTRON_EMBEDDINGS_API_KEY`	—
`--bind-address`	`SPECTRON_BIND_ADDRESS`	`0.0.0.0:9090`
`--object-store-url`	`SPECTRON_OBJECT_STORE_URL`	—

`spectron` — data plane

Unified verbs

Command	REST equivalent
`spectron remember "…"`	`POST /api/v1/{ctx}/facts`
`spectron recall "…"`	`POST /api/v1/{ctx}/query`
`spectron context "…"`	`POST /api/v1/{ctx}/context`
`spectron chat [message]`	`POST /api/v1/{ctx}/chat`
`spectron reflect "…"`	`POST /api/v1/{ctx}/reflect`

remember flags: --infer full|triples|preview|none, --from-file, --transcript, --scope org=acme.

recall flags: --limit, --mode hybrid|vector|bm25|graph, --include facts,passages.

Documents

spectron documents upload ./manual.pdf
spectron documents list
spectron documents query "return policy"

Sessions, entities, traces

spectron sessions list
spectron entities show Person/alice
spectron traces show <trace_id>

MCP install helper

spectron mcp

Prints JSON for Claude Desktop / Cursor and a Claude Code one-liner.

Operator provisioning

spectron contexts create …
spectron keys generate-key …

Run spectron --help for the full command tree.