Memory
Keeps per-project memory, checkpoints, and notes, injects a budgeted slice at session start, and exposes read, append, and search tools.
Quick Answer & Overview
Memory is an open-source (MIT) OpenCode V2 plugin by @JadMadi. It resolves: Sessions and compaction lose context; decisions, file state, and next steps need a durable project store that survives both.. Installed via opencode plugin add github:jadmadi/opencode-memory, it operates locally with 0% telemetry.
opencode plugin add github:jadmadi/opencode-memory Local manual setup:
Copy memory.ts into ~/.config/opencode/plugins/ and restart the TUI.
The Problem It Solves
Sessions and compaction lose context; decisions, file state, and next steps need a durable project store that survives both.
Slash Commands
| Command | Description & Usage |
|---|---|
/remember | Append a line to MEMORY.md. |
/memory | Show the three memory files. |
/checkpoint | Write a memory checkpoint now. |
Registered Agent Tools
This plugin registers custom tools that OpenCode agents can invoke autonomously during execution:
memory_read memory_append memory_search Design Guardrails & Limitations
Files live under the OpenCode data dir per project. MEMORY_ROOT and MEMORY_BUDGET override location and size. A checkpoint is written on compaction.
Technical Specifications
- Target Host
- OpenCode V2 (CLI & TUI)
- Tested Runtime
- OpenCode
v2.0.16(builtUnder-2.0.16) - Artifact File
memory.ts- Version Scheme
- CalVer (YYYY.MM.MICRO) · Current:
v2026.9.0 - Default Install Path
~/.config/opencode/plugins/memory.ts- License
- MIT (Open Source)
- Last Updated
- 2026-09-25
Frequently Asked Questions
What problem does Memory solve?
Sessions and compaction lose context; decisions, file state, and next steps need a durable project store that survives both.
How do I install Memory in OpenCode V2?
Run the terminal command: `opencode plugin add github:jadmadi/opencode-memory`. The runtime clones the repository into `~/.config/opencode/plugins/memory.ts` and activates it in your next session. Alternatively: Copy memory.ts into ~/.config/opencode/plugins/ and restart the TUI.
What are the guardrails and limitations for Memory?
Files live under the OpenCode data dir per project. MEMORY_ROOT and MEMORY_BUDGET override location and size. A checkpoint is written on compaction.
What slash commands does Memory provide?
/remember (Append a line to MEMORY.md.); /memory (Show the three memory files.); /checkpoint (Write a memory checkpoint now.)
What autonomous agent tools are registered by Memory?
This plugin provides the following autonomous tools for OpenCode agents: memory_read, memory_append, memory_search.