CLI reference

The installed command is:

odinn <command>

Show the concise help or complete advanced surface:

odinn help
odinn help --all

Start and diagnose

odinn onboard
odinn start
odinn start --no-open
odinn status
odinn doctor

Use doctor for release identity and redacted diagnostics. Use status for current configuration and runtime health.

Providers and configuration

odinn config provider catalog
odinn config provider list
odinn config model list
odinn config model default <provider:model>
odinn config security show
odinn config experimental show
odinn config self-improvement show

See Configuration for mutation commands and safety implications.

Runs, plans, and audit

odinn runs
odinn run show <run-id>
odinn run events <run-id>
odinn run verify <run-id>
odinn audit
odinn audit verify

Run a deterministic built-in tool:

odinn run --tool text.echo --input-json '{"text":"hello"}'

Execute a reviewed plan document:

odinn plan --file ./plan.json

Structured plan and tool input is an advanced surface. Never place credentials in those files.

Memory

odinn memory remember --text "Prefer concise updates."
odinn memory search --query "updates"
odinn memory recall --query "How should updates be written?"
odinn memory browse --namespace user
odinn memory open --id <memory-id>
odinn memory compact --session <session-id>
odinn memory correct --target <memory-id> --text "Prefer biweekly updates."
odinn memory curate

Sessions and goals

odinn session create --title "Research"
odinn session list
odinn session read --session <session-id>
odinn session rename --session <session-id> --title "Market research"
odinn session delete --session <session-id>

odinn goal create --title "Complete research"
odinn goal list
odinn goal update --goal <goal-id> --status completed

Automatic improvements

odinn improve list
odinn improve learn
odinn improve rollback --improvement <improvement-id>
odinn config self-improvement set --enabled false --mode disabled

Labs

odinn experimental status
odinn experimental help <feature>
odinn experimental enable <feature> --confirm-impact
odinn experimental disable <feature>

Features are proof, sentinel, capabilities, rewind, capsules, counterfactual, and darwin.

State and extensions

odinn state backup --output <directory>
odinn state restore --input <directory> --confirm
odinn extension install --manifest <manifest>
odinn extension list
odinn extension disable --id <extension-id>
odinn extension rollback --id <extension-id>

Most commands accept --state <directory> for an explicit state root. Keep state directories private and separate from source control.