Agent skill

Session Search

by techwolf-ai in techwolf-ai/ai-first-toolkit

Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac.

MITAuto-check passed

Install Session Search

skills CLI
$ npx skills add techwolf-ai/ai-first-toolkit --skill session-search -a claude-code

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

GitHub CLI
$ gh skill install techwolf-ai/ai-first-toolkit session-search --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/techwolf-ai/ai-first-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/session-tools/skills/session-search .claude/skills/session-search && 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
session-search
GitHub stars
132
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
409 words
Files
5 (incl. scripts)
Skills in repo
29
Repo updated
First seen
Licence
MIT

At a glance

Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac.

  • Works in 2 steps: , find candidate sessions → , pull full context from a specific…
  • The user wants to recall something they did before but cant find it
  • SKILL.md covers How to use, Filter reference and Tips
  • Runs Python scripts from its folder

What it does

Session Search is an agent skill from techwolf-ai/ai-first-toolkit. Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac. Use when the user wants to recall something they did before but can't find it , phrasings like "where did I work on X", "find that session where I…", "when did I last do Y", "pull up the conversation about Z", "that time I built/tried/discussed …". Searches by kind (code/cowork), time range, title, working directory, or free-text content across all transcripts.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `scripts/codex_sessions.py`, `scripts/find_sessions.py` and `scripts/host_platform.py`).

The repository describes itself as: Open-source Claude Code skills and Codex skills for AI-first work. Audit, re-engineer, and bootstrap projects with AI-first design principles. The licence is MIT.

When your agent uses it

  • The user wants to recall something they did before but cant find it
  • Phrasings like where did I work on X
  • Find that session where I…
  • Did I last do Y

Example prompts

  • “t find it , phrasings like”
  • “find that session where I…”
  • “when did I last do Y”
  • “/session-search”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. , find candidate sessions
  2. , pull full context from a specific session

What it can do on your machine

Read from SKILL.md and the folder at commit 2ee7841. 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 4 files in scripts/ (Python), which the agent can run.

    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

Session Search loads about 1.1k tokens when it runs. Until then it costs about 117 tokens; SKILL.md has 409 words of instructions outside code blocks.

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

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 techwolf-ai/ai-first-toolkit at commit 2ee7841, republished under its MIT licence (© techwolf-ai). 409 words, ~1,065 tokens.

Download SKILL.mdSave it as .claude/skills/session-search/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
session-search
description
Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac. Use when the user wants to recall something they did before but can't find it , phrasings like "where did I work on X", "find that session where I…", "when did I last do Y", "pull up the conversation about Z", "that time I built/tried/discussed …". Searches by kind (code/cowork), time range, title, working directory, or free-text content across all transcripts.

