# recall-conversations

recall-conversations reads back your earlier Claude sessions: finds a decision, restores context, or builds a retro from the local conversation database.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/skills/recall-conversations/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/recall-conversations

## What it does

The skill gives Claude a way back into earlier sessions. Three Python scripts sit on top of the local conversation store. `recent_chats.py` lists sessions by recency, with `--timeline` for a one-line index and `--session` for a named session by uuid or an 8+ character prefix. `search_conversations.py` does keyword search, ranked by BM25 when FTS5 is present. `list_projects.py` maps project names to paths and session counts.

Each request goes to a lens — restore context, look up one decision, run a retrospective, collect rules you stated but never saved to `CLAUDE.md`, spot repeated mistakes. Every lens ships a recipe with its own flags, and the questions to ask of the retrieved sessions live in `references/lenses.md`. Scope defaults to the current project via CWD; `--project` and `--all-projects` widen it.

Matching is lexical. A prompt with no concrete terms returns noise, so recency listing beats search there. Broad pulls print whole transcripts and fill the context window; the wide recipes pass `--summary` for that reason, and when even that is too much you shard by project and hand each shard to a subagent. Scripts run under `python3`, with paths built from `${CLAUDE_PLUGIN_ROOT}`.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-memory@Claudest
```
This installs the whole claude-memory plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill recall-conversations -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/recall-conversations/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/recall-conversations/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill recall-conversations -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/recall-conversations/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill recall-conversations -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/recall-conversations/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-memory/skills/recall-conversations
```

2. **Manually: put the files in place**
- File: `.github/skills/recall-conversations/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill recall-conversations -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-memory/skills/recall-conversations
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/recall-conversations/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/skills/recall-conversations/SKILL.md

## When to use it
- pick up a project where you left it
- find the session where a bug got fixed
- write a retro covering several weeks of work
- turn rules said out loud in chat into `CLAUDE.md` entries
- spot mistakes you keep repeating

## Example prompts
- Where did we leave off? Restore context for this project.
- Find the session where we dealt with the login bug and show the matching passages.
- Run a retrospective over the last sessions: what went well, what hurt.

## Similar
- [recall-reasoning](https://affpapa.org/en/nevibecode/skills/recall-reasoning.md) — skill · 605 installs
- [recall](https://affpapa.org/en/nevibecode/plugins/recall.md) — plugin · ★ 23 repo stars
- [remembering-conversations](https://affpapa.org/en/nevibecode/skills/remembering-conversations.md) — skill · 9200 installs
- [mempalace-recall](https://affpapa.org/en/nevibecode/skills/mempalace-recall.md) — skill · 2000 installs
- [gsd-mempalace-recall](https://affpapa.org/en/nevibecode/skills/gsd-mempalace-recall.md) — skill · 573 installs
- [fixing-claude-export-conversations](https://affpapa.org/en/nevibecode/skills/fixing-claude-export-conversations.md) — skill · 825 installs

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
