Agent setup guide

install, connect, and manage the local agent Get an API key

The Control Zero agent is a small local binary that reads your coding-agent sessions and streams them into your private workspace — powering Recall, the knowledge graph, analytics and the Replayer. It runs in the background and takes about a minute to set up.

1Get your API keyshown once

Open Connect an agent and click Generate API key. The key authorizes the agent to report sessions as you, into your own workspace. Copy it — the next step needs it.

2Install & connectone line

That one command does everything: downloads the agent, logs in with your key, auto-detects Claude Code, backfills your 25 most recent sessions, and installs a background service that runs at login. When it prints Done — the agent is connected and running, you're set.

The binary installs to ~/.controlzero/bin/cz-agentd. Examples below use cz-agentd — use that full path, or add the folder to your PATH.
3Verify it's working

Check the agent and its backend connection:

~/.controlzero/bin/cz-agentd status

Then open the Command Center — within a minute your recent sessions, tools and files appear. New sessions flow in automatically as you work.

Managing the agentcommon commands
Backfill your full history
~/.controlzero/bin/cz-agentd sync --force

Setup syncs your 25 most recent sessions. This re-pushes everything (idempotent — no duplicates), and is how you backfill after a feature update like the Replayer.

Connect more tools / folders
~/.controlzero/bin/cz-agentd detect ~/.controlzero/bin/cz-agentd add-source claude-code --path /custom/dir

detect lists the coding agents it found; add-source watches an extra location.

Update to the latest agent
curl -fsSL https://dev-cz-intel.controlzero.ai/install.sh | CZ_TOKEN=<your key> bash

Re-run the installer any time — it pulls the newest binary and keeps your config.

Uninstall
~/.controlzero/bin/cz-agentd uninstall --purge

Stops the service and removes config, state and (with --purge) the binary. Add --yes to skip the prompt. No key handy? curl … | bash -s uninstall. Your cloud data is untouched.

Privacy & troubleshooting
  • Your data is yours. Sessions report into your own isolated workspace with your key; no one else can read them. Nothing reaches your team without explicit, revocable consent.
  • "not logged in". Re-run install with your key set: CZ_TOKEN=<your key>, or printf %s <key> | cz-agentd login --backend https://dev-cz-intel.controlzero.ai.
  • Sessions not appearing? Run cz-agentd sync once, then check cz-agentd status. The agent needs outbound HTTPS to dev-cz-intel.controlzero.ai.
  • Adding another machine? Generate a fresh key on Connect an agent and run the installer there — same workspace, no extra config.