ccthread

ccthread is a skill for Claude Code, Codex from jakemarsh/ccthread. It costs 123 tokens per session (967 once invoked), scanned D, original, MIT.

A tool for reading and searching old Claude Code conversations stored on the computer.

In plain words
What is it for?
Use it to find past decisions, commands, values, ports, summaries, or lessons and to extract them for teammates or project documentation.
Why use it?
It helps recover details from earlier sessions without manually opening and scanning every conversation.

Skill for Claude CodeCodex

Part of the ccthread plugin — 1 skill, 2 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/jakemarsh/ccthread/ccthread
Any agent
npx skills add jakemarsh/ccthread --skill ccthread
Clone the repo
git clone --depth 1 https://github.com/jakemarsh/ccthread

Made for: Claude Code, Codex.

Or install ccthread, the plugin that ships this one along with the rest of its 1 skill, 2 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ccthread

README.md
[![agentmods](https://agentmods.dev/badge/skills/jakemarsh/ccthread/ccthread.svg)](https://agentmods.dev/skills/jakemarsh/ccthread/ccthread)
Your own site
<a href="https://agentmods.dev/skills/jakemarsh/ccthread/ccthread"><img src="https://agentmods.dev/badge/skills/jakemarsh/ccthread/ccthread.svg" alt="Measured on agentmods" height="20"></a>
Per session 123 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 967 The whole file, excluding the scripts and references it only reads on demand.
Security scan D 3 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00123 $0.00967
Opus 5 $0.00062 $0.00483
Sonnet 5 $0.00025 $0.00193
Haiku 4.5 $0.00012 $0.00097

Measured 3d ago against content hash 6d84d93202ad, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade D, and why

ccthread scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -fsSL https://raw.githubusercontent.com/jakemarsh/ccthread/main/install.sh | sh # macOS / Linux

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

description: Read, search, and summarize Claude Code conversation history. Use when the user asks to find things discussed in past sessions, review old threads, summarize recent work for teammates, extract learnings into

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -fsSL https://raw.githubusercontent.com/jakemarsh/ccthread/main/install.sh | sh # macOS / Linux
plugin/skills/ccthread/SKILL.md · 81 lines

How it starts

The opening of the file, as written. The whole thing — 81 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ccthread — past-conversation archaeology

You have a CLI tool ccthread available. It reads Claude Code conversation logs from ~/.claude/projects/ and returns clean markdown. Use it whenever the user asks about past work.

Common patterns

Look up something from THIS conversation

ccthread show current                                # read the current session
ccthread search "<what they asked about>" --session current --window 3
ccthread show current --before-last-compact         # "before we compacted, what did you say?"

current resolves to whichever session invoked you — via the CCTHREAD_SESSION_ID env var, the parent claude process's argv, or the plugin's SessionStart hook if argv doesn't carry it. Use it whenever the user says "in our conversation", "before we compacted", "earlier in this session", "what did you just say".

Find a conversation by topic

ccthread find "<keywords>" --limit 10

Read a conversation

ccthread show <id> --page 1 --per-page 50

Paginate with --page 2 etc. Run ccthread info <id> first to see how long it is.

Keyword search with context

ccthread search "<query>" --window 2 --limit 5

Good for "what did we decide about X?" — returns ±2 messages around each hit.

Summarize recent work on a project

ccthread list --project <name> --since 2026-04-01
ccthread show <id>  # for each session you want to dig into

Stats / overview

ccthread stats --project <name> --since <date>

Tool usage for a session

ccthread tools <id>

Tips

  • Session ids can be short (8-char prefix) or full UUIDs. last / latest resolves to the most recent session.
  • --no-thinking hides thinking blocks when they're noise.
  • --tool-details none hides tool outputs entirely (cleanest for summaries); full shows them untruncated.
  • --include-sidechains inlines subagent threads.
  • --json emits structured output when you need to re-process it.
  • Default page size is 50 messages.

Read the full file on GitHub · 81 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 81 lines · 123 tokens per session scan D 6d84d93202ad

Subscribe to this mod's changes

ccthread is a skill published in the GitHub repository jakemarsh/ccthread (1 stars, last pushed 4mo ago), licensed MIT. It adds 123 tokens to every session and 967 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it D with 3 findings (downloads and executes remote code, reads agent configuration directories, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.