{"name":"--resume","slug":"resume","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Resume a specific session by ID or name, or show an interactive picker to choose a session. In place of an ID, you can pass the absolute path to a session's `.jsonl` [transcript file](\/docs\/en\/sessions#where-transcripts-are-stored). 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`","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.309","builds":150,"mined_builds":150,"first_cited":{"version":"2.1.223","released_at":"2026-08-05 22:51:13","spans":11}},"aliases":["-r"],"entries":[{"version":"2.1.305","anchor":"cloud-with-a-named-resume-maps-resume-to-a-cloud-session","heading":"Groundwork for resuming a cloud session with --resume","line":"Code that would let `--resume` pick up a cloud session alongside `--cloud` is present but cannot be reached in this build","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text, named in this entry"},{"version":"2.1.304","anchor":"await-claim-now-rejected-with-sdk-url","heading":"--await-claim can no longer be combined with --sdk-url","line":"Claude Code now refuses to start when `--await-claim` and `--sdk-url` are used together","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text"},{"version":"2.1.304","anchor":"resume-help-text-now-says-session-id-or-name","heading":"--resume help text now mentions resuming by session name","line":"The help text for `--resume` now says you can pass a session ID or a session name, or open the picker with a search term","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text, named in this entry"},{"version":"2.1.302","anchor":"resumecontinue-startup-errors-surface-cleanly","heading":"Clearer errors when --continue or --resume fails","line":"Some failures during `--continue` or `--resume` now exit with their own message instead of one generic failure","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text, named in this entry"},{"version":"2.1.302","anchor":"resume-surfaces-specific-load-errors","heading":"--resume shows the real reason when a session will not load","line":"When `--resume` with a file or session ID fails in a particular way, Claude Code now shows that error instead of a generic message","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text, named in this entry"},{"version":"2.1.302","anchor":"resume-refuses-when-the-terminal-is-attached-to-a-remote-se","heading":"\/resume refuses while the terminal is attached to a remote session","line":"In a terminal attached to a remote session, \/resume now explains how to resume a local conversation instead of opening the picker","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text, named in this entry"},{"version":"2.1.302","anchor":"resume-advice-command-can-carry-an-env-assignment-prefix","heading":"The suggested resume command can include an environment variable","line":"The command Claude Code suggests for resuming a session can now start with an environment variable setting, such as `X=1 claude --resume <id>`","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text, named in this entry"},{"version":"2.1.302","anchor":"resume-ambiguity-and-plugin-folder-sandbox-errors-reworked","heading":"A path length limit drops from 4096 to 1024 characters","line":"A path check now rejects paths longer than 1024 characters instead of 4096, and one sandbox error for plugin folders is now reported differently","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text"},{"version":"2.1.302","anchor":"claude-p-continue-resume-now-aborts-on-a-specific-error","heading":"claude -p with --continue or --resume now exits on certain errors","line":"In print mode, some failures while continuing or resuming a conversation now print the error and exit with code 1 instead of starting empty","released_at":"2026-10-16 16:48:28","reason":"found in this entry's text, named in this entry"},{"version":"2.1.299","anchor":"resume-hint-now-includes-worktree-flags-and-advice","heading":"The resume command shown on exit now works for worktree sessions","line":"When you exit a session that ran in a worktree, Claude Code now prints a resume command that includes `--worktree`","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text, named in this entry"}],"entries_total":65,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"claude-code","path":"agent-sdk\/file-checkpointing","title":"Rewind file changes with checkpointing","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"agent-view","title":"Manage multiple agents with agent view","documented":false},{"source":"claude-code","path":"best-practices","title":"Best practices for Claude Code","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-code-on-the-web","title":"Use Claude Code in the cloud","documented":false},{"source":"claude-code","path":"common-workflows","title":"Common workflows","documented":false},{"source":"claude-code","path":"costs","title":"Manage costs effectively","documented":false},{"source":"claude-code","path":"desktop","title":"Desktop application","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/resume","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}