Docs
Configuration
Optional environment variables for session location, resume and attach commands, the terminal and the port, plus a Docker example.
ResumerAgent’s source code isn’t public yet. These pages describe how it works once it is.
Environment variables
Every setting is optional. Set them in .env (copy .env.example to start) or in your shell.
| Variable | Default | What it does |
|---|---|---|
SESSIONS_ROOT |
$CLAUDE_CONFIG_DIR, then ~/.claude |
Directory that contains Claude Code’s sessions/ and projects/ folders. |
RESUME_COMMAND |
claude --resume {sessionId} |
Command template that runs when you click Resume. Placeholders: {cwd}, {sessionId}, {id}. |
ATTACH_COMMAND |
claude attach {id} |
Command template that runs when you click Attach. Same placeholders. |
TERMINAL_COMMAND |
Auto-detected per OS (see Install) | Overrides how Resume and Attach open a terminal window. Placeholders: {command}, {title}, {cwd}. |
PORT |
4317 |
Port for the local dashboard server. |
The dashboard always binds to 127.0.0.1, whatever port you choose.
Running Claude Code in Docker
If Claude Code runs inside a container, your session files live there too. When the container mounts its Claude config directory to a host path:
- Set
SESSIONS_ROOTto that host path. - Point
RESUME_COMMANDandATTACH_COMMANDat whatever invokesclaudefor you:
RESUME_COMMAND=docker exec -it my-claude-container claude --resume {sessionId}
ATTACH_COMMAND=docker exec -it my-claude-container claude attach {id}
Rate limits in the activity strip
Each session row shows cost so far and context-window use, read from the session’s own transcript. Nothing to configure.
The 5-hour and 7-day rate-limit figures need one extra thing: a statusline sidecar file at <SESSIONS_ROOT>/activity/<sessionId>.json, written by your own Claude Code statusline script. Claude Code transcripts don’t record rate limits, so the sidecar is the only source. It’s optional. Without it the dashboard leaves the rate limits out and shows everything else.