by alash3al · alash3al/stash
A tiny Go memory service for agents — episodes (events over time) and facts (durable knowledge), exposed via MCP.
Stash gives agents two storage modalities: episodes (time-ordered events) and facts (key-value durable knowledge). Lightweight, single-binary, easy to run on a Raspberry Pi.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"stash-mcp": {
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "stash-mcp",
"command": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"stash-mcp": {
"command": {
"path": "docker",
"args": [
"run",
"-p",
"9000:9000",
"ghcr.io/alash3al/stash:latest"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add stash-mcp -- docker run -p 9000:9000 ghcr.io/alash3al/stash:latestOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: You want Claude to remember preferences and recent context.
Outcome: Continuity without paying for a full memory SaaS.
Periodically dump memory to disk for backup
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| remember_episode | (see docs) | Append a timeline event | 1 call |
| remember_fact | (see docs) | Store a durable fact | 1 call |
| search | (see docs) | Search both stores | 1 call |
Embedding endpoint missingSet EMBEDDING_URL or run in keyword-only mode
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| memsearch | You want Milvus-backed scale | Heavier setup |