coding_agent_session_search
bydicklesworthstone· 102 skills
Coding Agent Session Search - unified CLI/TUI to index and search local coding agent history from Claude Code, Codex, Gemini, Cursor, Aider, ChatGPT, Pi-Agent, Factory, and more. Purpose-built for AI agent consumption with robot mode.
How to install coding_agent_session_search?
dicklesworthstone/coding_agent_session_search
$npx -y skills add dicklesworthstone/coding_agent_session_search --skill coding_agent_session_searchInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/dicklesworthstone/coding_agent_session_search" --skill "dicklesworthstone/coding_agent_session_search"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/dicklesworthstone/coding_agent_session_search" that are relevant to the current task. Run `npx skills add "https://github.com/dicklesworthstone/coding_agent_session_search"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | # 🔎 coding-agent-search (cass) |
| 2 | |
| 3 | <div align="center"> |
| 4 | <img src="docs/assets/images/cass_illustration.webp" alt="coding-agent-search (cass) illustration"> |
| 5 | </div> |
| 6 | |
| 7 |  |
| 8 |  |
| 9 |  |
| 10 | [](https://codecov.io/gh/Dicklesworthstone/coding_agent_session_search) |
| 11 |  |
| 12 | |
| 13 | **Unified, high-performance TUI to index and search your local coding agent history.** |
| 14 | Aggregates sessions from Codex, Claude Code, Gemini CLI, Cline, OpenCode, Amp, Cursor, ChatGPT, Aider, Pi-Agent, GitHub Copilot Chat, Copilot CLI, OpenClaw, Clawdbot, Vibe, Crush, Hermes, Kimi Code, Qwen Code, Factory (Droid), and Grok Build into a single, searchable timeline. |
| 15 | |
| 16 | <div align="center"> |
| 17 | |
| 18 | ```bash |
| 19 | curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.sh?$(date +%s)" \ |
| 20 | | bash -s -- --easy-mode --verify |
| 21 | ``` |
| 22 | |
| 23 | ```powershell |
| 24 | # Windows (PowerShell) |
| 25 | & ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.ps1"))) -EasyMode -Verify |
| 26 | ``` |
| 27 | |
| 28 | Installs the latest release by default. Pass `--version <tag>` / `-Version <tag>` to pin a specific version. |
| 29 | |
| 30 | **Or via package managers:** |
| 31 | |
| 32 | ```bash |
| 33 | # Homebrew (Apple Silicon macOS + Linux) |
| 34 | brew install dicklesworthstone/tap/cass |
| 35 | |
| 36 | # Windows (Scoop) |
| 37 | scoop bucket add dicklesworthstone https://github.com/Dicklesworthstone/scoop-bucket |
| 38 | scoop install dicklesworthstone/cass |
| 39 | ``` |
| 40 | |
| 41 | Homebrew bottles are currently published for Linux and Apple Silicon macOS. On Intel macOS, use the install script with `--from-source`. |
| 42 | |
| 43 | </div> |
| 44 | |
| 45 | --- |
| 46 | |
| 47 | ## 🤖 Agent Quickstart (Robot Mode) |
| 48 | |
| 49 | ⚠️ **Never run bare `cass` in an agent context** — it launches the interactive TUI. Always use `--robot` or `--json`. |
| 50 | |
| 51 | ```bash |
| 52 | # 1) One-shot agent triage. Follow next_command when present. |
| 53 | cass triage --json |
| 54 | # From zero context, `cass --json` and `cass --robot` also resolve to triage. |
| 55 | |
| 56 | # 2) Search across all agent history. Default search is hybrid-preferred: |
| 57 | # lexical is the fast required path; semantic refinement joins when ready. |
| 58 | cass search "authentication error" --robot --limit 5 --fields minimal |
| 59 | |
| 60 | # 3) Find the current or recent session for this workspace |
| 61 | cass sessions --current --json |
| 62 | cass sessions --workspace "$(pwd)" --json --limit 5 |
| 63 | |
| 64 | # 4) View + expand a hit (use source_path/line_number from search output) |
| 65 | cass view /path/to/session.jsonl -n 42 --json |
| 66 | cass expand /path/to/session.jsonl -n 42 -C 3 --json |
| 67 | |
| 68 | # 5) Discover the full machine API |
| 69 | cass capabilities --json |
| 70 | cass robot-docs guide |
| 71 | cass robot-docs schemas |
| 72 | |
| 73 | # 6) Exclude a noisy agent harness from future indexing |
| 74 | cass sources agents list --json |
| 75 | cass sources agents exclude openclaw |
| 76 | cass sources agents include openclaw |
| 77 | ``` |
| 78 | |
| 79 | **Output conventions** |
| 80 | - stdout = data only |
| 81 | - stderr = diagnostics |
| 82 | - exit 0 = success |
| 83 | |
| 84 | **Search asset contract** |
| 85 | - SQLite is the source of truth for indexed conversations and messages. All derived assets (lexical index, semantic vectors, analytics rollups, retention backups) can be rebuilt from SQLite; no derived asset is authoritative. |
| 86 | - Lexical search is the required fast path. Missing, stale, or incompatible lexical assets are treated as derived-state problems that cass should rebuild from SQLite instead of asking operators to perform routine manual repair. |
| 87 | - Hybrid is the default search intent. Robot metadata (`--robot --robot-meta`) reports the requested mode, realized mode, semantic refinement status, and any lexical fallback reason when semantic assets are not ready. |
| 88 | - Semantic assets are opportunistic background enrichment. Lexical-only results are expected during first indexing, semantic catch-up, dis |
Related
6 picksType
- handoffCompact the current conversation into a handoff document for another agent to pick up.Jul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing…Jul 2026
- lark-eventLark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM…Jul 2026
- lark-vc-agent飞书视频会议会中能力：用于让应用机器人真实加入或离开正在进行的会议，并读取当前身份可见的会中事件、发送会中文本消息或会中表情。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容，或需要发现当前可读的进行中会议 ID。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询，这些使用 lark-vc 技能。Jul 2026
- ask-mattAsk which skill or flow fits your situation. A router over the skills in this repo.Jul 2026
- paperclip-create-agentCreate new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft…Jul 2026
