claude-scripts

Search Claude Code conversation history by tool, pattern, or time and export results.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/asimihsan/dotfiles --skill claude-scripts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-scripts
Source: https://github.com/asimihsan/dotfiles/tree/main/chezmoi/dot_claude/skills/claude-scripts
Command: npx skills add https://github.com/asimihsan/dotfiles --skill claude-scripts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables searching Claude conversation history stored under ~/.claude/projects/ and exporting results for reporting or auditing.

Core Features & Use Cases

  • Search by tool, type, or pattern: Filter conversations and extract matches.
  • Exports in multiple formats: Text, table, JSON, or JSONL exports for downstream tooling.
  • Project-wide searches: Query across conversations and export summaries.

Quick Start

claude-scripts search --tool Bash claude-scripts search --type thinking --pattern "architecture"

Frequently Asked Questions about claude-scripts

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

FAQPage Schema
How do I search Claude conversation history by tool or pattern?▼

Search Claude conversation history stored in ~/.claude/projects/ using claude-scripts search with flags like --tool (including wildcards), --pattern (with regex support), and --type to filter by conversation content, then export results in text, table, JSON, or JSONL formats.

Can I export Claude conversations for auditing or reporting?▼

Yes, export Claude conversations across multiple formats—text, table, JSON, or JSONL—using claude-scripts to query ~/.claude/projects/ and filter by tool, pattern, date range, or type, producing outputs suitable for audits and downstream tooling.

What's the best way to filter conversations by date range or conversation type?▼

Use claude-scripts search with --after and --before flags to filter by date range, and --type to filter by conversation type (e.g., thinking), extracting only the results you need from your entire history.

Does claude-scripts support regex pattern matching in searches?▼

Yes, claude-scripts search supports pattern matching with optional regex and case-sensitivity flags, allowing you to match complex strings across conversation history and extract matching results selectively.

Can I get conversation summaries or aggregated results across multiple projects?▼

Yes, use --summary and --context flags to generate per-conversation aggregation and project-wide search summaries, or use --short-path to simplify output paths in your exports.

What data does claude-scripts access and how is it stored?▼

claude-scripts reads Claude Code conversation history stored under ~/.claude/projects/, applying filters and exporting results without modifying source data, making it safe for audits and compliance reporting.