io.github.AINative-Studio/ainative-opencode-memory-mcp
Persistent cross-session memory for OpenCode and MCP coding agents, powered by ZeroDB.
Open source Open in the app JSON README (API)
About
Persistent cross-session memory for OpenCode and MCP coding agents, powered by ZeroDB.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- ainative-studio
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.2
- Last push
- 2026-08-02T18:06:07Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:38
- Updated
- 2026-08-29 03:01:38
- Origin id
io.github.AINative-Studio/ainative-opencode-memory-mcp
README
# ainative-opencode-memory-mcp
**Persistent memory for [OpenCode](https://opencode.ai) agents.** OpenCode is stateless — it forgets everything between sessions. This MCP server gives your OpenCode coding agent **long-term memory** powered by [AINative ZeroDB](https://ainative.studio/opencode?utm_source=npm&utm_medium=mcp&utm_campaign=opencode-memory): store a codebase's decisions, conventions, and gotchas once, and recall them in every future session.
## Why
OpenCode restarts with a blank slate every time. Your agent re-learns your architecture, re-asks the same questions, re-makes the same mistakes. With this MCP, it remembers:
- Architecture & design decisions
- Naming conventions and code style
- Gotchas, workarounds, and "don't touch X" rules
- User/team preferences
## Install
```bash
npm install -g ainative-opencode-memory-mcp
```
## Setup (OpenCode)
1. **Get a free API key** → [ainative.studio/signup](https://ainative.studio/signup?utm_source=npm&utm_medium=mcp&utm_campaign=opencode-memory) (Hobbyist $5/mo, 7-day free trial).
2. Add to your OpenCode MCP config (`opencode.json` / MCP settings):
```json
{
"mcpServers": {
"ainative-memory": {
"command": "npx",
"args": ["-y", "ainative-opencode-memory-mcp"],
"env": { "AINATIVE_API_KEY": "your-key-here" }
}
}
}
```
## Tools
| Tool | What it does |
|------|--------------|
| `opencode_store_memory` | Remember a fact/decision/snippet (optional tags) |
| `opencode_search_memory` | Semantic search over everything remembered |
| `opencode_recall_context` | Reload relevant memories at the start of a task |
| `opencode_memory_stats` | How many memories are stored |
| `opencode_clear_memory` | Wipe memories (optionally by tag) |
## Example
At the start of a session, have your agent call `opencode_recall_context` with the file/task you're working on — it reloads what it knew. As you work, `opencode_store_memory` captures new decisions. Next session, it all comes back.
## Environment
| Var | Default | Notes |
|-----|---------|-------|
| `AINATIVE_API_KEY` | — | **Required.** Free at ainative.studio |
| `OPENCODE_MEMORY_NAMESPACE` | `opencode` | Isolate memories per project |
| `AINATIVE_API_URL` | `https://api.ainative.studio` | Override for self-host |
---
Built by [AINative Studio](https://ainative.studio/opencode?utm_source=npm&utm_medium=mcp&utm_campaign=opencode-memory) — the AI-native dev platform with 65+ models, one OpenAI-compatible endpoint, and persistent agent memory. MIT licensed.