claude-session-search

Find any past Claude Code session — by topic/content or by exact name — across every project, and pull its context back into your current session.

A Claude Code skill, packaged as an installable plugin.

The gap it fills

Claude Code's /resume (and claude --resume <name>) can browse and resume sessions by name — even across projects, with Ctrl+A. But there is no native search over session content or topic, and no way to pull an old session's substance back without loading the whole thing.

session-search greps the raw transcripts on disk (~/.claude/projects/**/*.jsonl):

• a name is an instant exact match (via the Session renamed to: marker the transcript records on /rename);
• a topic is a ranked content search across every project.

Then it launches a sub-agent to read the top hits and return a synthesis — so a multi-MB session never blows your current context window. Context stops getting stuck in another session.

Install

1. Plugin (one command):

/plugin marketplace add ArchieeR/claude-session-search
/plugin install session-search@claude-session-search

After installing, run /reload-plugins. The skill is namespaced under the plugin, so invoke it as /session-search:session-search (or just describe the task and Claude will pick it up).

2. Manual:

Copy the skill file into your personal skills directory:

mkdir -p ~/.claude/skills/session-search
cp SKILL.md ~/.claude/skills/session-search/SKILL.md

Installed this way it's invoked as /session-search.

Usage

/session-search googleio                       # exact name → instant hit
/session-search what did we decide about auth   # topic search, all projects

How it works

Three steps:

1. Name lookup — if the argument looks like a session name, grep for the Session renamed to: <name> marker. One hit → straight to deep-load.
2. Topic scan — otherwise grep every project's transcripts for the query terms plus synonyms, ranked by hit count and recency.
3. Sub-agent reads & synthesises — dispatch an agent over the top candidates to read and rank them and return the decisions/designs/conclusions, so the raw JSONL never hits your main context.

---

Built by Archie Roberts while building Rheos. MIT.