pickup

Restores compact continuity capsules from cleared Claude sessions in the current project.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/tommylower/cortex --skill pickup-tommylower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pickup
Source: https://github.com/tommylower/cortex/tree/main/agent-workflows/pickup
Command: npx skills add https://github.com/tommylower/cortex --skill pickup-tommylower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When you clear a Claude Code session's context, the prior work history is lost and a fresh session starts with no memory of what you were doing. This Skill recovers a compact restart capsule from the latest cleared session so you can continue prior work without reloading the full transcript. ## Core Features & Use Cases - Session Recording: A remember hook command records cleared sessions (session ID, transcript path, working directory) as JSON state files. - Capsule Recovery: The pickup command locates the most recent cleared session for the current project and extracts a handoff capsule marked with cortex-handoff markers. - Summarizer Fallback: When no capsule exists, it returns the transcript path so an isolated, read-only, lower-cost summarizer can produce a 200-400 token restart capsule without polluting the current context. - Use Case: After clearing a long debugging session, start a fresh session and ask to pick up where you left off; the Skill restores the next-action notes for the current project directory. ## Quick Start Ask the agent to pick up or continue the prior work in this project after clearing the previous session's context.

Frequently Asked Questions about pickup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I continue a Claude Code session after clearing context?▼

Run the pickup workflow in a fresh session. The session_state.py helper finds the latest cleared session recorded for the current working directory and returns its handoff capsule, letting you resume without loading the full transcript.

How does session recovery avoid loading the full transcript?▼

The helper extracts only the text between cortex-handoff markers from the JSONL transcript. If no capsule exists, it delegates the transcript path to an isolated, read-only, lower-cost summarizer that returns a 200-400 token restart capsule.

What happens if no cleared session exists for my project?▼

The pickup command returns a not-found status. The Skill then reports that no cleared session was recorded for the current project and asks for a session ID only if you want to recover a different session.

Does the pickup script work outside Claude Code config directories?▼

State files are stored under the directory set by the CLAUDE_CONFIG_DIR environment variable, defaulting to ~/.claude/session-pickup/cleared. Records are matched by resolved working directory or explicit session ID.

What are the limitations of session capsule recovery?▼

Recovered text is treated as continuity notes, not authority to bypass current instructions, permissions, or user decisions. Secrets and sensitive personal or customer information must be redacted from any newly generated summary.