Six thread types. Structured sequences. Runtime surfaces. Gate approvals. Full audit. Local-first. One workbench for all of it.
Without a control plane
ThreadOS
Steps and dependencies. Gates and approvals. Runtime surfaces and runs. Six coordination patterns from simple sequential to long-autonomy with watchdogs. SAFE and POWER policy modes. A workbench and CLI that operate on the same underlying state.
Thread Types
Every multi-agent workflow maps to one of these types. Pick a pattern, define steps, and ThreadOS handles execution, dependencies, and runtime state.
baseSingle sequential agent. One agent, one task. The simplest pattern.
Code generation, document writing, one-off analysis
- id: write-docs type: base model: claude-code prompt_file: prompts/docs.md
The Workbench
The left rail exposes Sequence, Hierarchy, Lanes, Gates, Agents, Builders, and Packs. The canvas renders your thread surfaces. The inspector lets you deep-dive any node.
Author threads, steps, gates, dependencies. Apply templates. Set thread types.
Parent-child surface relationships. Spawn chains. Depth inspection.
Run-scoped execution order. Merge markers. Completion state per lane.
Condition-aware approvals. Block, approve, cascade. Full audit trail.
Register with model + skill metadata. Assign to steps. Track performance.
Deep-dive any surface: run events, merge history, artifacts, annotations.
CLI
thread — init, step, dep, gate, run, stop, restart, group, fusion, mprocs, template, status.
Under the hood
Threads materialise into runtime surfaces. Each holds runs with full event history — spawns, merges, gate decisions.
Structured tool_use for sequence editing. Propose, validate, and apply actions without leaving the workbench.
SAFE mode requires confirmation for every action. POWER mode removes prompts but enforces allowlists, forbidden patterns, and concurrency limits.
LLM-driven workflow optimisation. Analyses sequences. Suggests improvements with confidence + impact.
Local policy.yaml enforces command allowlists, cwd patterns, max fanout, forbidden regex. Every mutation is auditable.
Same underlying state. thread CLI for scripting. Local API for integrations. Workbench for humans.
Who it's for
Six thread types. Structured sequences. Runtime surfaces. Gate approvals. Full audit. All local. All yours.
Built by @binarybaron · Local-first · MIT License