Skip to content

Manifest

The manifest is a theta.toml file. It fully describes an agent: identity, instructions, tools, skills, and subagents.

Sections

The Requirement column uses RFC 2119 keywords:

  • MUST means a valid theta.toml requires this section
  • SHOULD means it is expected in most real configs
  • MAY means it is entirely optional
Section Purpose Requirement Reference
[theta] Schema version MUST format
[agent] Name, description, version, authors, model MUST agent
[instructions] System prompts, rules SHOULD instructions
[tools.*] MCP server declarations SHOULD tools
[skills.*] Composable capability packages SHOULD skills
[[subagents]] Subagent definitions SHOULD subagents
[harness.<name>] Harness-specific config passthrough MAY harness extensions
[extras.<name>] Third-party tool config MAY extras

Field definitions and specification can be found here.