Odin Agent Runtime quickstart

From zero to your first audited /deliberate cycle in under five minutes.

Last updated · 2026-06-04

The Odin Agent Runtime (odin-agent) is a CLI that lives inside your Sovereign Cloud Workspace. It runs structured agent workflows — /deliberate, /multi-track, /bring-it-home — with audit, per-tenant budget, and provider isolation by construction.

Prerequisites

Access to a provisioned Sovereign Cloud Workspace (or a local code-server pointed at an Odin tenant)
Tenant credentials with at least agent:invoke scope
One configured provider (Anthropic, OpenAI, OpenRouter, or local MLX)

Install (if not pre-installed)

npm install -g @odinlabs-ai/odin-agent
# or via the workspace CLI helper:
odin install agent-runtime

First run

Confirm install and read the manifest your tenant provisioned:

odin-agent --version
# 4.80.1

odin-agent info
# tenant: openvalue
# providers: anthropic / openrouter / mlx
# skills: 15 proven-core + 4 enabled
# budget: $3.42 / $10 today

Run /deliberate

The flagship multi-round planning loop. Phase 0 preflight → Phase 0.5 subject pin → Phase 1 cognitive council → Phase 2 WO drafting (operator gate) → Phase 3 execution → Phase 4 DROID sweep → Phase 5 residual → Phase 6 honest report.

odin-agent /deliberate "add OAuth2 to the customer portal"

Phase 0   Preflight       → tools detected: codex T5, factory T1
Phase 0.5 Subject pin     → cycle-context written, lock acquired
Phase 1   Cognitive       → 5-perspective council, 78% confidence
Phase 2   WO Planning     → 4 WOs drafted, validator GREEN

─ operator approval gate ─

Reading the audit trail

Every phase emits an AuditEvent to your tenant's BrainDB. Query it:

odin-agent audit list --since 1h
odin-agent audit get --receipt #a8f2

Budget caps

Your tenant has a daily budget cap. When you hit it, the runtime refuses new invocations until midnight UTC or an operator reset. There is no “just one more” bypass — the cap is structural.

odin-agent budget status
# today: $3.42 / $10.00 (34%)
# session: $0.18 / $5.00

Where to go next

BrainDB write contract — how decisions get recorded
Sovereign Cloud Workspace overview — the environment runtime lives in
Odin Agent Runtime overview — the full product page

Back to all docs Question or feedback?

Run /deliberate

odin-agent /deliberate "add OAuth2 to the customer portal" Phase 0 Preflight → tools detected: codex T5, factory T1 Phase 0.5 Subject pin → cycle-context written, lock acquired Phase 1 Cognitive → 5-perspective council, 78% confidence Phase 2 WO Planning → 4 WOs drafted, validator GREEN ─ operator approval gate ─