opencode-amplifier

OpenCode plugin that connects to a native local Amplifier runtime. Provides Amplifier-mode execution, bundle/profile management, mode switching, provider control, and fail-closed diagnostics from within any OpenCode session.

What it does

| Layer | Responsibility | |-------|---------------| | opencode-amplifier (this plugin) | Bootstrap/connect runtime, translate OpenCode UX into runtime calls, render status and diagnostics | | Native Amplifier runtime | Resolve bundles/profiles, create sessions, execute prompts, manage tools/hooks/approvals/orchestration |

Quick start

1. Clone and install

git clone https://github.com/anthropics/opencode-amplifier.git
cd opencode-amplifier
bun install

2. Run tests

bun test          # 80 tests, should all pass with clean output
bun run typecheck  # should exit silently (no errors)

3. Use with OpenCode

Add the plugin to your opencode.json or opencode.jsonc:

{
  "plugin": ["file:///absolute/path/to/opencode-amplifier"]
}

Then start OpenCode normally. The plugin registers 19 tools and 4 hooks automatically.

4. (Optional) Full Amplifier integration

For bundle resolution and context loading, install the Amplifier Python runtime:

uv tool install amplifier

Without it the plugin still works — it falls back to built-in defaults.

Available tools

| Tool | Description | |------|-------------| | amplifier_status | Session state, runtime connection, active bundle/mode/provider | | amplifier_capability | Get, set, or list coordinator capabilities | | amplifier_emit | Emit a kernel hook event | | amplifier_bundle_resolve | Resolve a bundle and show its mount plan | | amplifier_bundle_list | List available bundles | | amplifier_bundle_show | Show bundle details | | amplifier_bundle_use | Switch active bundle | | amplifier_bundle_current | Show currently active bundle | | amplifier_agents_list | List available agents | | amplifier_agents_show | Show agent details | | amplifier_provider_list | List configured providers | | amplifier_provider_use | Switch active provider | | amplifier_modes_list | List available modes | | amplifier_mode | Activate or deactivate a mode | | amplifier_settings_get | Show current settings | | amplifier_settings_set | Update a setting | | amplifier_init | Initialize Amplifier in the current project | | amplifier_doctor | Diagnose configuration and runtime issues | | amplifier_cli | Escape hatch: run any CLI command (diagnostics only) |

Architecture

OpenCode UI surfaces
  -> opencode-amplifier plugin  (src/plugin/index.ts)
    -> runtime client            (src/runtime/client.ts)
      -> transport               (src/runtime/transport.ts)
        -> native Amplifier runtime
    -> bundle resolution         (src/bundle/)
    -> mode discovery            (src/modes/)
    -> provider mapping          (src/providers/)
    -> hooks                     (src/plugin/hooks.ts)
    -> tools                     (src/tools/)
    -> [transitional] kernel     (src/kernel/session.ts)

Development

bun install        # install dependencies
bun test           # 80 tests, all should pass with clean output
bun run typecheck  # should exit silently (no errors)

Requirements

• Bun (for development and testing)
• OpenCode (any version with plugin support)
• Optional: Amplifier Python runtime (uv tool install amplifier) for full bundle resolution and context loading

License

MIT