> ## Documentation Index
> Fetch the complete documentation index at: https://slowave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Persistent memory for Claude Code with Slowave

> Give Claude Code a local, persistent memory with Slowave. One command connects the MCP server and adds the instructions Claude Code needs.

![Claude Code logo](https://mintcdn.com/slowave-ai/hrOsN_VNHRWDj6ew/images/clients/claude.svg?fit=max\&auto=format\&n=hrOsN_VNHRWDj6ew\&q=85\&s=04165a07ea4cad82fd75aa04e556bf06)

Slowave gives Claude Code a memory that carries across sessions. Decisions, constraints and procedures stay on your machine and come back when they matter.

## What you get

* Slowave's memory tools appear in Claude Code through MCP.
* Setup adds the Slowave server to Claude Code's user-level MCP list in `~/.claude.json`.
* Setup adds Slowave's instructions to `~/.claude/CLAUDE.md`. They tell Claude Code when to recall, save and report on memory.
* No manual paste is needed.

## Set up

**1. Install Slowave**

```bash theme={null}
pipx install slowave
```

**2. Preview the changes**

```bash theme={null}
slowave setup --dry-run
```

**3. Run setup**

To configure only Claude Code, run:

```bash theme={null}
slowave setup --client claude-code
```

Or run `slowave setup` to connect every agent it finds.

**4. Restart Claude Code**

Restart so it loads the server and instructions.

## Check that it works

Open Claude Code and start a coding task. The `slowave_*` tools should appear in its tool list.

From a terminal, run:

```bash theme={null}
slowave doctor
```

It shows which agents it detected and whether the background service is healthy. Run `slowave stats` to see recorded sessions, or `slowave dashboard` to browse them in your browser.

## Good to know

* Setup detects Claude Code when the `~/.claude/` folder exists.
* Slowave runs on macOS, Linux and Windows.
* Slowave keeps memory on your machine. Recalled context is still sent to the model like any other prompt text.

## Troubleshooting

> [accordion] The Slowave tools don't appear
>
> Run `slowave status --services` to check the background service. Then restart Claude Code.

> [accordion] The tools appear but memory isn't used
>
> Run `slowave setup --client claude-code` again. This refreshes the instructions in `~/.claude/CLAUDE.md`.

> [accordion] Setup didn't connect the server
>
> Add the server to `~/.claude.json` yourself, then restart Claude Code:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "slowave": {
>       "type": "http",
>       "url": "http://127.0.0.1:8766/mcp"
>     }
>   }
> }
> ```

> [card] [Quickstart](https://slowave.ai/quickstart.md)
>
> Install Slowave and see your first memory.

> [card] [All integrations](https://slowave.ai/integrations/overview.md)
>
> Compare every supported agent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.