process-guard

Community

Guard against blocking and orphaned processes in terminal commands.

Authoryanowo
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill prevents coding agents from blocking on long-running terminal commands and from leaving orphaned processes, ensuring smooth and resource-efficient operation.

Core Features & Use Cases

  • Command Classification: Identifies finite, long-running, and interactive commands before execution.
  • Finite Command Execution: Executes finite commands with timeouts to prevent blocking.
  • Long-Running Command Management: Starts long-running commands as background processes with graceful shutdowns.
  • Readiness Verification: Checks the readiness of processes using health URLs, ports, custom probes, or log patterns.
  • Cleanup: Recursively stops managed processes and cleans up state files.

Quick Start

Run a long-running command like 'npm test' with process-guard:

"$PROCESS_GUARD_DIR/scripts/with-managed-process.sh" --name test --command "npm test" --port 3000 --timeout 60

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 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: process-guard
Download link: https://github.com/yanowo/agent-process-guard/archive/main.zip#process-guard

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 620,000+ vetted skills library on demand.