@opencode_weave/weave

Weave

Weave is a lean OpenCode plugin with multi-agent orchestration. It provides a cohesive framework for weaving agents, tools, and skills into structured workflows. By delegating complex tasks to specialized agents and monitoring execution state through hooks, Weave ensures reliable and efficient project development.

Overview

• 8 specialized agents with weaving-themed names designed for specific roles in the development lifecycle.
• Category-based task dispatch to route work to domain-optimized models and configurations.
• Skill system for injecting domain-specific expertise that modifies agent behavior via prompt orchestration.
• Background agent management for parallel asynchronous sub-agent execution with concurrency control.
• Context window monitoring to track token usage and suggest recovery strategies when limits are approached.
• Tool permissions enforced per-agent to ensure safety and prevent unauthorized file modifications.
• JSONC configuration supporting comments and trailing commas with hierarchical user and project-level merging.

Documentation

For detailed guides on configuration, workflows, agents, features, and more, visit the Weave documentation.

For agent routing eval trends and dashboards, see the Eval Dashboard.

Config schema

Weave ships a generated config schema at schema/weave-config.schema.json in this repository.

• Regenerate it: bun run schema:config
• Verify it is current: bun run schema:config:check
• Use it in config files via $schema, preferably pinned to a release tag such as https://raw.githubusercontent.com/pgermishuys/opencode-weave/v0.7.6/schema/weave-config.schema.json

The npm package currently publishes dist/ only, so if you want a local $schema path you should vendor schema/weave-config.schema.json into your own repository. Runtime config still supports JSONC comments and trailing commas even though the published schema artifact is plain JSON.

Agents

Agent	Role	Mode	Description
Loom	main orchestrator	primary	The central team lead that plans tasks, coordinates work, and delegates to specialized agents.
Tapestry	execution orchestrator	primary	Manages todo-list driven execution of multi-step plans, focusing on sequential implementation without subagent spawning.
Shuttle	category worker	all	Domain-specific specialist worker with full tool access, dispatched dynamically via the category system.
Pattern	strategic planner	subagent	Analyzes requirements and produces detailed implementation plans with research and dependency mapping.
Thread	codebase explorer	subagent	Fast, read-only codebase navigation and analysis using grep, glob, and read tools.
Spindle	external researcher	subagent	Performs external documentation lookups and reference searches, providing synthesized answers with source citations.
Weft	reviewer/auditor	subagent	Reviews completed work and plans with a critical but fair eye, rejecting only for true blocking issues.
Warp	security auditor	subagent	Audits code changes for security vulnerabilities and specification compliance with a skeptical bias.

Installation

This package is published on npm.

Prerequisites

• OpenCode

Step 1: Add to opencode.json

Add the plugin to your opencode.json file:

{
  "plugin": ["@opencode_weave/weave"]
}

Step 2: Restart OpenCode

OpenCode automatically installs npm plugins at startup — no manual bun add or npm install required. The plugin loads automatically upon restart and works with zero configuration out of the box.

Troubleshooting

Issue	Solution
404 Not Found	Ensure the package name is correct: @opencode_weave/weave.
Package not found after publish	npm can take a few minutes to propagate. Wait and retry.

Uninstalling

To fully remove the Weave plugin from your project:

Step 1: Remove from opencode.json

Delete the @opencode_weave/weave entry from the plugin array in your opencode.json:

{
  "plugin": []
}

Step 2: Clean up project artifacts (optional)

Weave may have created plan and state files during usage. Remove them if no longer needed:

rm -rf .weave/

You can also remove any project-level configuration if present:

rm -f .opencode/weave-opencode.jsonc .opencode/weave-opencode.json

Step 3: Clean up user-level configuration (optional)

If you no longer use Weave in any project, remove the global configuration:

rm -f ~/.config/opencode/weave-opencode.jsonc ~/.config/opencode/weave-opencode.json

Development

• Build: bun run build
• Test: bun test
• Typecheck: bun run typecheck
• Clean: bun run clean

Acknowledgments

Weave was inspired by Oh My OpenCode by @code-yeongyu — a pioneering OpenCode plugin that proved multi-agent orchestration, discipline agents, and structured plan-execute workflows could radically improve the developer experience. Many of Weave's core ideas — from category-based task dispatch to background agent parallelism — trace their roots to patterns Oh My OpenCode established. We're grateful for the trailblazing work and the vibrant community around it.

License

MIT