ctx
A CLI for instant search across coding-agent session history on your machine, like git blame for sessions
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Reads local coding-agent session history
Install
Manual install
curl -fsSL https://ctx.rs/install | shPackage-manager installs and a source build are also available.
This is third-party code. Review the repository files before installing.
What it does
ctx searches the history already on your machine: coding-agent sessions, the flow of work, what was discussed and done and when. The tool is written in Rust and runs fast without loading history into a separate database. It helps recall the context of past work: find an event, open the session, get JSON output. It ships skills and plugins for agents, so the agent itself can search the history too. It installs with a single script, with package-manager and source-build options as well.
Who it is for. For developers who work with coding agents a lot and want to find past context quickly.
Good fit when
- You need to recall what a past agent session did
- You need to find a specific event or decision in the history
- You want JSON output of the history for further processing
Not a fit when
- You do not use coding agents whose history the tool reads
- You need a full knowledge manager rather than session search
Example request
Find in the session history where we changed the build config and open that sessionLimitations
The tool searches local session history, so it is only as useful as that history. The main docs and concepts live on the project site. Installation is via a script, package managers or a source build.
How to disable. Remove the ctx binary and uninstall any installed skills or plugins from the agent directories.
Security check
- Reads local coding-agent session history
README in short
The README describes ctx as a fast tool for searching coding-agent session history already on the machine. It installs with a single script, with options via GitHub Releases, mise, Homebrew and a source build. It lets you find an event, open a session and get JSON output, and wire skills and plugins into agents. Written in Rust, Apache-2.0 licensed.
FAQ
Do I need a database?
No. ctx searches the on-disk history directly, without a separate relational database.
Can the agent search on its own?
Yes, it ships skills and plugins so the agent can call the history search.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
An open source coding agent for the terminal and desktop with build and plan modes
Open prompt library with a Claude Code plugin, MCP server and CLI: search, fetch and improve prompts and skills from an agent