How to Recover Crashed Claude Code Sessions in Under 30 Seconds (2026)
You had 6 Claude Code sessions doing work. Terminal crashed. Now what?
If you just relaunch the terminal, you get 6 empty tabs. All the context — the files each session was editing, the prompts you gave, the mid-flow work — is gone. This post is about the setup that avoids that.
The problem, in three parts
- Terminal apps don't remember per-tab working directory across crashes.
- Claude Code sessions have their own history file per session, but you don't know which was which.
- Even if you resume all 6, you don't know which was the one working on the auth bug vs the payment refactor.
The recovery pattern
1. Named per-project sessions
Assign a color and name to each Claude Code session by project. When you relaunch, you know at a glance which tile was doing what.
2. Auto-cd on relaunch
Each tile should re-enter its working directory automatically. This alone saves 15-20 seconds per session.
3. Claude Code resume
claude --resume <session-id> restores full context. But you need to know which session-id belongs to which project.
4. Tile manager that tracks all three
The manager should remember: name, color, cwd, session-id for each tile. On relaunch, restore all four for every tile in one action.
What Agent Desk does
Agent Desk on macOS keeps this state per tile. When you relaunch after a crash:
- Every tile comes back in its own named panel with its color
- Each panel re-cds to its project directory
- Each panel resumes its Claude Code session (full context)
Total recovery time: ~15-30 seconds, not the 5-10 minutes it takes to manually rebuild.
The one-time setup
- Install Agent Desk.
- For each project, drag a Claude Code session into a new panel and name it.
- That's it. Crash-recovery is automatic from then on.
$10 once, full source ships with it, no subscription.
Agent TilePractical guides for running many Claude Code sessions in parallel on macOS — orchestration, review workflows, and staying sane with a fleet of AI coding agents.
Get Agent Tile — full source, $10 once →
- IT-QA — Technical Q&A with AI-assisted answers and point bounties — for the questions that come up while you're running a fleet.