---
name: codex-native-recall
description: Native direct recall for Codex Desktop sessions. Use when Codex should remember, search, inspect, or cite prior Codex chats, previous tool output, earlier file work, session history, or cross-session context without using auto-memory/session-recall or copying transcripts into another database.
---

# Codex Native Recall

Use `codex-recall` first when prior Codex context could help the task. It reads Codex Desktop state directly:

- Metadata: `~/.codex/state_5.sqlite`
- Transcripts: `~/.codex/sessions/**/*.jsonl`
- Bundled CLI: `scripts/codex_recall.py` at the plugin root

It is read-only against Codex state and does not import transcript content into a copied recall DB.

If `codex-recall` is not on PATH, resolve the plugin root as two directories above this `SKILL.md`, then run:

```powershell
python "<plugin-root>\scripts\codex_recall.py" health
```

## Query Ladder

Start cheap:

```powershell
codex-recall health
codex-recall list --json --limit 5
codex-recall files --json --days 14 --limit 20
```

Search only when needed:

```powershell
codex-recall search "<term>" --json --limit 5
```

Drill into a session only after finding a candidate:

```powershell
codex-recall show <session-id> --json --turns 8
```

Use `--repo all` only when current-repo recall misses something relevant. Use `--full` on `show` only when the task requires full visible transcript/tool-output context.

## Fallback

Do not use the third-party `auto-memory` or `session-recall` package for Codex Desktop recall. This plugin is the native path.