Skip to content

Concepts

theta operates usually on a four-stage pipeline:

theta.toml --> theta.lock --> .theta/ --> harness config
 (manifest)    (lock)      (sync)    (cast)

Each stage is deterministic and independently inspectable.

theta.toml is the single source of truth for an agent. For the full field specification, see theta-spec.

Concept What it is
Sources Where dependencies come from: path, git, system, url, registry
Lockfile & sync theta.lock pins versions; theta sync materializes .theta/
Caching Git and registry cache layout, TTL, sharing across projects