Overview
The autonomous coding agent with explicit Plan / Code / Infra modes.
TheoCode is the coding agent that thinks before it types. Instead of one ambient assistant doing everything, you switch between three explicit modes — Plan, Code, Infra — and every change leaves an audit trail you can diff, replay, and roll back.
Two surfaces, one binary: a CLI for terminals and CI pipelines, and a Desktop app for visual diff review and multi-pane workflows.
Install
curl -fsSL https://install.usetheo.dev/theo-code | shThe three modes
Plan
Read the codebase, propose a step-by-step approach, and surface the risks before touching a single file. Nothing executes until you accept the plan.
Code
Apply the accepted plan with surgical edits. Every change is a reviewable diff. No silent refactors, no scope creep.
Infra
Provision, deploy, and tear down — with the same audit trail and rollback semantics as a code change.
Quick start
# 1. Install the CLI
curl -fsSL https://install.usetheo.dev/theo-code | sh
# 2. Plan a change
theo plan "add a /healthz endpoint and a smoke test"
# 3. Review the plan, then apply
theo code
# 4. Deploy with Theo PaaS (optional)
theo deployTheoCode runs entirely on your machine. Your code stays local until you
explicitly run theo deploy.
What makes it different
- Modes are explicit, not implicit. You always know whether the agent is reading, writing, or shipping.
- Every change is auditable. Plan files, diffs, and infra actions land in a local journal you can grep, replay, and share.
- Two surfaces, one workflow. The CLI and the Desktop share the same underlying engine — switch context without losing state.
- No vendor lock-in. The output is plain code in your repo. TheoCode does not need Theo PaaS to be useful.