Skip to main content

​
What managed mode does

By default, Nanny runs local-only: it enforces your limits and rules on your machine and writes an event log to stdout. Nothing leaves the box. Managed mode keeps enforcement exactly where it is — local, deterministic, offline-capable — and additionally forwards a copy of your run’s event log to Nanny Cloud. In return you get, per organization:
  • A dashboard of every run — steps, tokens, stop reasons, models
  • Spend and usage trends across all your agents
  • Alerts when a run starts to spiral
  • A durable, exportable audit trail (compliance tiers)
Enforcement never depends on the network. If the cloud is slow or unreachable, your agent runs exactly as it would locally — forwarding is best-effort and never blocks or fails a run.
Managed mode is additive. It changes nothing about how limits and rules are enforced — only whether a copy of the event log is sent to your dashboard.

​
Turn it on

You need an API key from your Nanny Cloud dashboard (Settings → API keys). Add two things to nanny.toml:
Then run as usual:
Your run appears in the dashboard within a few seconds of finishing. That’s it — no code changes, no per-call instrumentation required.
Keep api_key out of version control. Reference an environment variable or a secrets manager in your deploy pipeline rather than committing the literal key.

​
Local vs managed

​
Turning it off

Set mode = "local" (or remove the [managed] block). The runtime goes back to local-only immediately — no data is sent.