xcrag/claude-rescue

claude-rescue is a small terminal dashboard for anyone running multiple Claude Code sessions at once. When you use Claude Code (an AI coding assistant that runs in your terminal), each active session writes a status file to a folder on your computer. This tool reads those files and shows a live list of every session that is currently running, refreshed every two seconds. It works on macOS, Windows, and Linux, and the only requirement is having Node.js installed. No other packages need to be downloaded. The main display shows each session's name, a shortened identifier, whether it is busy or idle, when it last did something, and which project folder it belongs to. This makes it easy to glance at what all your running sessions are doing without switching between terminal windows. The tool also watches the conversation transcript of each session to flag problems. It highlights sessions that are stuck retrying a failed API request, sessions that recently produced an error response, and sessions that have not updated in more than five minutes and may be frozen. These show up in yellow or red in the list so you can spot them quickly. When a session appears stuck, you can press a single key to start a rescue. The tool opens a new terminal window in the same project folder and launches a fresh Claude Code session with a prompt telling it the previous session's identifier and asking it to check the task progress and continue. This sidesteps the common problem where a long-running session accumulates so much context that it keeps hitting rate limits or timeouts in a loop. The rescue session starts light and can assess the situation cleanly. For scripting purposes, the tool can also print its session list as plain text or as JSON and exit immediately, making it easy to pipe into other commands. The license is MIT.