> ## 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 Codex with Slowave

> Give OpenAI Codex one local memory across the CLI, the desktop app and the IDE extension. Set it up once with Slowave.

![OpenAI logo](https://mintcdn.com/slowave-ai/hrOsN_VNHRWDj6ew/images/clients/openai.svg?fit=max\&auto=format\&n=hrOsN_VNHRWDj6ew\&q=85\&s=db469ee6541df7c6c46df91daa9c5cba)

Slowave gives Codex a local memory. One setup covers the Codex CLI, the desktop app and the IDE extension.

## What you get

* Slowave's memory tools appear in Codex through MCP.
* Setup adds the server to `~/.codex/config.toml`.
* Setup adds Slowave's instructions to `~/.codex/AGENTS.md`.
* All three Codex surfaces share these files. Memories follow your work between them.

## 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**

```bash theme={null}
slowave setup --client codex
```

There is no separate Codex desktop target. This one command is enough.

**4. Restart Codex**

Restart each Codex surface you use.

## Check that it works

Start a coding task in Codex. The `slowave_*` tools should appear and the instructions should be read.

Then run this in a terminal:

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

Run `slowave dashboard` to see recorded sessions in your browser.

## Good to know

* Setup detects Codex when `~/.codex/` exists. If you set `$CODEX_HOME`, Slowave uses that folder instead.
* Slowave runs on macOS, Linux and Windows.
* Recalled context is sent to the model like any other prompt text.

## Troubleshooting

> [accordion] Codex ignores the Slowave instructions
>
> If you have `~/.codex/AGENTS.override.md`, Codex reads only that file at global scope. It ignores `AGENTS.md`. `slowave doctor` warns you about this. Copy the Slowave block from `AGENTS.md` into your override file.

> [accordion] The tools don't appear
>
> Run `slowave status --services` and restart Codex. Older Codex versions can ignore remote MCP servers unless a compatibility setting is on. Setup doesn't write that setting. Check your Codex version first.

> [accordion] Sessions stay empty
>
> Check that the `slowave_*` tools are present and the Slowave block is in the file Codex reads.

> [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.