Session History Search
slopus/happy
Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.
Search across past conversation sessions, memory files, and project history to recall what was discussed, decided, or built in previous sessions.
MITAuto-check passed
Install Hermes Search
$ npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install AlexAI-MCP/hermes-CCC hermes-search --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hermes-search .claude/skills/hermes-search && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "hermes-search" agent skill from https://github.com/AlexAI-MCP/hermes-CCC/tree/master/skills/hermes-search into .claude/skills/hermes-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-search", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/AlexAI-MCP/hermes-CCC/tree/master/skills/hermes-searchType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install AlexAI-MCP/hermes-CCC hermes-search --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/hermes-search .agents/skills/hermes-search && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "hermes-search" agent skill from https://github.com/AlexAI-MCP/hermes-CCC/tree/master/skills/hermes-search into .agents/skills/hermes-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-search", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install AlexAI-MCP/hermes-CCC hermes-search --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/hermes-search .cursor/skills/hermes-search && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "hermes-search" agent skill from https://github.com/AlexAI-MCP/hermes-CCC/tree/master/skills/hermes-search into .cursor/skills/hermes-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-search", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/AlexAI-MCP/hermes-CCC.git --path skills/hermes-search--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install AlexAI-MCP/hermes-CCC hermes-search --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/hermes-search .gemini/skills/hermes-search && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "hermes-search" agent skill from https://github.com/AlexAI-MCP/hermes-CCC/tree/master/skills/hermes-search into .gemini/skills/hermes-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-search", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install AlexAI-MCP/hermes-CCC hermes-searchInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/hermes-search .github/skills/hermes-search && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "hermes-search" agent skill from https://github.com/AlexAI-MCP/hermes-CCC/tree/master/skills/hermes-search into .github/skills/hermes-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-search", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install AlexAI-MCP/hermes-CCC hermes-search --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/hermes-search .opencode/skills/hermes-search && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "hermes-search" agent skill from https://github.com/AlexAI-MCP/hermes-CCC/tree/master/skills/hermes-search into .opencode/skills/hermes-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hermes-search", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
hermes-search- GitHub stars
- 135
- Token cost
- ~1.5k tokens
- SKILL.md length
- 507 words
- Files
- 1
- Skills in repo
- 44
- Repo updated
- First seen
- Licence
- MIT
At a glance
Search across past conversation sessions, memory files, and project history to recall what was discussed, decided, or built in previous sessions.
- Works in 4 steps: ~/.claude/projects/*/memory/*.md — all… → ~/.claude/history.jsonl — conversation… → Project files under the current working… → …
- SKILL.md covers Invocation, Subcommands, Output Format and What Gets Searched, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Hermes Search is an agent skill from AlexAI-MCP/hermes-CCC. Search across past conversation sessions, memory files, and project history to recall what was discussed, decided, or built in previous sessions.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: Hermes Agent ported to Claude Code Channel — 46 native skills, no OAuth, no external process. The licence is MIT.
Example prompts
- “/hermes-search”
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- ~/.claude/projects/*/memory/*.md — all project memory files
- ~/.claude/history.jsonl — conversation history log (if accessible)
- Project files under the current working directory
- MEMORY.md index
What it can do on your machine
Read from SKILL.md and the folder at commit 8107e89. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Hermes Search loads about 1.5k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 507 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from AlexAI-MCP/hermes-CCC at commit 8107e89, republished under its MIT licence (© AlexAI-MCP). 507 words, ~1,477 tokens.
Download SKILL.mdSave it as
.claude/skills/hermes-search/SKILL.md (or your agent's skills folder).- name
- hermes-search
- description
- Search across past conversation sessions, memory files, and project history to recall what was discussed, decided, or built in previous sessions.
- version
- 1.0.0
- author
- hermes-CCC (ported from Hermes Agent by NousResearch)
- license
- MIT
hermes-search
Search across past conversation sessions, memory files, and project files to recall what was discussed, decided, or built. This skill is the cross-session retrieval complement to hermes-compress, which writes the memory, and hermes-memory, which indexes it.
Invocation
/hermes-search "<query>"
/hermes-search --memory "<query>"
/hermes-search --project "<query>"
/hermes-search --recent <N>Subcommands
/hermes-search "<query>" — Search All Memory
Searches all available memory sources in order:
~/.claude/projects/*/memory/*.md— all project memory files~/.claude/history.jsonl— conversation history log (if accessible)- Project files under the current working directory
MEMORY.mdindex
Returns a unified result list sorted by relevance.
How Claude executes this:
# Memory files
grep -r --include="*.md" -l "<query>" ~/.claude/projects/*/memory/
# Within matched files, extract surrounding context
grep -n -A 3 -B 3 "<query>" <matched-file>
# Project files (from cwd)
grep -r --include="*.md" --include="*.py" --include="*.ts" \
--include="*.json" -l "<query>" .
# history.jsonl (if present)
grep "<query>" ~/.claude/history.jsonl | head -20/hermes-search --memory "<query>" — Memory Files Only
Restricts search to ~/.claude/projects/*/memory/*.md. Faster and more focused. Use this when you know the information was captured in a previous session via hermes-compress or hermes-memory.
How Claude executes this:
grep -r --include="*.md" -n -A 3 -B 3 "<query>" \
~/.claude/projects/*/memory/Returns: file path, line number, and 3 lines of surrounding context per match.
/hermes-search --project "<query>" — Project Files Only
Restricts search to the current working directory. Useful for recalling where a piece of code or config lives.
How Claude executes this:
grep -r --include="*.md" --include="*.py" --include="*.ts" \
--include="*.js" --include="*.json" --include="*.yaml" \
-n -l "<query>" .Claude then reads the top 3 matched files and extracts the relevant sections.
/hermes-search --recent <N> — Recent N Sessions Summary
Lists and summarizes the most recent N session memory files.
How Claude executes this:
ls -t ~/.claude/projects/*/memory/session_*.md | head -<N>Claude reads each file and produces a one-line summary per session:
[date] [project] — <top decision or artifact from that session>
Output Format
All subcommands return results in the following structure:
## Search Results: "<query>"
Source: --memory | --project | all
Query time: <timestamp>
### Match 1
- Source: ~/.claude/projects/ontology/memory/session_20260321_1430.md (line 47)
- Relevance: high
- Snippet:
> decisions:
> - "Use Neo4j as primary graph store for ontology nodes" ← MATCH
> - "REST API over gRPC for external integrations"
### Match 2
- Source: ./AlexAI/api/routes.py (line 12)
- Relevance: medium
- Snippet:
> # Neo4j connection pool config ← MATCH
> driver = GraphDatabase.driver(uri, auth=(user, pw), max_connection_pool_size=20)
---
Total matches: 2 | Searched: 14 filesRelevance scoring (heuristic):
- High: exact phrase match in a
decisionsorfacts_learnedblock - Medium: keyword match in a session file body or code comment
- Low: keyword match in a filename or metadata field
What Gets Searched
| Source | Path pattern | Format |
|---|---|---|
| Session summaries | ~/.claude/projects/*/memory/session_*.md | YAML/Markdown |
| Memory index | ~/.claude/projects/*/memory/MEMORY.md | Markdown |
| Honcho profiles | ~/.claude/projects/*/memory/user_honcho_profile.md | YAML/Markdown |
| Project source files | ./**/*.{md,py,ts,js,json,yaml} | Any |
| History log | ~/.claude/history.jsonl | JSONL (if accessible) |
Show full SKILL.md (217 more words)Show less
Handling Missing Sources
- If
~/.claude/history.jsonldoes not exist or is not readable, Claude skips it and notes: "history.jsonl not accessible — searching memory files only." - If no memory files exist, Claude reports: "No memory files found. Run
/hermes-compressafter a session to start building memory." - If project files return too many matches (>50), Claude limits output to the top 10 by file modification date (most recent first).
Relationship to Hermes FTS5 Session Search
This skill is the Claude Code equivalent of Hermes Agent's full-text search over its SQLite session store (using SQLite FTS5). In Hermes, /search <query> performs a ranked FTS5 query over all session message content. In hermes-CCC, the equivalent is grep-based search over the Markdown memory files written by hermes-compress. The result schema (source, relevance, snippet) mirrors the Hermes search output contract.
For projects that generate large volumes of session memory, consider building a local SQLite FTS5 index over the memory files using the hermes-memory skill's index-build subcommand.
Notes
- Search is case-insensitive by default. Add
--case-sensitiveflag to override. - Queries containing spaces should be quoted:
/hermes-search "Neo4j connection pool". /hermes-searchdoes not modify any files. It is always read-only.- Results are printed to the conversation; they are not automatically written to memory. If a search result is important, follow up with
/hermes-memory addto pin it.
© AlexAI-MCP, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/hermes-search of AlexAI-MCP/hermes-CCC.
Open the folder on GitHubat commit 8107e89
Compare with similar skills
Hermes Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Hermes Search this skillAlexAI-MCP/hermes-CCC | 135 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Session History Searchslopus/happy | 24k | — | ~3.1k | Automated safety check: Pass | MIT | |
| Hermes Importsaffaan-m/ECC | 276k | — | ~324 | Automated safety check: Pass | MIT | |
| Session Handoffsickn33/agentic-awesome-skills | 47k | — | ~1.8k | Automated safety check: Notes | MIT | |
| Coding Agent Session Findercode-yeongyu/oh-my-openagent | 70k | — | ~2.8k | Automated safety check: Pass | Custom licence | |
| Session Persistruvnet/ruflo | 74k | — | ~415 | Automated safety check: Notes | MIT |
Similar skills
Hermes Imports
affaan-m/ECC
将本地 Hermes 操作员工作流转换为经过清理的 ECC 技能和发布包工件。在准备将 Hermes 工作流用于公共 ECC 重用而不泄露私有工作区状态、凭据或仅本地路径时使用。
Session Handoff
sickn33/agentic-awesome-skills
A skill your agent uses when context approaches capacity, before /clear or /compact, when switching tasks, or when ending a coding session: produces a structured handoff artifact for the next session.
Coding Agent Session Finder
code-yeongyu/oh-my-openagent
Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.
Session Persist
ruvnet/ruflo
Persist and restore agent sessions across conversations with state snapshots
- Official
Session
anthropics/claude-for-legal
Run a focused N-question study session on a subject — MBE, essay, or flashcards.
More from AlexAI-MCP/hermes-CCC
All 44 skills in this repoGitHub Code Review
AlexAI-MCP/hermes-CCC
Review GitHub pull requests with a findings-first engineering mindset.
GitHub PR Workflow
AlexAI-MCP/hermes-CCC
Run a disciplined GitHub pull request workflow from branch creation through merge.
Hermes Memory
AlexAI-MCP/hermes-CCC
Manage durable project memory for Claude Code. An agent skill from AlexAI-MCP/hermes-CCC.
Hermes Route
AlexAI-MCP/hermes-CCC
Route Claude Code work by complexity, risk, and tool needs. An agent skill from AlexAI-MCP/hermes-CCC.
Hermes Skill
AlexAI-MCP/hermes-CCC
Create, improve, inventory, and audit Claude Code skills. An agent skill from AlexAI-MCP/hermes-CCC.
Hermes Traj
AlexAI-MCP/hermes-CCC
Capture Claude Code interaction trajectories in training-friendly formats.
Questions about Hermes Search
What does Hermes Search do?
Search across past conversation sessions, memory files, and project history to recall what was discussed, decided, or built in previous sessions. Hermes Search is an agent skill from AlexAI-MCP/hermes-CCC. Search across past conversation sessions, memory files, and project history to recall what was discussed, decided, or built in previous sessions.
How do I install Hermes Search in Claude Code?
Run `npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a claude-code`. Or copy the skill folder (skills/hermes-search in AlexAI-MCP/hermes-CCC) into .claude/skills/hermes-search in your project. Claude Code loads it when a task matches its description.
How do I install Hermes Search in Codex?
Run `npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a codex`. Or copy the skill folder (skills/hermes-search in AlexAI-MCP/hermes-CCC) into .agents/skills/hermes-search in your project. Codex loads it when a task matches its description.
Can I use Hermes Search in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AlexAI-MCP/hermes-CCC --skill hermes-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hermes-search, .gemini/skills/hermes-search, .github/skills/hermes-search and .opencode/skills/hermes-search in your project.
What does Hermes Search need to run?
SKILL.md names no scripts, command-line tools or credentials: Hermes Search is instructions for the agent only.
Does Hermes Search access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Hermes Search safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Hermes Search use?
Hermes Search is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Hermes Search use?
About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Hermes Search?
Skills that share tags, products or a category with Hermes Search: Session History Search (slopus/happy, 24k stars), Hermes Imports (affaan-m/ECC, 276k stars), Session Handoff (sickn33/agentic-awesome-skills, 47k stars) and Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Hermes Search?
AlexAI-MCP (a GitHub user) maintains it in AlexAI-MCP/hermes-CCC, which has 135 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on April 8, 2026.
Source: AlexAI-MCP/hermes-CCC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.