Skip to main content

search-claude-history

Search your Claude Code session history from the command line: find the conversation where you solved something, a command you ran, or an error you hit, with regular expressions, time filters, and surrounding context. It searches Claude Code by default and can search your other coding agents too, without reinstalling anything (see below).

uv tool install search-claude-history
search-claude-history "pattern"

search-claude-history is a build of search-clanker-history, which also searches other coding agents, so it installs search-clanker-history at the same version and defaults to Claude Code. The documentation lives there.

To search other agents as well, change the default once, with no reinstall:

search-claude-history --default-agents claude codex     # for example, add another agent
search-claude-history --default-agents all               # every agent that has history
search-claude-history --default-agents reset             # back to Claude Code only

search-claude-history --agent AGENT overrides the default for a single search. The choice is saved in ~/.config/search-history/config.json (under $XDG_CONFIG_HOME when that is set, and in %APPDATA%\search-history\config.json on Windows), and search-claude-history --default-agents prints the exact path. The settings file is shared by every package, so a default you save applies to all of them.

Already have an older search-claude-history? uv tool upgrade search-claude-history keeps your behavior, but the short command sch is gone; use search-claude-history, or make sch an alias for it. search-claude-history --default-agents all adds the other agents.

Metadata

Release files for search-claude-history 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for search-claude-history 0.2.0
File Size Uploaded
search_claude_history-0.2.0.tar.gz 2.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for search-claude-history 0.2.0
File Interpreter ABI Platform
search_claude_history-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 5.2 kB

Release files / search_claude_history-0.2.0.tar.gz

Download URL search_claude_history-0.2.0.tar.gz
Size 2.2 kB
Tags Source
SHA-256 checksum
How to use checksums
1bc203f203f895db04458c9370b0a0afdbaea726e9690c6e1a060f109185b004
BLAKE2b-256 checksum
How to use checksums
08e8334965289f85e28bfbc89d7a4a5aefe0507c4f32bdf72cbcb5016bc29f95
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / search_claude_history-0.2.0-py3-none-any.whl

Download URL search_claude_history-0.2.0-py3-none-any.whl
Size 3.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
deb808f4484c9be24c25dd1ed2d25f8d9c91637460046ce24fa4f32b391cf277
BLAKE2b-256 checksum
How to use checksums
18a005cb0c6d1441eac33f1fb4dabc2715757a64ad663406e744bc59ec375b92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

0.2.1

2 release files

This release

0.2.0 This release

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page