Sherlog is a local-first CLI for searching local Codex and Claude Code session logs. It is built for agents that know how to investigate: find the right session first, then read only the relevant range or page.
Install the CLI globally:
npm i -g @act0r/sherlog
shlog --helpInstall the agent skill separately:
npx skills add catoncat/sherlog --full-depth --skill sherlog -g -a codex -yInitialize the default Codex index:
shlog syncSearch and read progressively:
shlog find "health check"
shlog read-range <sessionRef> --seq <matchSeq>
shlog read-page <sessionRef> --offset 0 --limit 20For project-scoped agent work, check and refresh only that coverage:
shlog status --cwd /Users/you/work/project --json
shlog sync --cwd /Users/you/work/project- Design Philosophy - Why FTS? Why not
ripgrepor embeddings? - Usage Guide - Full commands, selectors, sync, and storage details.
- Architecture - Retrieval model and how it works under the hood.
- Roadmap - What's coming next.
- Agent Rules - Project rules and contribution notes.