Agent skill

Recall

by meain in meain/dotfiles

Search past Claude Code and Codex sessions. An agent skill from meain/dotfiles.

MITAuto-check passed

Install Recall

skills CLI
$ npx skills add meain/dotfiles --skill recall -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install meain/dotfiles recall --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/.agents/skills/recall .claude/skills/recall && rm -rf skills-src

Use ~/.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/

Facts

Skill name
recall
GitHub stars
285
Used in
1 other repo
Token cost
~684 tokens
SKILL.md length
158 words
Files
7 (incl. scripts)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Search past Claude Code and Codex sessions. An agent skill from meain/dotfiles.

  • SKILL.md covers Usage, Examples, Query Syntax (FTS5) and After Finding a Match, plus 1 more section
  • Runs Python scripts from its folder; calls python3, claude and codex

What it does

Recall is an agent skill from meain/dotfiles. Search past Claude Code and Codex sessions. Triggers: /recall, "search old conversations", "find a past session", "recall a previous conversation", "search session history", "what did we discuss", "remember when we"

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `CHANGELOG.md`, `README.md` and `scripts/read_session.py`).

The repository describes itself as: If there is a shell, there is a way! The licence is MIT.

Example prompts

  • “search old conversations”
  • “find a past session”
  • “recall a previous conversation”
  • “/recall”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit f469fb6. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • claude
    • codex

    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

Recall loads about 684 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 158 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~684

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); the scripts in this folder are not scanned.

SKILL.md

The full file from meain/dotfiles at commit f469fb6, republished under its MIT licence (© meain). 158 words, ~684 tokens.

Download SKILL.mdSave it as .claude/skills/recall/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
recall
description
Search past Claude Code and Codex sessions. Triggers: /recall, "search old conversations", "find a past session", "recall a previous conversation", "search session history", "what did we discuss", "remember when we"
metadata.author
arjunkmrm
metadata.version
0.2.2
metadata.license
MIT

/recall — Search Past Claude & Codex Sessions

Search all past Claude Code and Codex sessions using full-text search with BM25 ranking.

Usage

bash
python3 ~/.claude/skills/recall/scripts/recall.py QUERY [--project PATH] [--days N] [--source claude|codex] [--limit N] [--reindex]

Examples

bash
# Simple keyword search
python3 ~/.claude/skills/recall/scripts/recall.py "bufferStore"

# Phrase search (exact match)
python3 ~/.claude/skills/recall/scripts/recall.py '"ACP protocol"'

# Boolean query
python3 ~/.claude/skills/recall/scripts/recall.py "rust AND async"

# Prefix search
python3 ~/.claude/skills/recall/scripts/recall.py "buffer*"

# Filter by project and recency
python3 ~/.claude/skills/recall/scripts/recall.py "state machine" --project ~/my-project --days 7

# Search only Claude Code sessions
python3 ~/.claude/skills/recall/scripts/recall.py "buffer" --source claude

# Search only Codex sessions
python3 ~/.claude/skills/recall/scripts/recall.py "buffer" --source codex

# Force reindex
python3 ~/.claude/skills/recall/scripts/recall.py --reindex "test"

Query Syntax (FTS5)

  • Words: bufferStore — matches stemmed variants (e.g., "discussing" matches "discuss")
  • Phrases: "ACP protocol" — exact phrase match
  • Boolean: rust AND async, tauri OR electron, NOT deprecated
  • Prefix: buffer* — matches bufferStore, bufferMap, etc.
  • Combined: "state machine" AND test

After Finding a Match

To resume a session, cd into the project directory and use the appropriate command:

bash
# Claude Code sessions [claude]
cd /path/to/project
claude --resume SESSION_ID

# Codex sessions [codex]
cd /path/to/project
codex resume SESSION_ID

Each result includes a File: path. Use it to read the raw transcript (auto-detects format):

bash
python3 ~/.claude/skills/recall/scripts/read_session.py <File-path-from-result>

If results are missing File: paths, run --reindex to backfill.

Notes

  • Index is stored at ~/.recall.db (SQLite FTS5, auto-migrated from ~/.claude/recall.db)
  • Indexes both ~/.claude/projects/ (Claude Code) and ~/.codex/sessions/ (Codex)
  • First run indexes all sessions (a few seconds); subsequent runs are incremental
  • Only user and assistant messages are indexed (tool calls, thinking blocks, state snapshots skipped)
  • Results show [claude] or [codex] tags to indicate the source

