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.