How can I filter out automated agent sessions?

You can exclude sub-agent conversations by using grep to filter out filenames that start with 'agent-' when listing your session files.

What if my session history search returns no results?

Ensure the project path encoding is correct; Claude Code replaces slashes with dashes (e.g., /Users/name becomes -Users-name) for directory names.

Where does Claude Code store my session history?

Claude Code stores history as JSONL files located in ~/.claude/projects/ within directories named after your encoded project path.

Can I search for specific keywords across all my past sessions?

Yes, this skill provides a bash loop combined with grep and jq to scan all .jsonl files in a project directory for specific text strings.

JQ for Claude Session History

Name: JQ for Claude Session History
Author: grailautomation

bygrailautomation

0•

Productivity & Workflow

Queries and searches Claude Code session history using jq to retrieve past conversations and command metadata.

JQ for Claude is a specialized skill designed to help developers navigate and search their local Claude Code CLI session history. By leveraging advanced jq patterns and project path encoding logic, it allows users to precisely locate specific past interactions, extract timestamps, and filter through JSONL session logs. This skill is essential for developers who need to recall previous solutions, audit AI-generated code from earlier sessions, or manage the growing volume of local conversation data stored by the Claude Code environment.

Key Features

01Keyword-based search across all historical project sessions

02Advanced jq patterns for parsing nested JSONL message structures

03Session metadata extraction including timestamps and message counts

040 GitHub stars

05Automated project path encoding to locate hidden session directories

06Filtering logic to exclude agent sub-tasks and system-level noise

Use Cases

01Auditing recent CLI interactions to document development progress

02Recalling a specific code snippet or architectural advice from a previous session

03Searching across multiple local projects to find recurring patterns in AI responses

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add grailautomation/claude-plugins jq-for-clawd

For use in Claude.ai and ChatGPT

Download Skill