# Run the Dreamer

> Install it once, schedule it nightly — your own agent, your keys, your memory.

Your memory keeps itself while you sleep. The Dreamer is your own Claude,
running the consolidation playbook against your memory: raw entries become a
cited wiki, contradictions become proposals, patterns become insights. Nothing
runs on OceanDB's servers — your agent, your keys, your memory.

## 1. Connect (once)

```bash
claude mcp add --transport http oceandb https://app.oceandb.ai/api/mcp
```

Sign in when the browser opens. (Claude Desktop: Settings → Connectors → add
the same URL.) See [Connect your agent](/docs/connect) for the details.

## 2. Install the skill (once)

```bash
mkdir -p ~/.claude/skills/oceandb-dreamer && curl -fsSL https://oceandb.ai/dreamer-skill.md -o ~/.claude/skills/oceandb-dreamer/SKILL.md
```

The skill is a thin wrapper: it reads the authoritative playbook straight from
your OceanDB connection (`oceandb://docs/dreamer`), so it never drifts from
what the server documents.

## 3. Dream

On demand, in any Claude Code session:

```
/oceandb-dreamer
```

Nightly, while you sleep (macOS/Linux cron; runs headless with your stored
sign-in):

```bash
crontab -e
# add:
0 3 * * * claude -p "Run the /oceandb-dreamer skill" --dangerously-skip-permissions >> ~/.oceandb-dreamer.log 2>&1
```

If you'd rather not skip permission checks wholesale, allowlist just the
OceanDB tools instead — add a permission entry for the `oceandb` MCP server to
`~/.claude/settings.json` and drop the flag. claude.ai scheduled routines can
run it too, if your OceanDB connector is available there.

## What a night's sleep produces

Pages written and linked with citations. Contradictions opened as proposals —
the Dreamer never resolves them behind your back; review at
[app.oceandb.ai/dashboard/review](https://app.oceandb.ai/dashboard/review).
Insights — the non-obvious things it noticed about you — at
[app.oceandb.ai/dashboard/insights](https://app.oceandb.ai/dashboard/insights).

For what each phase does, see [The nightly playbook](/docs/dreamer-playbook).