Getting Started

Zero config required

Weave works out of the box with no configuration. Add one line to opencode.json and you're done.

What is Weave?

Weave is an OpenCode plugin that brings structured workflows to your development process. Instead of ad-hoc prompting, Weave gives you a structured workflow — talk to Loom and it plans before it codes, reviews before it ships, and audits for security. Specialized agents handle each stage behind the scenes, but you interact with one.

After code is written, Weft automatically reviews code quality and Warp audits security — both run as mandatory gates before the workflow completes.

You don't replace OpenCode with Weave. You extend it. Weave layers on top of your existing OpenCode setup without touching your existing config or workflows.

Prerequisites

• OpenCode CLI installed and available on your PATH
• At least one model provider connected (see below)

Weave is distributed as an npm package (@opencode_weave/weave). OpenCode handles plugin installation automatically at startup — no separate npm install or bun add is required.

Connect a Model Provider

Weave needs access to an LLM provider like Anthropic, OpenAI, or Google. If you haven't connected one yet, use OpenCode's built-in /connect command:

1. Start OpenCode: opencode
2. Type /connect and follow the prompts to authenticate with your preferred provider

See the OpenCode provider docs for detailed setup instructions.

Multiple providers

Weave's agents use a built-in fallback chain (Anthropic → OpenAI → Google). Connecting multiple providers gives you automatic fallback if one is unavailable, but a single provider is all you need to get started.

Installation

Step 1: Create (or update) opencode.json in your project root:

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

If you already have an opencode.json, just add Weave to the plugin array:

{
  "plugin": ["@opencode_weave/weave", "other-plugin"]
}

Step 2: Start OpenCode:

opencode

OpenCode automatically installs and loads the plugin on startup. You'll see confirmation in the output:

✓ Weave loaded. Ready.

That's it. No build step, no configuration file — all agents are immediately available.

Verify Installation

Once OpenCode starts with Weave loaded, confirm everything is working:

1. Agent selector — Open the agent selector (or type an @ mention). You should see Loom, Tapestry, Shuttle, and others listed alongside any other agents
2. /start-work command — Type / in the prompt input. start-work should appear in the command list. This is the command that kicks off plan execution
3. .weave/ directory — After your first interaction with Weave, a .weave/ directory is created in your project root for state, plans, and analytics

Loom is your default entry point

Once Weave is loaded, Loom is your primary agent. It's the orchestrator — it assesses your request, delegates to specialized agents as needed, and coordinates the response. You'll interact with Loom the same way you'd interact with any OpenCode agent.

What's Next?

• Your First Task — Walk through a complete Plan → Review → Execute cycle to see Weave's agents in action
• Execution & Continuation — Learn how Tapestry resumes work, what happens on compaction, and how continuation config works
• Customization Overview — Learn about Weave's layered configuration system
• Configuration Files — Understand where config files live and how they merge