Agent skill

Find Session

by fleurytian in fleurytian/awesome-claude-skills

Identify a specific Claude Code conversation by its UUID and optionally pin it as a shell function for one-word resume.

MITAuto-check passed

Install Find Session

skills CLI
$ npx skills add fleurytian/awesome-claude-skills --skill find-session -a claude-code

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

GitHub CLI
$ gh skill install fleurytian/awesome-claude-skills find-session --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/fleurytian/awesome-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/find-session .claude/skills/find-session && 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
find-session
GitHub stars
320
Token cost
~994 tokens
SKILL.md length
469 words
Files
2
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Identify a specific Claude Code conversation by its UUID and optionally pin it as a shell function for one-word resume.

  • Works in 5 steps: Find the encoded-cwd directory → List active session files → Get a unique-content hint from the user → …
  • Claude --continue picks the wrong session
  • SKILL.md covers When to use, Workflow, Important notes and Quick check
  • Calls claude

What it does

Find Session is an agent skill from fleurytian/awesome-claude-skills. Identify a specific Claude Code conversation by its UUID and optionally pin it as a shell function for one-word resume. Use when "claude --continue" picks the wrong session, or when the user wants to reliably resume a specific past conversation across reboots.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

The repository describes itself as: Claude Skills developed for brain-workers. Dev by Fleury, an Ex-McKinsey and now AI product manager. 小红书/RedNote@如宝|AI&Anlalytics. Email me @fleurytian@gmail.com. The licence is MIT.

When your agent uses it

  • Claude --continue picks the wrong session
  • The user wants to reliably resume a specific past conversation across reboots

Example prompts

  • “claude --continue”
  • “/find-session”

Workflow steps

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

  1. Find the encoded-cwd directory
  2. List active session files
  3. Get a unique-content hint from the user
  4. grep to find matching session
  5. Offer to pin as shell function

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • claude

    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

Find Session loads about 994 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 469 words of instructions outside code blocks.

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

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 fleurytian/awesome-claude-skills at commit 4f95967, republished under its MIT licence (© fleurytian). 469 words, ~994 tokens.

Download SKILL.mdSave it as .claude/skills/find-session/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
find-session
description
Identify a specific Claude Code conversation by its UUID and optionally pin it as a shell function for one-word resume. Use when "claude --continue" picks the wrong session, or when the user wants to reliably resume a specific past conversation across reboots.

find-session — pin a specific Claude conversation

claude --continue picks "most recent in cwd" — unreliable when multiple sessions share a directory. claude --resume <uuid> is exact. This skill finds the right UUID by grepping jsonl files, then writes a one-word shell function so the user types e.g. aichain to resume that exact conversation.

When to use

  • User says "I can't find my session" / "claude --continue picks wrong one"
  • User wants a one-word resume command for a specific long-running conversation
  • Multiple .jsonl files in ~/.claude/projects/<encoded-cwd>/ exist

Workflow

1. Find the encoded-cwd directory

Sessions are stored under ~/.claude/projects/<encoded-cwd>/. The encoding replaces / with -, so cwd /Users/foo/Desktop/MyProj becomes -Users-foo-Desktop-MyProj. Often the cwd at session-start was the user's HOME, even if work happened in a subdirectory.

If unsure which encoded-cwd to scan:

