How do I install the Sessions skill?

Run npx skillmds@latest add thehammer/sessions in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sessions safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sessions?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sessions free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sessions?

thehammer (@thehammer) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sessions by thehammer — Agent Skill

Name: Sessions
Rating: 4.2 (5 reviews)
Author: thehammer

File contents

Session History Skill

Search and browse past Claude Code session transcripts.

When to Use

Trigger when user:

Asks "how did we do X", "when did we work on Y"
Wants to find a past command or approach
Asks "what did I work on recently"
Needs context from a previous session
Mentions "session", "history", "last time"

Setup

source ~/.claude/lib/services/sessions.sh

Operations

List recent sessions

sessions_list                          # Last 20 sessions
sessions_list 10                       # Last 10
sessions_list 20 "careportal"          # Last 20 in careportal project

Search sessions by topic

sessions_search "authentication"       # Search summaries + project names
sessions_search "docker" 10            # With limit

Search for specific commands

sessions_search_commands "magick"              # Find ImageMagick commands
sessions_search_commands "git rebase"          # Find rebase commands
sessions_search_commands "docker" "careportal" # Scoped to project

Get session details

sessions_get "1a4e1696"                # By ID or prefix

Extract tool calls from a session

sessions_get_commands "1a4e1696"               # All tool calls
sessions_get_commands "1a4e1696" "Bash"        # Just Bash commands
sessions_get_commands "1a4e1696" "Edit" 20     # Edits, limit 20

Get files modified in a session

sessions_get_files "1a4e1696"          # Created (Write) and Modified (Edit)

Rebuild index (if stale)

sessions_rebuild_index

Search Strategy

Know what you're looking for? → sessions_search_commands "pattern"
Topic-based search? → sessions_search "topic"
Browse recent work? → sessions_list
Deep dive into a session? → sessions_get_commands + sessions_get_files

Notes

Sessions are JSONL files at ~/.claude/projects/<project>/<sessionId>.jsonl
Index auto-rebuilds if older than 1 hour
Command search uses grep (fast, substring match)
Session search uses text matching on summaries (no semantic/embedding search)
For complex multi-session research, delegate to the session-researcher agent

---name: sessionsdescription: Search past Claude Code sessions. Find commands, files modified, and context from previous work. Use when user asks "how did we do X", "find that session where", or "what did I work on".---# Session History SkillSearch and browse past Claude Code session transcripts.## When to UseTrigger when user:- Asks "how did we do X", "when did we work on Y"- Wants to find a past command or approach- Asks "what did I work on recently"- Needs context from a previous session- Mentions "session", "history", "last time"## Setup```bashsource ~/.claude/lib/services/sessions.sh```## Operations### List recent sessions```bashsessions_list # Last 20 sessionssessions_list 10 # Last 10sessions_list 20 "careportal" # Last 20 in careportal project```### Search sessions by topic```bashsessions_search "authentication" # Search summaries + project namessessions_search "docker" 10 # With limit```### Search for specific commands```bashsessions_search_commands "magick" # Find ImageMagick commandssessions_search_commands "git rebase" # Find rebase commandssessions_search_commands "docker" "careportal" # Scoped to project```### Get session details```bashsessions_get "1a4e1696" # By ID or prefix```### Extract tool calls from a session```bashsessions_get_commands "1a4e1696" # All tool callssessions_get_commands "1a4e1696" "Bash" # Just Bash commandssessions_get_commands "1a4e1696" "Edit" 20 # Edits, limit 20```### Get files modified in a session```bashsessions_get_files "1a4e1696" # Created (Write) and Modified (Edit)```### Rebuild index (if stale)```bashsessions_rebuild_index```## Search Strategy1. **Know what you're looking for?** → `sessions_search_commands "pattern"`2. **Topic-based search?** → `sessions_search "topic"`3. **Browse recent work?** → `sessions_list`4. **Deep dive into a session?** → `sessions_get_commands` + `sessions_get_files`## Notes- Sessions are JSONL files at `~/.claude/projects/<project>/<sessionId>.jsonl`- Index auto-rebuilds if older than 1 hour- Command search uses grep (fast, substring match)- Session search uses text matching on summaries (no semantic/embedding search)- For complex multi-session research, delegate to the `session-researcher` agent

Frequently asked questions

Sessions