Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add saksham10arora-dotcom/everything-claude-codex --skill catchup -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/catchup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/catchup/

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.

catchup LilMGenius catchup — a skill for Claude Code and Codex that rebuilds lost project context after an absence. It runs from live repository state when you need to decide the next move. CX Codex +1 1,400installs ds-catchup aicodeking ds-catchup — a skill for Claude Code summarizes changes since the last message and lists decisions awaiting the user's input. It runs when someone returns after a long pause or asks what happened. CX Codex +1 540installs feed-catchup readwiseio feed-catchup cleans up your unread Readwise Reader RSS feed, highlights the five best articles, and lets you triage the rest in batches. CX Codex +1 507installs spark-recipe-vacation-catchup readdle spark-recipe-vacation-catchup clears email backlogs after vacations or time off: categorizes unread threads, batch-archives clutter, and flags urgent items. CX Codex +1 334installs obsidian-catchup Eugeniu Ghelbur obsidian-catchup — a command to review everything you dumped into the Telegram journal bot on the go—voice, text, images, PDFs, links—and integrate it into your Obsidian vault with Claude Code when you're back at the laptop. CX Codex +1 ★ 5,412repo stars find-skills vercel-labs find-skills is a Claude Code skill that locates agent skills for a task and helps assess the results. It activates when someone asks for a capability that may already be installable. CX Codex +1 4,400,000installs frontend-design official anthropics The frontend-design skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. CX Codex +1 1,025,790installs agent-browser vercel-labs This Claude Code skill automates browser interaction for tasks like navigating sites, filling forms, and testing web apps. It also supports exploratory QA and Electron app automation. CX Codex +1 1,600,000installs design-taste-frontend Leonxlnx The design-taste-frontend Claude Code skill sets design rules and checks for websites. It activates for new pages, redesigns, and requests to fix a generic-looking site. CX Codex +1 802,600installs

From the same set18

The whole set →
email email is a Claude Code skill that drafts campaign emails and cold outreach, then waits for approval before sending. Once approved, it can send the message or save a draft and record the result. CX Codex +1 ★ 101repo stars outreach outreach is a Claude Code skill that tracks networking pipelines and drafts personalized messages. It activates on requests about outreach, cold emails, or follow-ups. CX Codex +1 ★ 101repo stars ship ship is a Claude Code skill that commits repository changes, pushes the branch, and reports the commit details. It runs on /ship, requests to commit and push, or the end of a work session in a repo. CX Codex +1 ★ 101repo stars wiki wiki is a Claude Code skill that turns incoming notes into an interconnected knowledge base. It processes raw files from the inbox folder into structured Markdown pages. CX Codex +1 ★ 101repo stars boot boot is a Claude Code skill that prepares a session briefing. It runs on /boot or a request for a full update on the project. CX Codex +1 ★ 101repo stars opps opps is a Claude Code skill that structures job and internship pipelines into a ranked status table. It prioritizes upcoming deadlines and outlines weekly action items. CX Codex +1 ★ 101repo stars standup standup is a Claude Code skill that builds a brief update from daily notes and project blockers. It responds to /standup or questions about yesterday’s work, today’s plans, and blockers. CX Codex +1 ★ 101repo stars weekly weekly is a Claude Code skill that turns a week of daily notes and .remember/hot.md into a Sunday review: shipped, slipped, deadlines, one thing to drop. CX Codex +1 ★ 101repo stars

Project sponsors

Companies that keep this analytics open