Skip to content
What snoop reads and writes

What snoop reads and writes

Everything snoop does happens on your machine, and it makes no network requests.

Reads

PathWhat
~/.claude/projects/<project>/<session>.jsonlsession transcripts
~/.claude/projects/<project>/<session>/subagents/subagent transcripts and their metadata

When CLAUDE_CONFIG_DIR is set, snoop reads $CLAUDE_CONFIG_DIR/projects instead. It never writes to these files.

Writes

PathWhat
<cache>/snoop/summaries.jsonthe summary and find index, one entry per transcript, rebuilt when a transcript changes
<cache>/snoop/notified/one small file per notification sent, so several snoops send it only once; each is removed after an hour
./<id>-<date>-<time>.mdtimelines you export with e
<state>/snoop/inbox/<session>/comments sent from the Diff tab and replies, one file per send, removed once a hook delivers them
<state>/snoop/asks/<session>/permission requests waiting for an answer, one file per request, and snoop’s answers; removed once answered or given up on
<state>/snoop/turns/<session>/one file while a session’s finished turn waits for a reply, removed when it stops waiting
<state>/snoop/listeningrewritten every 2 seconds while a live board or session view is open, so the hooks know to wait
.git/config of the session’s repositorybranch.<name>.snoopBase, only when you choose a base with B in the Diff tab
~/.claude/settings.jsonsnoop’s four hook entries, only when you run snoop hooks install; snoop hooks uninstall removes them

Here <cache> is your user cache directory:

PlatformCache directory
Linux$XDG_CACHE_HOME, or ~/.cache
macOS~/Library/Caches
Windows%LocalAppData%

Here <state> is $XDG_STATE_HOME or ~/.local/state on Linux, ~/Library/Application Support on macOS and %AppData% on Windows.

The Diff tab also runs git in the session’s working directory, read-only and without taking the index lock.

Deleting the cache is safe; snoop rebuilds it on the next scan.