session-search
For CLI agents WITHOUT subagent support (e.g., Codex CLI). Search previous code agent sessions for specific work, decisions, or code patterns.
Security Assessment
Detected risks:
About session-search
The session-search skill enables CLI agents without subagent support (e.g., Codex CLI) to search through previous code agent sessions, helping users find specific work, decisions, or code patterns. This skill solves the problem of quickly locating relevant information from past sessions to inform ongoing development without manual sifting through numerous files. By automating the search process, users can quickly identify key insights from previous discussions and decisions, enhancing their workflow efficiency and decision-making processes.
The skill operates by querying stored session data using the `aichat search` command, which can be customized with filters like project or date. Once the query is run, the results are parsed and summarized into a concise report, including key findings, relevant sessions, and specific content such as code snippets or decisions made. The output is designed to help users easily review past work and decisions related to specific topics, such as code patterns or architectural designs.
This skill is primarily targeted at developers and software engineers working on projects where multiple sessions are involved, such as large codebases or ongoing software design efforts. It is particularly useful for those needing to recall or analyze past discussions about code architecture, decision-making, or coding practices, without the need for deep, manual investigation of past session files.
FAQ
How do I use the session-search skill?
To use the session-search skill, run the `aichat search` command with the `--json` flag followed by your query. You can filter by project using `-g 'project'` if needed. The command will return a JSONL output that is parsed and summarized into a focused report.
What if I don't have the necessary tools installed?
If the `aichat search` command fails or is not found, install the necessary tools with the following commands: `uv tool install claude-code-tools` (for Python package) `cargo install aichat-search` (for Rust search TUI)
What are the limitations of the session-search skill?
The session-search skill has the following limitations: 1. It can only return results based on observed data from past sessions, without inferring or extrapolating any additional information. 2. No more than 3 session files can be read per query. 3. The output must be a concise summary, not raw JSON.
Can I search for code patterns across multiple projects?
Yes, you can filter by project using the `-g 'project'` flag to search specific projects. If no project filter is provided, it searches across all sessions.
Is this skill compatible with all CLI agents?
No, this skill is designed for use with CLI agents that do not support subagents, such as Codex CLI. If you are using Claude Code, you should instead use the `session-searcher` subagent via the Task tool.
Install session-search
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
pchalasani/claude-code-tools