Toren documentation

Toren is the open-source runtime for long-running, durable agents — in your own cloud.

The docs follow Diátaxis: learn by doing → solve a task → look something up → understand why.

Start here

I want to…	Go to
See it work in 10 minutes	Quickstart
Define my own agent, tools, subagents	Defining agents
Orchestrate parallel work and iteration	Workflows & waves
Gate dangerous actions behind a human	Approvals
Trigger runs over HTTP from anywhere	HTTP API
Deploy into my AWS account	Deploy to AWS
Trace and monitor runs	Observability
Look up a command or config key	CLI · agent.yaml · Workflow API · Event catalog
Understand how durability actually works	Durability & replay
Understand the system's shape	Architecture

The full design rationale lives in the design spec at docs/superpowers/specs/2026-08-18-durable-agent-harness-design.md in the repository.

Honest status of these docs

Area	Status
Quickstart, guides, concepts, CLI/config reference	✅ written, matches shipped code
TypeScript API reference (@toren/core symbols)	❌ gap — needs typedoc generation
HTTP intake API (runs, status, events, approvals)	✅ v0 shipped — see the guide; sessions/SSE remain roadmap (spec §19)
Troubleshooting / FAQ	❌ gap — collect from first external users
Versioning & compatibility policy	❌ gap — needed before first public release
Examples gallery beyond research-crew	❌ gap
Client SDK (@toren/client), env declarations, environment profiles	✅ shipped