Metadata-Version: 2.5
Name: search-codex-history
Version: 0.2.0
Summary: Search your Codex session history from the command line
Project-URL: Homepage, https://github.com/wakamex/search-clanker-history
Project-URL: Source, https://github.com/wakamex/search-clanker-history
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agents,cli,codex,openai,search,session-history
Requires-Python: >=3.10
Requires-Dist: search-clanker-history==0.2.0
Provides-Extra: hyperscan
Requires-Dist: search-clanker-history[hyperscan]==0.2.0; extra == 'hyperscan'
Provides-Extra: ripgrep
Requires-Dist: search-clanker-history[ripgrep]==0.2.0; extra == 'ripgrep'
Description-Content-Type: text/markdown

# search-codex-history

Search your Codex 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 Codex by default and can search your other coding agents too, without reinstalling anything (see below).

```bash
uv tool install search-codex-history
search-codex-history "pattern"
```

`search-codex-history` is a build of [search-clanker-history](https://github.com/wakamex/search-clanker-history), which also searches other coding agents, so it installs search-clanker-history at the same version and defaults to Codex. The documentation lives there.

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

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

`search-codex-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-codex-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-codex-history` keeps your behavior, but the short command `sch` is gone; use `search-codex-history`, or make `sch` an alias for it. `search-codex-history --default-agents all` adds the other agents.
