memory-management
Persist and retrieve structured state across sessions using local files as external memory store.
Source facts
- Repository
- glayph/Agent
- Last source activity
- September 19, 2026 at 22:39
- Detected SKILL.md language
- English
- Stars
- 0
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- memory-management
- description
- Persist and retrieve structured state across sessions using local files as external memory store.
- version
- 1.0.0
- author
- Miki
- license
- MIT
- platforms
- ["linux","macos","windows"]
- metadata
- {"Miki":{"tags":["memory","persistence","state-management","session"],"related_skills":["rag-context"]}}
# External Memory & State Management
## Storage format
Use `.opencode/memory/` directory. Each memory domain gets its own JSON file:
```
.opencode/memory/
├── project-state.json # active tasks, decisions, blockers
├── known-bugs.json # bugs discovered across sessions
├── conventions.json # code style, arch patterns learned
└── changelog.json # significant changes made
```
## Schema per domain
### project-state.json
```json
{
"current_task": "string | null",
"completed_tasks": ["string"],
"decisions": [{ "what": "string", "why": "string", "date": "ISO" }],
"blockers": ["string"]
}
```
### known-bugs.json
```json
{
"bugs": [{ "id": "string", "symptom": "string", "cause": "string", "fix": "string", "status": "open|fixed" }]
}
```
### conventions.json
```json
{
"conventions": [{ "pattern": "string", "rule": "string", "source": "string" }]
}
```
## Protocol
- **Read** memory at session start (check file mtime)
- **Write** memory on: task completion, bug discovery, arch decision
- **Update in place** — append-only for history, overwrite for current state
- **Keep entries under 3 lines** — avoid bloat
## Commands
- `save: <domain> <key> <value>` — persist a fact
- `read: <domain>` — retrieve all facts for domain
- `forget: <domain> <key>` — remove a fact
View on GitHub