bash
ls -dt ~/.claude/projects/*/ | head -5

The most recently modified directory is likely the right one.

2. List active session files
bash
ls -lt ~/.claude/projects/<encoded-cwd>/*.jsonl 2>/dev/null | head -10

Multiple files = multiple sessions. The biggest by size is NOT necessarily the right one — both the current assistant and other parallel sessions can be wrong about that.

3. Get a unique-content hint from the user

Ask: "What's something only this conversation would contain? A specific filename you created, a unique tool you ran, a project name, etc."

Good hints (highly unique):

  • A hostname / URL the conversation generated (e.g. waqvu5.png)
  • A file path that was created by this session (e.g. kimi_research_results)
  • A specific function name written in this session (e.g. compute_factor_scores)
  • A unique error message they remember

Bad hints (too common, will match multiple):

  • Generic words like "Python", "test", "fix"
  • Common library names
4. grep to find matching session
bash
for f in ~/.claude/projects/<encoded-cwd>/*.jsonl; do
  echo "=== $(basename "$f") ==="
  grep -c "<unique-string>" "$f" 2>/dev/null
done

The session with non-zero hits (ideally many hits) is the answer. Confirm with 2-3 different unique strings if the first match is ambiguous.

Show full SKILL.md (187 more words)Show less
5. Offer to pin as shell function

Once UUID is identified, ask user for a short name (e.g. aichain, work, headsup). Then append to ~/.zshrc:

bash
# <project description> — resume specific session
<short-name>() {
  cd "$HOME" && claude --resume "<uuid>"
}

cd "$HOME" matters: sessions are indexed by their starting cwd, so the alias must cd to the same place where the session was originally created (often HOME, even if the actual work touched subdirectories).

After write, tell user to either:

  • Run source ~/.zshrc in current terminal, OR
  • Open a new terminal

Important notes

  • Each .jsonl is the full transcript log of one session. Sizes can mislead; always rely on grep'd content matches, not file size.
  • The UUID is stable forever — once pinned, the alias keeps working across reboots, OS upgrades, even years (assuming the .jsonl isn't deleted).
  • If user has multiple long-running parallel sessions (e.g., two different projects, both started from HOME), each needs its own pin. Repeat the workflow once per session.
  • Don't confuse session UUIDs across different conversations. If two Claude instances both claim the same UUID, at least one is wrong — only grep on actual unique content can verify.

Quick check

After pinning, verify:

bash
source ~/.zshrc && type <short-name>

Should show the function definition.

© fleurytian, 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 1 other file in find-session of fleurytian/awesome-claude-skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 4f95967

Compare with similar skills

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

Find Session compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Find Session this skillfleurytian/awesome-claude-skills320—~994Automated safety check: PassMIT
Modeling Conversion MetricsPostHog/posthog40k—~1.4kAutomated safety check: PassCustom licence
Cost Conversationruvnet/ruflo74k—~407Automated safety check: NotesMIT
Conversation Memorydavila7/claude-code-templates33k4 repos~440Automated safety check: PassMIT
Conversation Archivegarrytan/gbrain31k—~5.6kAutomated safety check: PassMIT
Landing Page Conversion Auditgithub/awesome-copilot40k1 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Official

    Build reusable conversion models — funnel/step conversion rates, drop-off, and time-to-convert — on either PostHog data-warehouse views (HogQL) or an external dbt project.

    40k GitHub stars~1.4k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Cost Conversation

    ruvnet/ruflo

    Per-conversation cost view — list every session in cost-tracking with started-at, message count, top model, and total cost

    74k GitHub stars~407 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes
  • Conversation Memory

    davila7/claude-code-templates

    Persistent memory systems for LLM conversations including short-term, long-term, and entity-based memory Use when: conversation memory, remember, memory persistence, long-term memory, chat history.

    33k GitHub starsUsed in 4 repos~440 tokens
    Agent WorkflowsAuto-check passed
  • Conversation Archive

    garrytan/gbrain

    Import AI-assistant chat exports (ChatGPT, Claude, Perplexity) and agent session transcripts into the brain as one dated page per conversation under conversations/, validate each page against the…

    31k GitHub stars~5.6k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Landing Page Conversion Audit

    github/awesome-copilot

    Official

    Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact.

    40k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed
  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed

More from fleurytian/awesome-claude-skills

  • Us Gov Shutdown Tracker

    fleurytian/awesome-claude-skills

    Track and analyze US government shutdown liquidity impacts by monitoring TGA (Treasury General Account), bank reserves, EFFR, and SOFR data from FRED API.

    320 GitHub stars~2.3k tokensUpdated 5 mo ago
    Auto-check passed
  • Mckinsey Consultant

    fleurytian/awesome-claude-skills

    McKinsey顾问式问题解决系统。从商业问题出发,通过假设驱动的结构化分析方法,生成McKinsey风格研究报告和PPT。融合Problem Solving方法论、MECE原则、Issue Tree拆解、Hypotheses形成、Dummy Page设计、智能数据收集和专业PPT生成能力。

    320 GitHub stars~3.1k tokensUpdated 5 mo ago
    Auto-check passed
  • Mimeng Writing

    fleurytian/awesome-claude-skills

    咪蒙爆款文章写作技巧。适用于需要创作10万+阅读量爆款文章、情感共鸣类内容、故事叙事或社会议题评论时使用。掌握标题制造、开篇设计、情绪调动、金句提炼、故事叙事等核心技巧。

    320 GitHub stars~3.4k tokensUpdated 5 mo ago
    Auto-check passed

Questions about Find Session

What does Find Session do?

Identify a specific Claude Code conversation by its UUID and optionally pin it as a shell function for one-word resume. Find Session is an agent skill from fleurytian/awesome-claude-skills. Identify a specific Claude Code conversation by its UUID and optionally pin it as a shell function for one-word resume.

When should I use Find Session?

Find Session fits situations like: Claude --continue picks the wrong session; the user wants to reliably resume a specific past conversation across reboots.

How do I install Find Session in Claude Code?

Run `npx skills add fleurytian/awesome-claude-skills --skill find-session -a claude-code`. Or copy the skill folder (find-session in fleurytian/awesome-claude-skills) into .claude/skills/find-session in your project. Claude Code loads it when a task matches its description.

How do I install Find Session in Codex?

Run `npx skills add fleurytian/awesome-claude-skills --skill find-session -a codex`. Or copy the skill folder (find-session in fleurytian/awesome-claude-skills) into .agents/skills/find-session in your project. Codex loads it when a task matches its description.

Can I use Find Session 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 fleurytian/awesome-claude-skills --skill find-session -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/find-session, .gemini/skills/find-session, .github/skills/find-session and .opencode/skills/find-session in your project.

What does Find Session need to run?

Going by SKILL.md and its folder, Find Session needs the command-line tools its instructions call (claude).

Does Find Session 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 Find Session 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 Find Session use?

Find Session 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 Find Session use?

About 994 tokens (SKILL.md is roughly 4k 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 Find Session?

Skills that share tags, products or a category with Find Session: Modeling Conversion Metrics (PostHog/posthog, 40k stars), Cost Conversation (ruvnet/ruflo, 74k stars), Conversation Memory (davila7/claude-code-templates, 33k stars) and Conversation Archive (garrytan/gbrain, 31k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Find Session?

fleurytian (a GitHub user) maintains it in fleurytian/awesome-claude-skills, which has 320 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on May 1, 2026.

Source: fleurytian/awesome-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.