55 lines
2 KiB
Markdown
55 lines
2 KiB
Markdown
|
# cont
|
||
|
|
|
||
|
|
Find and resume coding agent sessions from the terminal. Supports Pi, Claude Code, Codex, OpenCode and Oh My Pi.
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
Requires Rust and a C compiler. The agents you use must be on your `PATH`.
|
||
|
|
|
||
|
|
```sh
|
||
|
|
cargo install --git https://src.liamrohan.com/ldr/cont.git --locked
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```sh
|
||
|
|
cont # sessions in the current directory
|
||
|
|
cont --all # sessions across all directories
|
||
|
|
cont --all auth refactor # search sessions
|
||
|
|
cont --agent claude # filter by agent
|
||
|
|
cont -C ~/code/my-project # use a different directory
|
||
|
|
cont --all --list postgres # search without the terminal UI
|
||
|
|
cont --all --json # JSON output
|
||
|
|
cont --print # print the selected session's command
|
||
|
|
```
|
||
|
|
|
||
|
|
Type to search titles and human messages. Press Enter to resume a session in its original directory.
|
||
|
|
|
||
|
|
| Key | Action |
|
||
|
|
| --- | --- |
|
||
|
|
| Up / Down | Move selection |
|
||
|
|
| Tab | Switch between the current directory and all directories |
|
||
|
|
| Shift-Tab | Cycle agents |
|
||
|
|
| Ctrl-L | Choose a directory |
|
||
|
|
| Ctrl-R | Refresh sessions |
|
||
|
|
| Esc | Clear search, then quit |
|
||
|
|
| Ctrl-C | Quit |
|
||
|
|
|
||
|
|
Directory filtering matches the exact directory, excluding subdirectories.
|
||
|
|
|
||
|
|
Run `cont --help` for all options. See [configuration](docs/configuration.md) for session paths, custom stores and search behaviour.
|
||
|
|
|
||
|
|
## Privacy
|
||
|
|
|
||
|
|
Reads local session stores without uploading conversations or modifying session logs. The cache contains human messages in plaintext under `${XDG_CACHE_HOME:-~/.cache}/cont/`. Use `--no-cache` to disable it, or delete that directory to remove cached text.
|
||
|
|
|
||
|
|
## Development
|
||
|
|
|
||
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for build and test instructions.
|
||
|
|
|
||
|
|
## Credits
|
||
|
|
|
||
|
|
Based on [resume](https://github.com/robertmartin8/resume). Inspired by [fast-resume](https://stanislas.blog/2026/01/tui-index-search-coding-agent-sessions/) and [coding-agent-session-search](https://github.com/dicklesworthstone/coding_agent_session_search).
|
||
|
|
|
||
|
|
[MIT licence](LICENSE).
|