fix-stuck-session

What problem does it solve?

Resolves the "RPC error: process with name already running" failure that prevents Claude Cowork sessions from loading or accepting follow-up messages by diagnosing orphaned session state files and orphaned processes.

Core Features & Use Cases

• Tiered diagnostic workflow: Identify stuck sessions, cross-reference with session listings, and map errors to root causes.
• Safe remediation options: Propose and perform non-destructive fixes first (archive session JSON), escalate to graceful process termination, and only use full cache resets as a last resort.
• Supervised operations: Always require explicit user confirmation before any destructive action and provide a structured report of actions taken.
• Cross-platform support: Guidance and commands for macOS, Windows, and Linux environments to recover local Claude Cowork sessions.
• Use case: Recover an orphaned Cowork session named in an RPC error so users can resume their task without losing other active sessions.

Quick Start

Run the fix-stuck-session skill to scan local Cowork sessions, present findings, and, after your confirmation, archive the stuck session or terminate the orphaned process to restore normal operation.