# tempera

Gives your agent persistent memory: it records sessions, finds similar past fixes by meaning, and brings them back when a task looks familiar.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: anvanster
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/anvanster/tempera
- Updated: 2026-05-29
- HTML: https://affpapa.org/en/nevibecode/mcp/tempera

## What it does

Tempera stores each coding session as an episode, indexes it, and pulls the relevant ones when you hit a similar problem. Retrieval is semantic, so a query about a login redirect can surface a fix from weeks ago. Episodes carry a utility score, and that score moves.

Feedback raises utility. Value then spreads across the similarity graph over several hops, and episodes chained into one multi-step task boost each other. A nightly dream cycle runs verification, decay, reflection, pattern detection, contradiction probing and template extraction. One call, `tempera_brief(files, task_type?, domain?)`, lines all of that up against the files the agent is about to touch and returns pending ask-backs, a matching reasoning template and a calibration warning.

Decay depends on scope. Project-bound claims fade in roughly 70 days, language-level facts last around 3 years, universal ones never expire. Both `tempera_retrieve` and `tempera_brief` take `cross_project=true`, which lets transferable claims show up in other repositories. Older captures stay non-transferable until they are reclassified.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add tempera -- npx -y @astudioplus/tempera-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add tempera -- npx -y @astudioplus/tempera-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tempera": {
            "command": "npx",
            "args": [
                "-y",
                "@astudioplus/tempera-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tempera": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@astudioplus/tempera-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add tempera npx -y @astudioplus/tempera-mcp
```

## When to use it
- recall how a similar bug was fixed last time
- reuse a step sequence that worked before
- drop advice that already failed
- carry language or library knowledge into another repo
- get clarifying questions for the files you are about to edit

## Example prompts
- Search memory for how we fixed the login redirect before
- Run a brief on `src/auth/session.ts` before I touch it
- Look for similar episodes across all projects with `cross_project=true`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md