Backends¶
agentgrep reads on-disk stores from multiple AI coding assistants. Each backend page documents the agent’s path layout, environment overrides, store descriptors, and record schemas.
Backend pages¶
OpenAI Codex CLI history, sessions, instructions, memory, goals, and SQLite state.
Claude Code history, project transcripts, tasks, memory, settings, and plugin surfaces.
cursor-agent transcripts, prompt history, chat blobs, and AI-tracking summaries.
Cursor desktop app state.vscdb SQLite — global and per-workspace chat history.
Gemini CLI chat sessions, prompt logs, checkpoints, settings, and skills.
Grok CLI prompt history, session transcripts, memory, logs, and config.
Pi (earendil-works) session transcripts, settings, prompts, and managed extensions.
OpenCode (anomalyco) SQLite session store, config, snapshots, and caches.
Coverage levels¶
The backend pages distinguish search support from storage coverage.
Default-search stores are opened by normal search and find commands.
Inspectable stores are known and can be inventoried explicitly, but
are not searched by default. Catalog-only stores are documented so
future adapters do not mistake them for prompt history; some catalog
stores expose safe structural samples for inspect_record_sample, but
they still stay outside default search. Private stores are documented
but intentionally not enumerated from disk.
Search scope is record-level. --scope prompts is the default and
includes dedicated prompt-history logs plus user turns projected from
transcript-only backends. Full conversation, assistant, tool, and event
records require --scope conversations or --scope all.
Version detection¶
Source discovery reports version metadata separately from record content. agentgrep prefers concrete source evidence over app freshness: embedded metadata, file/record shape, and SQLite suffixes identify the data version; local version files provide app-version context only when they can be read without spawning an upstream CLI. If neither is available, the catalog observation stamp is reported as a low-confidence fallback.
Support matrix¶
- Default search:
- Opt-in parsers:
- Safe catalog samples:
- Memory:
- Plans / todos / goals:
- Instructions / plugins / skills:
- Indexes / summaries:
-
- App state / config:
- Runtime / cache / private:
- Default search:
- Opt-in parsers:
- Safe catalog samples:
- Memory:
- Plans / todos / goals:
- Instructions / plugins / skills:
- Indexes / summaries:
- App state / config:
- Runtime / cache / private:
- Default search:
- Opt-in parsers:
- Safe catalog samples:
- Memory:
-
- Plans / todos / goals:
- Instructions / plugins / skills:
-
- Indexes / summaries:
- App state / config:
- Runtime / cache / private:
- Default search:
- Opt-in parsers:
-
- Safe catalog samples:
-
- Memory:
-
- Plans / todos / goals:
-
- Instructions / plugins / skills:
-
- Indexes / summaries:
-
- App state / config:
- Runtime / cache / private:
-
- Default search:
- Opt-in parsers:
-
- Safe catalog samples:
- Memory:
-
- Plans / todos / goals:
-
- Instructions / plugins / skills:
- Indexes / summaries:
-
- App state / config:
- Runtime / cache / private:
- Default search:
- Opt-in parsers:
-
- Safe catalog samples:
- Memory:
- Plans / todos / goals:
-
- Instructions / plugins / skills:
-
- Indexes / summaries:
- App state / config:
- Runtime / cache / private:
- Default search:
- Opt-in parsers:
-
- Safe catalog samples:
- Memory:
-
- Plans / todos / goals:
-
- Instructions / plugins / skills:
-
- Indexes / summaries:
-
- App state / config:
- Runtime / cache / private:
- Default search:
- Opt-in parsers:
-
- Safe catalog samples:
- Memory:
-
- Plans / todos / goals:
-
- Instructions / plugins / skills:
- Indexes / summaries:
-
- App state / config:
- Runtime / cache / private: