CLI

Every agora subcommand and environment variable.

agora serve [--listen 127.0.0.1:7788] [--home DIR] [--apps-user agora] [--rtc-port 0]
agora mcp                      MCP stdio server (AGORA_URL, AGORA_TOKEN)
agora token                    print the admin token
agora open <workspace> [--control] [--base URL] [--ttl 3600]
agora api METHOD PATH [JSON]   call the HTTP API
agora version

agora serve

Runs the daemon in the foreground. All flags are listed on the install page. On SIGINT or SIGTERM it checkpoints every workspace (up to 30 s) and exits.

agora mcp

Speaks MCP over stdin/stdout and forwards every tool call to the HTTP API. See agents and the tool reference.

agora token

Prints the admin token from <home>/admin.token.

agora open

Mints a viewer token for a workspace and prints a viewer URL:

agora open ws_1a2b3c --base https://agora.example.com
# https://agora.example.com/view/ws_1a2b3c#vt=v1....

Flag	Default	Description
`--control`	`true`	Allow input from the viewer. `--control=false` for watch-only links.
`--base`	`AGORA_URL`	Public base URL, for example your tunnel hostname.
`--ttl`	`3600`	Token lifetime in seconds (at most 86400).

agora api

Calls the HTTP API and prints the response body:

agora api GET /v1/workspaces
agora api POST /v1/workspaces '{"name":"demo"}'

Environment

Variable	Used by	Description
`AGORA_URL`	clients	Daemon URL. Default `http://127.0.0.1:7788`.
`AGORA_TOKEN`	clients	Token to send. Default: the admin token from `AGORA_HOME`, `/var/lib/agora` or `~/.agora`, whichever is readable.
`AGORA_ACT_AS`	clients	With the admin token, act as this cursor (sent as `X-Agora-Cursor`).
`AGORA_HOME`	all	State directory.
`AGORA_ALLOW_PUBLIC`	`serve`	`1` allows binding to non-loopback addresses.
`AGORA_CGROUPS`	`serve`	`off` disables per-workspace cgroups.
`AGORA_TOOLS`	`mcp`	Comma-separated tool groups to expose: `browser`, `browserx`, `desktop`, `spawn`, `workspace`, `process`. Default: all.
`AGORA_LEAN`	`mcp`	`1` shortens tool descriptions to one sentence.

Launched agents also receive AGORA_CURSOR, AGORA_WORKSPACE and, for the command adapter, AGORA_GOAL.