git404hub

what is claude-rescue fr?

xcrag/claude-rescue — explained in plain English

Analysis updated 2026-05-18

21JavaScriptAudience · developerComplexity · 1/5LicenseSetup · easy

tl;dr

A terminal dashboard that shows every running Claude Code session at a glance, flags stuck or frozen sessions, and can launch a fresh rescue session to continue the work.

vibe map

mindmap
  root((claude-rescue))
    What it does
      Live session dashboard
      Stuck session detection
      One key rescue launch
    Tech stack
      JavaScript
      Node.js
    Use cases
      Monitoring parallel sessions
      Recovering frozen sessions
      Scripting session status
    Audience
      Claude Code power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

See a live list of every running Claude Code session across all your projects.

VIBE 2

Spot sessions that are stuck retrying, erroring, or frozen for over five minutes.

VIBE 3

Press a key to launch a fresh Claude Code session that picks up a stuck session's work.

VIBE 4

Print the session list as plain text or JSON to pipe into scripts.

what's the stack?

JavaScriptNode.js

how it stacks up fr

xcrag/claude-rescueamazingsyp/pokemon-ontologybinglehaepi/workingtable
Stars212121
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity1/53/51/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Only requires Node.js installed, no other packages needed.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

in plain english

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.

prompts (copy fr)

prompt 1
Help me install claude-rescue with Node.js and run it to monitor my Claude Code sessions.
prompt 2
Explain how claude-rescue detects a frozen or stuck Claude Code session.
prompt 3
Show me how the rescue feature starts a new session that continues a stuck one's task.
prompt 4
Walk me through printing claude-rescue's session list as JSON to pipe into another command.

Frequently asked questions

what is claude-rescue fr?

A terminal dashboard that shows every running Claude Code session at a glance, flags stuck or frozen sessions, and can launch a fresh rescue session to continue the work.

What language is claude-rescue written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js.

What license does claude-rescue use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is claude-rescue to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-rescue for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.