ctx

ctx command [options]

ctx is a Rust CLI that indexes coding agent session logs already stored on your machine and makes them searchable from the shell. It imports history from Claude Code, Codex, Cursor, Pi, OpenCode, Antigravity, Factory AI Droid, and Copilot CLI, normalizing sessions and events into a local SQLite database.Agents often start from zero and cannot recover prior decisions, failed commands, or rejected approaches. ctx lets you or a current agent find that context before repeating work. Results include session IDs, event IDs, snippets, and cited matches — far more token-efficient than grepping raw transcripts.All indexing and search runs locally. No prompts, transcripts, or history are sent to a cloud service.

setup

Discover and import local agent history into the SQLite index.

Full-text search across indexed sessions and events.

Restrict search to sessions that touched the given file.

Add an additional search term (repeatable).

Print transcript context around a specific event.

Print a compact session transcript.

List importable agent history sources on this machine.

Run read-only SQL against the local index.

Emit machine-readable JSON output.

Transcript text is preserved as stored locally; review output before sharing outside the machine. Source builds and package-manager installs do not self-upgrade — only installer-managed binaries support ctx upgrade.

rg(1), jq(1)

Source code · Homepage · Documentation