armin-opencode

ARMIN — queryable decision memory for AI coding agents — packaged for opencode.

npx armin-opencode install      # or: npm i -g armin-opencode && armin install

Prefer a global install over one-off npx runs: npx caches are evicted.

armin install downloads the armin-engine sidecar binary for your platform from the GitHub releases and registers the plugin in your global opencode config as a pinned npm entry — in the schema your opencode generation reads:

// opencode v1
{ "plugin": [["armin-opencode@<version>", { "enabled": true }]] }

// opencode v2
{ "plugins": [{ "package": "armin-opencode@<version>", "options": { "enabled": true } }] }

opencode then installs the package — with its @opencode-ai/plugin SDK dependency — into its own plugin cache on next start. The options object is the schema-safe config channel in both versions (opencode strips unknown top-level keys like the legacy "armin": {...} section; options are passed straight to the plugin). The same package entrypoint implements both: v2 reads id + setup() from the default export, v1 reads server() from it. ARMIN_ENABLED=1 remains as a per-environment escape hatch.

Verify a install (registration form, engine binary, opencode's plugin cache, SDK resolution, module import):

armin doctor

See the main repo for what the agent gets (durable decisions/rules/open items, scoped reasoning-state brief, compaction survival, live status page).