Platforms: Claude Code / Cowork and Codex. find_sessions.py and show_session.py detect the host (via the platform stamp install.sh writes, or AI_FIRST_PLATFORM) and route to the right store: Claude Code (~/.claude/projects) + Cowork transcripts, or Codex rollouts (~/.codex/sessions/**/rollout-*.jsonl). Both support list, time/cwd/title filters, and full-text --grep. Antigravity is not supported: its IDE conversations are AEAD-encrypted at rest (~/.gemini/antigravity/conversations/*.pb) and its unencrypted CLI store carries no parseable turn content, so the skill prints a clear "not available" message and exits.

Two scripts in scripts/ locate past sessions and dump their content:

  • find_sessions.py , discover + filter sessions (metadata + optional full-text grep).
  • show_session.py , print a single session's conversation (user/assistant turns) in readable form.

Both read directly from disk , no API calls, no auth. They resolve paths from $HOME so they work for any macOS user:

  • Claude Code CLI: ~/.claude/projects/*/\*.jsonl
  • Claude Cowork: ~/Library/Application Support/Claude/local-agent-mode-sessions/*/*/local_*/audit.jsonl (sibling local_*.json holds title/metadata)

How to use

Start narrow, widen if needed. Prefer --grep for content recall; use metadata filters to scope.

Step 1 , find candidate sessions
bash
scripts/find_sessions.py --grep "recruitee logo api"      # content search
scripts/find_sessions.py --title "rippling"              # title substring
scripts/find_sessions.py --cwd "Recruitee"               # Code sessions under matching cwd
scripts/find_sessions.py --since 2026-03-01 --until 2026-03-31
scripts/find_sessions.py --kind cowork -n 30             # 30 most recent Cowork

Combine freely. Output is a table by default; add --json for structured piping.

--grep PATTERN is a regex (case-insensitive). It searches message text inside every transcript and prints 1-2 matching snippets per session along with the session row. Use this when the user remembers a phrase or topic, not a title.

Step 2 , pull full context from a specific session
bash
scripts/show_session.py <path-from-step-1>       # full conversation
scripts/show_session.py <path> --grep "logo"     # only turns mentioning "logo" (with ±1 surrounding turn)
scripts/show_session.py <path> --tail 20         # last 20 turns

The script strips tool calls/results and renders user + assistant text only. Output is markdown-ish; pipe to a pager if long.

Show full SKILL.md (165 more words)Show less

Filter reference

find_sessions.py flags:

  • --kind {code,cowork,all} , default all
  • --since YYYY-MM-DD, --until YYYY-MM-DD , by last-activity mtime
  • --title TEXT , substring, case-insensitive (Cowork uses the stored title; Code uses the first user message)
  • --cwd TEXT , substring match against the working directory recorded in Code transcripts
  • --grep PATTERN , regex across transcript body
  • -n, --limit N , cap results (default 50, 0 = all)
  • --snippets N , how many matching lines to show per session under --grep (default 2)
  • --json , machine-readable output

Tips

  • If the user's description is vague, run --grep with 2–3 alternative phrasings in parallel before narrowing.
  • For Code sessions the "title" is a best-effort extraction of the first user message; for Cowork it comes from the .json sidecar written by the desktop app.
  • A session can have many transcripts (resumes, forks). find_sessions.py lists each transcript separately; that's usually what you want , the most recent one is the live thread.
  • Transcripts can be large (several MB). When dumping content to the user, prefer show_session.py --grep or --tail over the full file.

© techwolf-ai, 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 4 other files (scripts) in plugins/session-tools/skills/session-search of techwolf-ai/ai-first-toolkit.

  • SKILL.md
  • scripts/codex_sessions.py
  • scripts/find_sessions.py
  • scripts/host_platform.py
  • scripts/show_session.py

Open the folder on GitHubat commit 2ee7841

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 techwolf-ai/ai-first-toolkit, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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

Session Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Search this skilltechwolf-ai/ai-first-toolkit1321 repos~1.1kAutomated safety check: PassMIT
Paste Inputsthedaviddias/Front-End-Checklist74k—~443Automated safety check: PassMIT
Setup Coworkasgeirtj/system_prompts_leaks69k—~3kAutomated safety check: PassCC0-1.0
Cowork To Code Bridgesickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT
Coworkerplatonai/Browser41.2k—~3.9kAutomated safety check: PassApache-2.0
Pastecoreyhaines31/makerskills848—~1.7kAutomated safety check: NotesMIT

Similar skills

  • Paste Inputs

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Allow pasting into form inputs.

    74k GitHub stars~443 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Setup Cowork

    asgeirtj/system_prompts_leaks

    Guided Cowork setup — install a matching plugin, try a skill, connect tools.

    69k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Cowork To Code Bridge

    sickn33/agentic-awesome-skills

    Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check passed
  • Coworker

    platonai/Browser4

    Reference for the Coworker file-queue automation system: task lifecycle, directory state machine, PowerShell workers, scheduler configuration, and operational conventions.

    1.2k GitHub stars~3.9k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Paste

    coreyhaines31/makerskills

    When you want to clean and reformat content (usually from your terminal) for pasting into Slack, Notion, Twitter/X, LinkedIn, email, GitHub, or plain text.

    848 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check: notes
  • Performing Paste Site Monitoring For Credentials

    mukul975/Anthropic-Cybersecurity-Skills

    Monitor paste sites like Pastebin and GitHub Gists for leaked credentials, API keys, and sensitive data dumps using automated scraping and keyword matching to detect breaches early.

    34k GitHub stars~3.7k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check: warnings

More from techwolf-ai/ai-first-toolkit

All 29 skills in this repo
  • Task Profile

    techwolf-ai/ai-first-toolkit

    Mine the user's Claude Code + Cowork session history into a structured task profile, what they do with AI, how often, how successfully where friction lives, then propose atomic skills that would…

    132 GitHub stars~3.6k tokensUpdated 9 days ago
    Auto-check passed
  • Token Doctor

    techwolf-ai/ai-first-toolkit

    Personal diagnosis of where your Claude Code + Cowork spend goes.

    132 GitHub stars~4.1k tokensUpdated 9 days ago
    Auto-check passed
  • Write Blog Post

    techwolf-ai/ai-first-toolkit

    Write or develop a blog post. An agent skill from techwolf-ai/ai-first-toolkit.

    132 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Write Opinion

    techwolf-ai/ai-first-toolkit

    Write or develop an opinion piece (opiniestuk/op-ed). An agent skill from techwolf-ai/ai-first-toolkit.

    132 GitHub stars~695 tokensUpdated 9 days ago
    Auto-check passed
  • AI Firstify

    techwolf-ai/ai-first-toolkit

    Analyze, re-engineer, or bootstrap projects to align with AI-first design principles.

    132 GitHub stars~646 tokensUpdated 9 days ago
    Auto-check passed
  • Analyze Performance

    techwolf-ai/ai-first-toolkit

    Analyze engagement patterns across published posts to identify what works.

    132 GitHub starsUsed in 1 repo~689 tokens
    Auto-check passed

Questions about Session Search

What does Session Search do?

Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac. Session Search is an agent skill from techwolf-ai/ai-first-toolkit. Find context from past Claude Code (CLI) and Claude Cowork (desktop) sessions on this Mac.

When should I use Session Search?

Session Search fits situations like: the user wants to recall something they did before but cant find it; phrasings like where did I work on X; find that session where I…; did I last do Y.

How do I install Session Search in Claude Code?

Run `npx skills add techwolf-ai/ai-first-toolkit --skill session-search -a claude-code`. Or copy the skill folder (plugins/session-tools/skills/session-search in techwolf-ai/ai-first-toolkit) into .claude/skills/session-search in your project. Claude Code loads it when a task matches its description.

How do I install Session Search in Codex?

Run `npx skills add techwolf-ai/ai-first-toolkit --skill session-search -a codex`. Or copy the skill folder (plugins/session-tools/skills/session-search in techwolf-ai/ai-first-toolkit) into .agents/skills/session-search in your project. Codex loads it when a task matches its description.

Can I use Session 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 techwolf-ai/ai-first-toolkit --skill session-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/session-search, .gemini/skills/session-search, .github/skills/session-search and .opencode/skills/session-search in your project.

What does Session Search need to run?

Going by SKILL.md and its folder, Session Search needs Python for the scripts in its folder. Our summary lists: Python 3.

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

What licence does Session Search use?

Session Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Search use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Session Search?

Skills that share tags, products or a category with Session Search: Paste Inputs (thedaviddias/Front-End-Checklist, 74k stars), Setup Cowork (asgeirtj/system_prompts_leaks, 69k stars), Cowork To Code Bridge (sickn33/agentic-awesome-skills, 47k stars) and Coworker (platonai/Browser4, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Search?

techwolf-ai (a GitHub organization) maintains it in techwolf-ai/ai-first-toolkit, which has 132 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on September 29, 2026.

Source: techwolf-ai/ai-first-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.