skills.rest
jnarowski
jnarowskiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

session-finder

Searches Claude Code session history by content, files, or tools.

18|5|Updated Nov 7, 2025
Search Tags:#developer tools#search#session management#code history#ai assistant#resume session
One-click install
npx skills add https://github.com/jnarowski/agentcmd --skill session-finder-jnarowski
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-finder
Source: https://github.com/jnarowski/agentcmd/tree/main/.claude/skills/session-finder
Command: npx skills add https://github.com/jnarowski/agentcmd --skill session-finder-jnarowski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you quickly locate and resume previous AI coding sessions based on their content, files edited, or tools used, eliminating the need to manually sift through session history.

Core Features & Use Cases

  • Content-Based Search: Find sessions by searching for specific keywords or phrases discussed within the conversation.
  • File and Tool Search: Quickly identify sessions where particular files were edited or specific tools were invoked.
  • Resume Functionality: Easily pick up where you left off in a past session with a single command.
  • Use Case: You remember working on a "log rotation feature" a few weeks ago but can't recall the exact session. Use this Skill to search for "log rotation" and get a list of relevant sessions, complete with context and a command to resume the most promising one.

Quick Start

Search for sessions where you worked on "pino log rotation" in the current project.

Frequently Asked Questions about session-finder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search past AI coding sessions by keywords or edited files?▼

Search past AI coding sessions by running a command with your target keywords. The Skill parses JSONL session files and scores matches based on conversation text, tool usage, and file operations to return relevant results.

Can I resume a previous Claude Code session if I only remember the feature I was working on?▼

Yes, you can resume a previous Claude Code session by searching for content keywords like the feature name. The Skill returns a list of matching sessions with context and a command to resume the most relevant one.

How does finding past conversations by file operations or tool usage work?▼

Finding past conversations by file operations works by parsing local JSONL session history files. Python scripts score relevance by analyzing conversation text, tool usage, and edited file paths to surface the most applicable sessions.

Does the session finder work with any specific dependencies or environments?▼

The session finder requires no external dependencies. It leverages Python scripts to parse local JSONL session files generated by Claude Code, making it functional in any standard development environment with session history.

What's the best way to locate an old AI assistant session about a specific bug fix?▼

The best way to locate an old AI assistant session about a bug fix is to search for specific keywords or phrases discussed during that conversation. The Skill matches against session content and ranks results by relevance.

Related Skills

Explore More Software Engineering Skills→
abnegateabnegate
2

history

Searches local .jsonl session files for keywords and emits resume commands for matching conversations.

Community
Basic
nyldnnyldn
4.0k

skill-resume

Restore project state from .octo files and resume workflows.

Community
Advanced
ElliotDrelElliotDrel
1

estack-read-claude-session-history

Search and recover Claude Code session history from JSONL files.

Community
Advanced
ammonfifeammonfife

read-cli-sessions

Analyze and index Claude Code CLI session transcripts from JSONL files.

Community
Advanced