catchup · saksham10arora-dotcom — Claude Code skill: session history and installation
catchup is a Claude Code skill that reads a full transcript from another terminal or Code-tab session. It activates when a request refers to prior work or asks to resume another session.
MIT ★ 101 updated 2026-11-11
npx skills add saksham10arora-dotcom/everything-claude-codex --skill catchup -a claude-codeWhat catchup does
catchup reads another Claude Code session transcript from local storage, then recaps decisions, unfinished work, and sent or committed items. Its script skips the active session.
Both Claude Code surfaces must use the same folder, and python3 is required. With no argument, the script reads the latest session; list displays a table, a number selects that many sessions, and all reads every past session and can produce a large output. Local files are inaccessible from plain Claude.ai chats and cloud sessions.
What it helps with
- carry context from a terminal session into Claude Code
- find out what happened in another session
- recover open tasks and decisions from prior work
Example prompts for the agent
- /catchup
- Read my latest session and tell me where I left off.
- Find sessions that mention
auth.
How to install catchup
1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill catchup -a claude-code2Manually: put the files in place
~/.claude/skills/catchup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/catchup/
1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill catchup -a codex2Manually: put the files in place
.agents/skills/catchup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill catchup -a cursor2Manually: put the files in place
.cursor/skills/catchup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install saksham10arora-dotcom/everything-claude-codex skills/catchup2Manually: put the files in place
.github/skills/catchup/SKILL.md1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill catchup -a gemini-cli2Platform CLI
gemini skills install https://github.com/saksham10arora-dotcom/everything-claude-codex --path skills/catchupManually: put the files in place
.devin/skills/catchup/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about catchup
How do I install catchup in Claude Code?
Run npx skills add saksham10arora-dotcom/everything-claude-codex --skill catchup -a claude-code. The skill file is at ~/.claude/skills/catchup/SKILL.md.
What does catchup do?
It reads the complete transcript of another Claude Code session and recaps its decisions, unfinished work, and sent items.
What does catchup need to read another session?
Both Claude Code surfaces must use the same folder, and the local system needs python3. Plain Claude.ai chats and cloud sessions cannot access local files.
Source text
SKILL.md · MIT
--- name: catchup description: Use when the user says "/catchup", "catch up", "what did I do in the other session", "read my last session", "continue from the app", "continue from terminal", or wants this Claude to read the full conversation history from another Claude Code surface (terminal <-> desktop Code tab) --- # CATCHUP: cross-surface conversation continuity Two Claude Code surfaces (terminal CLI and the desktop "Code" tab) do NOT share live memory, but they both write full session transcripts to the same folder on disk. This skill reads those transcripts back in FULL (not a summary) so the current Claude can see exactly what happened in the other surface. Works both directions, as long as both surfaces opened the SAME vault folder. Does NOT work in plain claude.ai chat or cloud sessions (no local file access). ## Step 1: Run the reader Pass the user's argument straight through. No argument means "latest". ```bash python3 ~/.claude/skills/catchup/catchup.py <ARG> ``` Argument mapping: - (none) / "latest" -> most recent OTHER session, full text - a number N -> last N other sessions, full text - "all" -> every past session (warn it is heavy before running) - "list" -> just a table of recent sessions, no bodies - any other word -> sessions mentioning that keyword The script auto-excludes the live/current session, so it never reads itself. ## Step 2: Absorb and orient Read the full output. Treat it as real context: it is the user's own prior conversation. Pull out what matters: decisions made, things drafted or sent, open threads, anything unfinished. ## Step 3: Brief the user Output a short recap of the other session(s): --- **Caught up from [date] session ([N] messages)** - What happened: [1-3 bullets] - Left unfinished: [anything open] - Sent / shipped: [emails, commits, pushes: flag if not logged to the vault] **Where do you want to pick up?** --- ## Rules - Full fidelity by default. If the user wants everything, use `all` and accept the cost. - If the other session SENT an email or pushed code but never logged it to `personal/outreach/sent_log.md` or `.remember/hot.md`, flag that gap and offer to log it. - Never invent what happened in the other session: only report what the transcript shows. - If no other session exists yet, say so plainly.
© saksham10arora-dotcom · MIT · saksham10arora-dotcom/everything-claude-codex
Similar skills
SKILL.md skills catalog →catchup by other authors comes first.