Install for Pi

• Pi >= 0.81.1 (proof covers 0.84.2)
• Bun-based launcher (required for Bun built-ins)
• Trusted project with .weave/config.weave in project root

1. Install the Weave adapter for Pi:

pi install npm:@weaveio/weave-adapter-pi@latest

2. Initialize Weave:

weave init --scope local --yes

See the CLI reference for more initialization options and the DSL Configuration guide for configuration syntax.

3. Start Pi normally. Weave agents will be loaded automatically.

Weave is available on multiple release channels:

• latest: Stable releases (recommended)
• next: Pre-release versions with upcoming features
• nightly: Bleeding-edge builds from the main branch

To install a specific channel, specify it in the install command:

pi install npm:@weaveio/weave-adapter-pi@next

Weave requires a trusted project with a valid .weave/config.weave file in the project root. On session start, the adapter checks:

• Project trust status
• Configuration validity
• Host surfaces and capabilities

If any required check fails, the extension enters health-only mode.

When activation checks fail, Weave enters health-only mode. In this mode:

• Safe health and diagnostic commands remain available
• Configuration-driven execution is disabled
• Workflow mutation is blocked
• Child process coordination is unavailable

What you can do:

• Run /weave:health to inspect activation status
• Check trust settings for your project
• Verify .weave/config.weave exists and is valid
• Restart Pi after resolving issues

After installation, verify Weave is active:

1. Start Pi in a trusted project
2. Run /weave:health to check activation status
3. Run /weave:status to inspect workflow capabilities

If Weave is in health-only mode, the health command will show which checks failed.