AgentThreader

Manifest-driven agentic CLI orchestration

Structured contracts. Resumable state. Bounded self-healing.

View on GitHub Learn More

How It Works

1

Declare Work

Define tasks, dependencies, timeouts, and verification profiles in a manifest.v2 JSON file.

2

Thread Agents

The orchestrator schedules tasks through CLI adapters (agent, opencode, claude) with dependency-aware ordering.

3

Verify & Checkpoint

Every result is parsed, schema-validated, and verified before state is committed. Atomic writes ensure safe resume.

4

Self-Heal

Progressive Batch Healing diagnoses failures, patches prompts, and retries -- bounded by convergence rules to prevent runaway loops.

v2 Contract Stack

manifest.v2 Task declarations
task_result.v2 Worker output
heal_decision.v2 Healer output
state.v2 Run state
verify_profile.v2 Verification steps

Companion CLI

$ agent-threader validate-manifest manifest.json
Valid manifest: 12 tasks
Dependency order: WP-001 -> WP-003 -> WP-002 -> ...

$ agent-threader init-state manifest.json
State initialized: .agentic/state.json
  Run ID:  run-2026-04-02
  Tasks:   12
  Heal:    auto

$ agent-threader status
Run run-2026-04-02: RUNNING
  DONE       8
  RUNNING    2
  PENDING    2

Quick Start

$ git clone https://github.com/barretts/AgentThreader.git
$ cd AgentThreader
$ bash install.sh
==> agent-threader setup
    Targets: claude cursor windsurf opencode
==> Done.

Auto-detects installed tools. Installs the skill for all detected IDEs and links the agent-threader CLI globally.