Harness Engineering for Coding Agents

Orchestrate agent workflows
with precision

Declarative workflow specs, artifact pipelines, and resumable execution. Build durable, repeatable automation for Codex, OpenCode, and any process-backed agent.

Get Started View on GitHub

terminal

$ agentweaver auto-golang DEMO-1234

Fetching Jira context...

Running phase: plan done

Running phase: implement done

Running phase: review done

Running phase: commit done

All phases completed successfully.

Features

Everything you need to orchestrate agents

Declarative Flow Specs

Define workflows as JSON specs with phases, steps, prompt bindings, and expectations. Version-controlled and repeatable.

Multi-Agent Executors

First-class integrations for Codex, OpenCode, shell processes, Jira, GitLab, and Telegram — all unified under one pipeline.

Artifact Pipeline

Stages produce and consume artifacts as stable contracts. Context flows between phases automatically, building on prior results.

Resumable Execution

Interrupted? Resume from any phase. AgentWeaver persists state, validates launch profiles, and picks up right where you left off.

Interactive TUI

Browse workflows, launch in scope, follow activity, and review execution summaries — all from a full-screen terminal interface.

Custom Flow Specs

Create project-local workflows under .agentweaver/.flows/ with the same validation and runtime as built-in flows.

How It Works

Three steps to automated workflows

Define Your Flow

Write a declarative JSON spec describing phases, steps, prompt bindings, and expected artifacts. Or use one of 16 built-in workflows.

{
  "name": "auto-golang",
  "phases": [
    { "name": "plan", "executor": "codex" },
    { "name": "implement", "executor": "codex" },
    { "name": "review", "executor": "codex" },
    { "name": "commit", "executor": "shell" }
  ]
}

Set the Scope

Point AgentWeaver at a Jira ticket, GitLab MR, or any scope identifier. It fetches context, creates an isolated workspace, and prepares artifacts.

$ agentweaver auto-golang DEMO-1234

Fetching Jira context for DEMO-1234...
Scope initialized: .agentweaver/scopes/DEMO-1234/
Artifacts directory ready.

Execute & Resume

AgentWeaver runs each phase through the appropriate executor, persisting state between steps. Interrupted? Resume from any phase with full context.

$ agentweaver auto-golang DEMO-1234 --from review

Resuming from phase: review
Validating saved artifacts... OK
Running phase: review ✓
Running phase: commit ✓
All phases completed.

Quick Start

Up and running in minutes

Install globally

$ npm install -g agentweaver

Or build from source

$ git clone https://github.com/seko99/AgentWeaver.git

$ cd AgentWeaver && npm install && npm run build

$ node dist/index.js --help

Configure integrations

# ~/.agentweaver/.env

JIRA_API_KEY=your-token

JIRA_BASE_URL=https://your-org.atlassian.net

GITLAB_TOKEN=your-token

Run your first workflow

$ agentweaver plan PROJ-42

# Or launch the interactive TUI

$ agentweaver

Orchestrate agent workflows with precision