Skip to main content
skill CX Codex

recall-conversations — Claude Code skill: search past sessions

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

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@Claudest
Open on GitHub

What recall-conversations 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}.

What it helps with

  • 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 for the agent

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

How to install recall-conversations

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@Claudest

This installs the whole claude-memory plugin with all its skills

2Skills CLI (Vercel)

npx skills add gupsammy/Claudest --skill recall-conversations -a claude-code

3Manually: put the files in place

~/.claude/skills/recall-conversations/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/recall-conversations/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about recall-conversations

How do I install recall-conversations in Claude Code?

Add the marketplace first: /plugin marketplace add gupsammy/Claudest. Then run /plugin install claude-memory@Claudest. The skill arrives as part of that plugin.

What does recall-conversations do?

It searches and rereads your earlier Claude sessions, then restores context or analyses them: retros, decisions, recurring mistakes. Three Python scripts read the local database.

When does search catch paraphrases?

When the search metadata reports retrieval: hybrid, meaning-based matches are fused with keyword hits. Passing --lexical keeps keywords only.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set47

The whole set →
claw-advisor claw-advisor is a Claude Code skill for OpenClaw setup, troubleshooting, and architecture questions. It handles requests about channels, gateways, models, and automation. CX Codex +1 ★ 276repo stars update-readme update-readme rewrites an existing README.md using the current code, git log and changelog. Useful once the docs drift away from what the repo actually does. CX Codex +1 ★ 276repo stars architecture-auditor architecture-auditor reviews system structure, detects circular dependencies, and suggests design patterns when features touch multiple modules. CX Codex ★ 276repo stars make-changelog make-changelog creates or updates CHANGELOG.md from Git history in Keep a Changelog format. Use it when preparing release notes or catching up on missing entries. CX Codex +1 ★ 276repo stars make-readme make-readme inspects repository context, runs a brief questionnaire, and builds a complete README.md with status badges. CX Codex +1 ★ 276repo stars push-pr push-pr is a Claude Code skill that pushes a branch and creates or updates its GitHub pull request. For large or mixed changes, it can propose splitting them into stacked PRs. CX Codex +1 ★ 276repo stars brainstorm brainstorm — an interview skill that turns the tables: the agent asks, you answer, and the session ends with a written spec or decision doc. CX Codex +1 ★ 276repo stars get-token-insights get-token-insights parses Claude Code conversation history, flags token waste, and generates an offline dashboard covering costs, hooks, and agent workflows. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open