session-search

Search session history by Grep against YAML frontmatter metadata.

1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/mawaha/claude-session-memory --skill session-search-mawaha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-search
Source: https://github.com/mawaha/claude-session-memory/tree/main/skills/session-search
Command: npx skills add https://github.com/mawaha/claude-session-memory --skill session-search-mawaha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows users to efficiently search through past conversation sessions based on various metadata, making it easy to retrieve specific information or context from previous interactions.

Core Features & Use Cases

  • Metadata Filtering: Search sessions by project, Git branch, tags, date ranges, and status.
  • Context Retrieval: Quickly find summaries and details of past sessions for reference.
  • Use Case: A developer needs to recall the debugging steps taken on a specific feature branch last week. They can use this Skill to search for sessions tagged with 'debugging' on that branch and date range.

Quick Start

Use the session-search skill to find debugging sessions from last week.

Frequently Asked Questions about session-search

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

FAQPage Schema
How do I search past session history by Git branch and date range?

You can search session history by filtering YAML frontmatter metadata using Grep. This targets specific sessions by Git branch, project, tags, and date ranges, retrieving summaries and links to view the matching session files.

What is the best way to retrieve debugging context from previous conversation sessions?

Retrieving debugging context from previous sessions is done by searching YAML frontmatter metadata with Grep. You can filter by tags like 'debugging' to quickly find summaries and details of past interactions for reference.

How does searching session files with Grep against YAML frontmatter metadata work?

Searching session files with Grep against YAML frontmatter metadata works by targeting specific criteria in the file headers. It matches sessions based on project, Git branch, tags, and date ranges, then presents summaries with links to the full files.

Can I filter session history by project, tags, and status?

Yes, you can filter session history by project, Git branch, tags, date ranges, and status. The search queries YAML frontmatter metadata in session files to retrieve and present summaries of matching sessions with links to view them.

What are the limitations of searching session history using frontmatter metadata?

Searching session history using frontmatter metadata relies on the presence and accuracy of YAML fields in session files. It targets metadata like project and Git branch, meaning sessions without properly structured frontmatter may not be retrieved.

Do I need specific session file formats to search conversation history by metadata?

You need session files containing YAML frontmatter metadata to search conversation history effectively. The search uses Grep against this metadata to target sessions by criteria like project, Git branch, tags, and date ranges.