Docs
FAQ
Answers about claude agents, session deletion, safety, SSH and tmux, Pause versus Close, privacy, pnpm, platforms and Docker.
ResumerAgent’s source code isn’t public yet. These pages describe how it works once it is.
What does ResumerAgent do that claude agents doesn’t?
claude agents shows only live sessions. ResumerAgent also finds every dead one by scanning the transcript .jsonl files on disk, lists them together with the live ones, and resumes any of them in one click.
Does it stop Claude Code from deleting old sessions?
No. The expiry badge only warns you. Claude Code runs its own cleanupPeriodDays cleanup at claude startup, outside ResumerAgent’s process, and ResumerAgent can’t intercept or delay it.
Is it safe to click Resume, Attach or Purge on the wrong row?
ResumerAgent refuses any action when it can’t confirm whether a session is live, and the server re-checks each session’s state instead of trusting the click. It won’t stop you purging a session you didn’t mean to, though: Purge does what you tell it. See Safety.
Does it work over SSH or inside tmux?
Resume and Attach open a local terminal window. Over SSH or in tmux, use the copy button on the session row instead. It puts the same resume command on your clipboard.
What’s the difference between Pause and Close?
Pause is for a background job started with claude --bg. It runs Claude Code’s own claude stop <id>, and you can resume the job afterwards.
Close is for a live interactive session, a terminal someone has open. Claude Code has no built-in stop for that case, so Close ends the session’s whole process tree. On Windows, the terminal window stays open and the session stays resumable afterwards.
Does ResumerAgent send my data anywhere?
No. It has zero runtime dependencies (node:http, node:fs and node:child_process only) and serves the dashboard on 127.0.0.1. Everything it reads comes from your own SESSIONS_ROOT.
Can I use pnpm instead of npm?
Yes, for every command. The one exception is a desktop shortcut, which should run npm run launch. See Install.
Does it work on macOS and Linux?
The macOS and Linux code paths exist and are covered by unit tests and a CI matrix on Ubuntu and macOS runners. Only the Windows path has run on real hardware so far. See Install.
What if I run Claude Code inside Docker?
Set SESSIONS_ROOT to the host path where your container mounts its Claude config directory. Then set RESUME_COMMAND and ATTACH_COMMAND to a docker exec command. See Configuration for the exact example.