Repository navigation
Otto 0.1.0
First release of Otto: a terminal AI agent that works on a codebase, a container, a browser or a desktop, uses what it built, and judges its own work against criteria it wrote before it started.
What is in it
- One agent loop with four modes over four vendors (Inception, OpenAI, Anthropic, Gemini) and any OpenAI-compatible endpoint, with routing that learns from outcomes, per-model cooldowns and a provider circuit breaker.
- A rubric-first evaluator: criteria written from the task before any attempt, shared by the loop and the judge.
- Once-only holds before an irreversible action, before finishing on unrun code, and before finishing without using what was built.
- 18 tools: shell and Python, files,
code_map, a browser,exercise(walk through a page, a served app, a CLI, an API, a terminal program or a device app and report each step as the machine saw it), a desktop, web search, workspace RAG and memory recall. - Tiered memory with type-aware compaction and two-stage semantic recall (96% on LoCoMo at ~2,600 tokens a query), a lesson bank, and sessions that survive the process.
- A Textual TUI with a setup screen, a directory browser, live progress, a token and dollar ledger, themes; a REPL with the same pipeline.
- Six benchmark harnesses (golden set, SWE-bench Verified, Claw-Eval, LoCoMo, compaction, Humanity's Last Exam) with the rules that keep a number honest.
- 1,534 tests that need no key and no network, on macOS, Linux and Windows.
Install
pip install otto-cli-agent
otto doctor
otto tuiAlso on PyPI, or from source with uv sync. INCEPTION_API_KEY is required; the other vendors are optional. See the README for setup, commands and environment variables.