Agentmemory Launcher for OpenCode

OpenCode plugin that auto-starts the agentmemory backend with health-check supervision.

Requirements

• Node.js ≥ 18.0.0
• OpenCode with plugin support
• agentmemory backend (auto-installed via npx @agentmemory/agentmemory if not present)

What It Does

This plugin automatically starts the agentmemory backend (REST API + iii-engine) when OpenCode loads its configuration. It runs once per OpenCode process and health-checks the backend every 60 seconds, restarting it if the process dies.

Installation

From npm (recommended)

Add to your OpenCode config:

// opencode.json
{
  "plugin": ["opencode-agentmemory-launcher@latest"]
}

OpenCode will automatically install the package at startup. See the OpenCode Plugins documentation for more details.

From local file

Place the plugin file in .opencode/plugins/:

.opencode/plugins/
└── agentmemory-launcher.ts

Files in this directory are automatically loaded at startup.

Manual Installation (from GitHub Releases)

1. Download the latest release from GitHub Releases
2. Extract the archive
3. Copy the dist/ folder into .opencode/plugins/agentmemory-launcher/:

.opencode/plugins/agentmemory-launcher/
├── agentmemory-launcher.js
├── agentmemory-launcher.js.map
├── agentmemory-launcher.d.ts
└── agentmemory-launcher.d.ts.map

4. Add to your OpenCode config:

// opencode.json
{
  "plugin": ["./plugins/agentmemory-launcher/agentmemory-launcher.js"]
}

Usage

This launcher starts the agentmemory backend. To use agentmemory with OpenCode, also install the agentmemory plugin and refer to the OpenCode agentmemory plugin usage guide for setup instructions, available tools, and configuration options.

How It Works

1. On first config load: The plugin starts a health-check interval (60s)
2. Health check: Pings GET /agentmemory/health on the backend
3. Auto-restart: If the health check fails, spawns npx @agentmemory/agentmemory in a detached process
4. Debug mode: Set OPENCODE_AGENTMEMORY_DEBUG=1 for verbose logging

Environment Variables

API

The plugin exports a single object conforming to the @opencode-ai/plugin interface:

import type { Plugin } from "@opencode-ai/plugin";

export const AgentmemoryLauncherPlugin: Plugin;

This plugin implements the config lifecycle hook, which is called each time OpenCode loads its configuration.

Development

# Install dependencies
npm install

# Type-check
npm run typecheck

# Build
npm run build

# Run tests
npm test

Community

• Contributing Guide
• Code of Conduct
• Security Policy

License

GNU Affero General Public License v3.0

Copyright

Copyright (C) 2026 Cle2ment.