AgentThreader

Manifest-driven agentic CLI orchestration

Structured contracts. Resumable state. Bounded self-healing.

View on GitHub Install

How It Works

Declare Work

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

Thread Agents

The orchestrator schedules tasks through CLI adapters with dependency-aware ordering and resumable execution state.

Verify & Checkpoint

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

Self-Heal

Bounded healing logic diagnoses failures, patches prompts, and retries without letting the run spiral.

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

macOS / Linux

$ bash <(curl -fsSL https://agentthreader.com/install.sh) --all
==> Bootstrapping agent-threader@latest
--> Installing agent-threader@latest globally...
--> Delegating to local installer...
==> Done.

$ npx --yes agent-threader@latest --help

Windows PowerShell

PS> & ([ScriptBlock]::Create((Invoke-RestMethod 'https://agentthreader.com/install.ps1'))) -All
==> Bootstrapping agent-threader@latest
--> Installing agent-threader@latest globally...
--> Delegating to Node.js installer...
==> Done.

The hosted bootstrap script installs the published package, then delegates to the packaged install.js Node.js installer to copy compiled skills into your detected tools.

Release automation uses AGENT_TOKEN for release commit/tag push and AGENT_NPM_TOKEN for npm publish.

View install.sh View install.ps1 Repository

Ecosystem

Part of the Agentic Skill Mill family.

⚒