© meain, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts) in agents/.agents/skills/recall of meain/dotfiles.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • LICENSE
  • README.md
  • scripts/read_session.py
  • scripts/recall.py

Open the folder on GitHubat commit f469fb6

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in meain/dotfiles, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Recall 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.

Recall compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Recall this skillmeain/dotfiles2851 repos~684Automated safety check: PassMIT
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT
Session Handoffsickn33/agentic-awesome-skills47k—~1.8kAutomated safety check: NotesMIT
Coding Agent Session Findercode-yeongyu/oh-my-openagent70k1 repos~2.8kAutomated safety check: PassCustom licence
Agentmemory Recallrohitg00/agentmemory29k—~557Automated safety check: PassApache-2.0
Sessionanthropics/claude-for-legal9.6k3 repos~478Automated safety check: PassApache-2.0

Similar skills

  • 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.

    24k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • 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.

    47k GitHub stars~1.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • 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.

    70k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Agentmemory Recall

    rohitg00/agentmemory

    Searches agentmemory for past observations, sessions and learnings with hybrid keyword, vector and graph search, and reports only what comes back.

    29k GitHub stars~557 tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Session

    anthropics/claude-for-legal

    Official

    Run a focused N-question study session on a subject — MBE, essay, or flashcards.

    9.6k GitHub starsUsed in 3 repos~478 tokens
    EducationAuto-check passed
  • Session Handoff

    davila7/claude-code-templates

    Creates comprehensive handoff documents for seamless AI agent session transfers.

    32k GitHub starsUsed in 2 repos~1.6k tokens
    Agent WorkflowsAuto-check passed

More from meain/dotfiles

All 36 skills in this repo
  • Grill With Docs

    meain/dotfiles

    Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.

    285 GitHub starsUsed in 21 repos~875 tokens
    Auto-check passed
  • Backlog

    meain/dotfiles

    Daily backlog management — full planning review OR add a single entry from a URL.

    285 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check passed
  • Concern Review

    meain/dotfiles

    Generate an interactive local HTML review page for a large PR or diff, grouping the changed files by logical concern (not just by file) so a reviewer can go through one theme at a time instead of a…

    285 GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • My Weekly Report

    meain/dotfiles

    Generate a concise weekly status update in team format. An agent skill from meain/dotfiles.

    285 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Web Search

    meain/dotfiles

    Search the web using lynx and DuckDuckGo. An agent skill from meain/dotfiles.

    285 GitHub stars~830 tokensUpdated 1 mo ago
    Auto-check passed
  • Codebase Query

    meain/dotfiles

    Query and analyze codebases semantically using codebase-memory-mcp graph database.

    285 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Recall

What does Recall do?

Search past Claude Code and Codex sessions. An agent skill from meain/dotfiles. Recall is an agent skill from meain/dotfiles. Search past Claude Code and Codex sessions.

How do I install Recall in Claude Code?

Run `npx skills add meain/dotfiles --skill recall -a claude-code`. Or copy the skill folder (agents/.agents/skills/recall in meain/dotfiles) into .claude/skills/recall in your project. Claude Code loads it when a task matches its description.

How do I install Recall in Codex?

Run `npx skills add meain/dotfiles --skill recall -a codex`. Or copy the skill folder (agents/.agents/skills/recall in meain/dotfiles) into .agents/skills/recall in your project. Codex loads it when a task matches its description.

Can I use Recall 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 meain/dotfiles --skill recall -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/recall, .gemini/skills/recall, .github/skills/recall and .opencode/skills/recall in your project.

What does Recall need to run?

Going by SKILL.md and its folder, Recall needs Python for the scripts in its folder and the command-line tools its instructions call (python3, claude and codex). Our summary lists: Python 3.

Does Recall 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 Recall 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Recall use?

Recall is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Recall use?

About 684 tokens (SKILL.md is roughly 2.7k 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 Recall?

Skills that share tags, products or a category with Recall: Session History Search (slopus/happy, 24k stars), Session Handoff (sickn33/agentic-awesome-skills, 47k stars), Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars) and Agentmemory Recall (rohitg00/agentmemory, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Recall?

meain (a GitHub user) maintains it in meain/dotfiles, which has 285 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 5, 2026.

Source: meain/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.