Weaveweave
Get started ↗
MITharness-agnostic · multi-agent · dsl-first

One config. Eight specialists. Any harness.

Define your agent workflow once in .weave files. Run it across OpenCode, Pi, or Claude Code without changing a line.

Plan-then-execute · mandatory review gates · interrupt and resume Free to use — you pay only for model API calls
.weave/config.weaveagents/harnessroute · plan · execute · review
what you get

Six guarantees, not six features.

Every one of these is enforced by the workflow rather than left to the model to remember.

01

Plan-then-execute workflow

Explicit phases separate planning from implementation. Pattern researches, Weft validates, then Shuttle executes.

02

Mandatory review gates

Weft reviews code quality and Warp audits security before work is considered complete. No bypassing.

03

Intelligent token management

Agents delegate to sub-agents for focused work. Token tracking warns at 80% and recovers at 95%.

04

Interrupt and resume

Stop anytime. Progress persists as checkboxes. Resume and pick up from the first unchecked task.

05

DSL-first configuration

Override models per agent. Inject skills from markdown. Disable what you don't need. Full control, zero lock-in.

06

Same config, any harness

Write your .weave config once. Run it on OpenCode, Pi, or Claude Code. No vendor lock-in.

how weave works

Ask a question, or run a plan.

Not every request needs every agent. Loom routes on context; an explicit plan follows a fixed lifecycle.

Conversational routing

  • Thread / Spindle — Evidence-gathering: codebase exploration and external research
  • Pattern — Planning: structured implementation plans with rationale
  • Shuttle — Implementation: domain-specific code changes
  • Weft — Review gate: code quality validation (conditional)
  • Warp — Security gate: vulnerability auditing (conditional)

Explicit plan execution

  • Pattern creates plan — Researches codebase, produces checkboxed tasks with rationale
  • User starts execution — Explicit approval before any code is written
  • Tapestry delegates tasks — Coordinates execution, hands tasks to Shuttle workers
  • Optional review gates — Weft/Warp run if configured, not unconditionally
the pipeline

Explore → Plan → Implement → Review → Resume.

the agent roster

Eight specialists with one job each.

Narrow remits keep prompts short and context focused, which is what makes delegation worth the hop.

Loom

Orchestrator

Primary coordinator that routes requests to specialists based on context and complexity

Pattern

Strategic Planner

Creates structured execution plans from complex requirements

Tapestry

Plan Executor

Drives plan completion by sequencing and delegating tasks

Shuttle

Domain Specialist

Implements bounded work packages within a single domain

Thread

Codebase Explorer

Gathers evidence from the local codebase through targeted exploration

Spindle

External Researcher

Researches external documentation, APIs, and specifications

Weft

Code Reviewer

Reviews changes for quality, correctness, and standards compliance

Warp

Security Auditor

Audits code for security vulnerabilities and compliance issues

install

Pick your harness.

Then follow the setup steps. For the complete walkthrough, see thequickstart guide.

  1. Install the Weave CLI

    bun add --global @weaveio/weave-cli@latest
  2. Add the Weave plugin

    Add "@weaveio/weave-adapter-opencode" to the plugin array in opencode.json.

  3. Restart OpenCode

    The plugin is picked up on start, so restart before continuing.

  4. Initialize your project

    Writes a starter .weave config into the current repository.

    weave init --scope local --yes
  1. Install the Weave CLI

    bun add --global @weaveio/weave-cli@latest
  2. Install the Pi adapter

    pi install npm:@weaveio/weave-adapter-pi@latest
  3. Initialize your project

    Writes a starter .weave config into the current repository.

    weave init --scope local --yes
  1. Install the Weave CLI

    bun add --global @weaveio/weave-cli@latest
  2. Initialize your project

    Writes a starter .weave config into the current repository.

    weave init --scope local --yes
  3. Compose for Claude Code

    weave compose --adapter claude-code --init
  4. Finish the setup

    See the quickstart guide for the remaining Claude Code configuration.

get started

Ready to orchestrate?

MIT licensed. Free to use. You pay only for model API calls.