stuck-process-detection

Community

Detect and recover from stuck background processes.

Authorkrwhynot
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prevents infinite polling loops and hangs when monitoring background shells, by enforcing timeouts, max polls, and a clear recovery path with KillShell.

Core Features & Use Cases

  • Foreground-first operation with explicit timeout limits.
  • Max poll controls (e.g., 5 attempts) to prevent endless waiting.
  • Stuck-pipeline detection via 3 consecutive empty BashOutput responses triggers recovery.
  • Integration with KillShell for automatic recovery and safe retry decisions.

Quick Start

Use the detector when launching background processes, and configure a max poll limit to automatically stop and recover on timeouts.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: stuck-process-detection
Download link: https://github.com/krwhynot/crispy-crm/archive/main.zip#stuck-process-detection

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.