Feature Request: Session Resumption for Claude Code CLI

I guess this is a hidden feature but there are logs of your convos per project in ~/.claude/projects/-Users-<YOUR-USERNAME>-<PATH>-<TO>-<PROJECT>/ there's a bunch of jsonl files i don't know how much of the history it preserves but if you lose something critical hopefully it helps.

Can't you just use continue and resume to do this?

claude --help
Usage: claude [options] [command] [prompt]

Claude Code - starts an interactive session by default, use -p/--print for non-interactive output

Arguments:
  prompt                          Your prompt

Options:
  -d, --debug                     Enable debug mode
  --verbose                       Override verbose mode setting from config
  -p, --print                     Print response and exit (useful for pipes)
  --output-format <format>        Output format (only works with --print): "text" (default), "json" (single result), or "stream-json" (realtime streaming) (choices: "text", "json", "stream-json")
  --mcp-debug                     [DEPRECATED. Use --debug instead] Enable MCP debug mode (shows MCP server errors)
  --dangerously-skip-permissions  Bypass all permission checks. Only works in Docker containers with no internet access.
  --allowedTools <tools...>       Comma or space-separated list of tool names to allow (e.g. "Bash(git:*) Edit Write")
  --disallowedTools <tools...>    Comma or space-separated list of tool names to deny (e.g. "Bash(git:*) Edit Write")
  --mcp-config <file or string>   Load MCP servers from a JSON file or string
  -c, --continue                  Continue the most recent conversation
  -r, --resume [sessionId]        Resume a conversation - provide a session ID or interactively select a conversation to resume
  --model <model>                 Model for the current session. Provide an alias for the latest model (e.g. 'sonnet' or 'opus') or a model's full name (e.g. 'claude-sonnet-4-20250514').
  -v, --version                   Output the version number
  -h, --help                      Display help for command

Commands:
  config                          Manage configuration (eg. claude config set -g theme dark)
  mcp                             Configure and manage MCP servers
  migrate-installer               Migrate from global npm installation to local installation
  doctor                          Check the health of your Claude Code auto-updater
  update                          Check for updates and install if available

oh... yeah, i was assuming OP was talking about some kind of crash that caused the resume-session thing to fail. but if OP doesn't know about -r and -c, yeah that is the way to go.

It sounds like maybe this feature is included and I didn't realize it.

Ironically the first time I experienced a session crash, I re-opened my IDE's terminal invoked Claude-code and asked if there was a way we could resume our previous session.

Claude assured me there was not, lamented that the CLI lacked this feature even though it's available via the Web UI, suggested I open an issue, and helped me write this feature request describing what was missing.

So yea it's on me for not RTFM, but it's also on Claude for assuring me this feature did not exist and it would be valuable feedback for me to escalate this issue to the dev team.

Same, I remember something about --continue but at this pace I never know if I actually heard it or misremembering.

Also asked Claude for the feature, he assured me no such feature exist and pointed me to various issues with feature requests.

Now here I realize that it is indeed existing, so the actual problem is that Claude should RTFM, and probably have it as a tool call.

It says in the system prompt that Claude is not allowed to visit the Anthropic docs site.

I didn't know about this feature until I read it in the CHANGELOG.md file.
Why can't this just also be a slash command inside the claude-code app?
Like /resume or /load-session maybe?

Maybe because it would take dev time to implement something that's basically already available by ending your session and typing claude -r...? What's the difference?

Yep! You want --continue/--resume. Docs: https://docs.anthropic.com/en/docs/claude-code/cli-usage#cli-flags

This works well, thanks!

For enhanced session resumption, #2112 proposes adding --session-name functionality that would make it much easier to identify and resume the correct session after crashes or disconnections.

This would work well with the automatic session state saving requested here - named sessions would be instantly recognizable in the resume picker.

Related session management improvements:

• #1407 - Session ID retrieval
• #1335 - Session identification challenges
• #371 - Original resume feature (implemented)
• #922 - Resume hanging bug (fixed)

The ability to name a conversation is important so I can quickly select it when I want to continue the conversation. I look forward to adding this feature.

The ability to name a conversation is important so I can quickly select it when I want to continue the conversation. I look forward to adding this feature.

Yes, similar to tmux

@DnkNju https://github.com/iannuttall/claude-sessions what do you think? (not my repo i just googled it cuz of your question, has decent star count)

EDIT: Nevermind I don't think this correlates with Claude internal sessions

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.