# Palimem

> Local-first memory for coding agents. Supersession, scoped recall, and audit export.

Palimem is an open-source MCP memory server. Facts append to a write-ahead log; updates supersede prior values. Scoped recall separates user, session, and repository context. Apache-2.0.

## Key concepts

- **Supersession** — New writes supersede outdated values; history is preserved.
- **Scopes** — User, session, and repository contexts stay isolated.
- **Audit** — Point-in-time recall (`as_of`), retention controls, and export.
- **11 MCP tools** — Defined in spec v1.7.0 with automated validation.

## Spec

- Spec: v1.7.0 (`spec/README.md` in the repository)
- License: Apache-2.0
- Repository: https://github.com/palimem/palimem

## Connect

- Claude Code plugin and MCP stdio
- Cursor, Copilot CLI, Codex, Windsurf via MCP
- Hermes and OpenClaw adapters

## Install

- Getting started: /docs/getting-started
- Integrations: /docs/integrations

## Agent setup prompt

```
Install Palimem as local memory for this project.

- Project: Palimem (spec v1.7.0)
- Prefer: Claude Code plugin if available, else MCP stdio
- Data directory: .ai-memory/data
- Verify: tools/list shows 11 tools; memory_status reports ok and index current

Use the install instructions at: /docs/getting-started
Do not enable cloud services unless I ask.
```

## Full docs index

/docs/llms.txt

## Discovery

- AI catalog: /.well-known/ai-catalog.json
- Documentation: https://palimem.com/docs/
- GitHub: https://github.com/palimem/palimem