---
title: Memory — OpenCode V2 Plugin by Jad Madi (@jadmadi)
description: >-
  Keeps per-project memory, checkpoints, and notes, injects a budgeted slice at
  session start, and exposes read, append, and search tools.
href: /project/opencode-plugins/memory/
category: Sessions and memory
version: 2026.9.0
builtUnder: 2.0.16
license: MIT
repo: 'https://github.com/jadmadi/opencode-memory'
author: Jad Madi
runtime: OpenCode V2
telemetry: 0% (Local First)
installCommand: 'opencode plugin add github:jadmadi/opencode-memory'
tags:
  - memory
  - checkpoints
  - session
  - notes
---
# Memory — OpenCode V2 Plugin

Keeps per-project memory, checkpoints, and notes, injects a budgeted slice at session start, and exposes read, append, and search tools.

- **Website**: https://jadmadi.net/project/opencode-plugins/memory/
- **Repository**: https://github.com/jadmadi/opencode-memory
- **Category**: Sessions and memory
- **Version**: v2026.9.0 (CalVer)
- **Tested Runtime**: OpenCode v2.0.16
- **License**: MIT
- **Artifact**: `memory.ts`
- **Updated**: 2026-09-25
- **Author**: [@JadMadi](https://x.com/jadmadi)

## Quick Install

Install with a single command in OpenCode V2:

```bash
opencode plugin add github:jadmadi/opencode-memory
```

### Manual / Local Install

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.

## What It Does

Keeps per-project memory, checkpoints, and notes, injects a budgeted slice at session start, and exposes read, append, and search tools.

## Slash Commands

| Command | Description |
| :--- | :--- |
| `/remember` | Append a line to MEMORY.md. |
| `/memory` | Show the three memory files. |
| `/checkpoint` | Write a memory checkpoint now. |

## Agent Tools Registered

- `memory_read`
- `memory_append`
- `memory_search`

## Limitations & Safety Rules

Files live under the OpenCode data dir per project. MEMORY_ROOT and MEMORY_BUDGET override location and size. A checkpoint is written on compaction.

## Frequently Asked Questions (Agent Q&A)

### Q: What problem does Memory solve?
Sessions and compaction lose context; decisions, file state, and next steps need a durable project store that survives both.

### Q: How do I install and run Memory?
Run `opencode plugin add github:jadmadi/opencode-memory` in your terminal.

### Q: Does this plugin transmit telemetry or code externally?
No. It operates with 0% telemetry, local-first in ~/.config/opencode/plugins/.

## Links & Resources

- Dedicated Page: https://jadmadi.net/project/opencode-plugins/memory/
- All OpenCode Plugins: https://jadmadi.net/project/opencode-plugins/
- GitHub Repository: https://github.com/jadmadi/opencode-memory
- Changelog: https://github.com/jadmadi/opencode-memory/blob/main/CHANGELOG.md
- Author Profile: https://jadmadi.net/about/