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.1

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.1
File Size Uploaded
search_claude_history-0.2.1.tar.gz 2.2 kB Details

Built distribution (wheel)

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

Total release size: 5.2 kB

Release files / search_claude_history-0.2.1.tar.gz

Download URL search_claude_history-0.2.1.tar.gz
Size 2.2 kB
Tags Source
SHA-256 checksum
How to use checksums
cfcab723968e965f1a9950d403a3822c3e68048b3ff9ee7b83edb397e35f9a6d
BLAKE2b-256 checksum
How to use checksums
a05214abeaaf0433ab4b41e289919351be56df2cbf6da056a60b82eb2f7c9022
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.1-py3-none-any.whl

Download URL search_claude_history-0.2.1-py3-none-any.whl
Size 3.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
241416f9fa03615502c38cb78450a2be636097ddecf5697ec5497dd841d0e248
BLAKE2b-256 checksum
How to use checksums
cedeee90662c5c5ed39052cd6cb4a8d2f60d50fb04b7e514d72accc940734e98
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

This release

0.2.1 This release

2 release files

0.2.0

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