opencode-openmemo

Persistent project memory plugin for OpenCode. Stores AI discoveries as paired .md + .json files with embeddings for semantic dedup and search, then auto-commits them via git.

Install

Add to your opencode.json:

{
  "plugin": ["opencode-openmemo"]
}

OpenCode installs it automatically at startup.

How it works

The AI tags discoveries in its responses using inline tags:

[Solved: slow build — added cache]   → tracked as a fix
[Bug: login redirect loop]           → tracked as a bug
[Decision: use sqlite — simpler]      → tracked as a decision
[Dep: express 4.18.2]                → tracked as a dependency

The plugin:

• Detects these tags in streaming responses (debounced, cached)
• Generates embeddings via @xenova/transformers (runs locally, no server)
• Deduplicates entries by cosine similarity
• Auto-captures git commits, branch switches, npm installs
• Builds a live STATE.md with active issues, decisions, dependencies
• Syncs via git for cross-machine use

Data

Everything lives in .openmemo/:

• entries/ — paired .md + .json files (max 500)
• STATE.md — auto-generated project state summary
• journal.md — session & action log
• user-profile.md — tool usage patterns

Migration

If you used the old aiproject plugin, entries in .aiproject/entries/ are auto-migrated on first run.