ctx-agent-history-searchlisted
Install: claude install-skill tanuuuuuuu/dotfiles
# ctx Agent History Search
Use ctx whenever you need to reference previous coding-agent sessions. Those
transcripts can contain user intent, decisions, previous work timelines, past
attempts, and what worked or failed.
Use this skill in two modes:
- retrieval before work, when prior sessions may contain decisions, commands,
failures, or source citations that affect the current task;
- history research reports, when the user asks an agent or read-only subagent to
research a historical topic across prior local agent sessions.
## Prerequisites
- Require the `ctx` CLI to be installed and set up. If it is missing and
installing tools is appropriate for the task, install it with:
```bash
curl -fsSL https://ctx.rs/install | sh
```
- First setup can take time while ctx indexes past sessions. If needed, keep it
running in the background or in tmux, or wait for it to finish.
- If ctx remains unavailable, say local history search is unavailable and do not
invent results.
## Workflow
1. Confirm ctx is ready when starting from a cold context:
```bash
ctx status
ctx sources
```
Use `ctx status --json` or `ctx sources --json` only when a script needs
exact fields.
2. Search with normal language first. Add terms or filters when useful:
```bash
ctx search "<query>"
ctx search "<query>" --refresh off
ctx search "<query>" --provider codex
ctx search "<query>" --workspace <workspace>
ctx search "<query>" --file <path>
ctx search