# 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 and [coding-agent-session-search](https://github.com/dicklesworthstone/coding_agent_session_search).

[MIT licence](LICENSE).