Quickstart

Get a machine on the dashboard in 2 minutes.

1. Install the CLI#

The one-liner downloads cu + cu-daemon for your OS and runs cu setup automatically.

macOS / Linux

curl -fsSL https://app.controlum.pw/install.sh | bash -s -- \
  --user you@example.com --server https://app.controlum.pw

Windows (PowerShell 7+)

$env:CU_USER='you@example.com'
$env:CU_SERVER='https://app.controlum.pw'
irm https://app.controlum.pw/install.ps1 | iex

2. Verify the daemon#

cu daemon status

Should print a JSON with status: "running", machine_id, and a recent connected_at timestamp. If you see daemon not running the install script either failed or you skipped service registration — run cu daemon start manually.

3. Find your machine in the dashboard#

Open app.controlum.pw/machines — your hostname appears with ● online. Already-running claude / codex processes on that machine show up under /sessions within ~5 seconds, with live transcripts streaming from each harness's on-disk JSONL.

4. Launch a new session#

From the dashboard click + New session. Pick a machine (online ones only), a kind (Claude Code or Codex), a working directory, and optionally toggle Dangerously skip permissions. The session opens in the Interactive tab — type prompts, see the harness reply live.

5. Attach from a terminal#

The dashboard isn't the only way in. Any terminal on the same machine can join the same session:

cu attach <session-id>           # observe + type, first attacher controls
cu attach <session-id> --take-control  # steal control from whoever has it

Detach with Ctrl-\\ — session keeps running. Multi-attach is supported, so you can have the dashboard open on your laptop AND cu attach in your home terminal pointing at the same session.