--resume
A Claude Code CLI flag, read out of the shipped bundle. It has been in the build since v2.1.138, including the newest one read.
What it is
Resume a specific session by ID or name, or show an interactive picker to choose a session. The picker and name search include sessions that added this directory with /add-dir. When you pass a session ID, Claude Code searches the current project directory and its git worktrees, then every other project on this machine. Before v2.1.223, the ID search covered only the current project directory and its git worktrees. [Background sessions](/docs/en/agent-view) appear in the picker marked with bg
Anthropic's own wording. Read off CLI reference, captured 2026-08-28.
Presence across releases
| Releases | Reading | Declared type | Default |
|---|---|---|---|
| 2.1.245 – 2.1.250 5 releases | never mined | — | — |
| 2.1.138 – 2.1.243 95 releases | in the build | — | — |
A row reading never mined is a release with no archived bundle behind it. Nothing was read out of it, so nothing here says whether the name was in it. A declared type or a default is only ever what that release's own bundle stated.
Changelog entries naming it
-
v2.1.246Copyable resume command no longer carries a broken session id
The suggested resume command no longer pastes a broken or undefined session id after the flag.
named in this entry
-
v2.1.239Resume hints no longer point at directories that are gone
You no longer get a resume command suggesting a project directory that no longer exists.
named in this entry
-
v2.1.236
--continueand--resumefailures now say what went wrongA failed --continue or --resume now tells you the error and exits instead of quietly carrying on.
named in this entry
-
v2.1.232Rate-limit checkpoint can commit in-progress work to a hidden git ref
Before a usage limit cuts you off, your work can be committed to a hidden git ref with resume notes.
named in this entry
-
v2.1.232--session-id now works with --continue/--resume under an SDK URL
--session-id now works with --continue or --resume when an SDK URL is supplied.
named in this entry
-
v2.1.232Resuming with an unrecognisable session id now forks instead of resuming
An unparseable --resume session id now forks and replays instead of quietly resuming.
named in this entry
-
v2.1.223New hidden CLI flag --resume-drops-turn
A hidden flag lets you declare which turn a truncating resume is meant to discard.
named in this entry
-
v2.1.223--resume-session-at help text clarified to chain entries
The --resume-session-at help now explains it takes a chain-entry id, not an assistant message id.
named in this entry
-
v2.1.221Memory recall index is prewarmed at startup
Claude warms the memory recall index at startup so your first recall is faster.
named in this entry
Documentation pages
- CLI reference reference table Claude Code CLI
- Rewind file changes with checkpointing mentions it Claude Code CLI
- Agent SDK reference - TypeScript mentions it Claude Code CLI
- Manage multiple agents with agent view mentions it Claude Code CLI
- Best practices for Claude Code mentions it Claude Code CLI
- Claude Code changelog mentions it Claude Code CLI
- Use Claude Code on the web mentions it Claude Code CLI
- Common workflows mentions it Claude Code CLI
- Manage costs effectively mentions it Claude Code CLI
- Desktop application mentions it Claude Code CLI
- Schedule recurring tasks in Claude Code Desktop mentions it Claude Code CLI
- Environment variables mentions it Claude Code CLI
- Error reference mentions it Claude Code CLI
A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the CLI flag does. All CLI flags.