child-process-supervisor

Spawn and manage external commands with timeouts and process-tree termination.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/bermudi/skills --skill child-process-supervisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: child-process-supervisor
Source: https://github.com/bermudi/skills/tree/main/child-process-supervisor
Command: npx skills add https://github.com/bermudi/skills --skill child-process-supervisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a robust framework to design and implement a safe, extensible child-process supervisor for agent runtimes, enabling controlled spawning, monitoring, and termination of external processes.

Core Features & Use Cases

  • Safe process spawning with unified handling for non-interactive and PTY modes
  • Independent timeout mechanisms (overall timeout and no-output timeout) with graceful termination
  • Complete process-tree termination across Unix and Windows platforms
  • Environment isolation strategies and support for controlled inheritance
  • Output capture with streaming and retention for post-run analysis
  • Common adapter interface enabling interchangeability of child and PTY modes

Quick Start

Design and implement a production-grade child process supervisor that can spawn and manage external commands with deterministic timeouts and proper teardown.

Frequently Asked Questions about child-process-supervisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement a child process supervisor with timeout and graceful shutdown?

To implement a child process supervisor with timeout and graceful shutdown, design a framework that enforces overall and no-output timeout semantics, then ensures complete process-tree termination across Unix and Windows platforms.

Can I manage interactive shells and non-interactive commands with the same process supervisor?

Yes, you can manage both interactive shells and non-interactive commands by exposing a common adapter interface that handles PTY modes and standard child process spawning interchangeably within the same runtime.

What is the best way to terminate an entire process tree spawned by an agent runtime?

The best way to terminate an entire process tree is to apply cross-platform lifecycle management techniques during graceful shutdown, ensuring parent and child processes are safely killed across Unix and Windows environments.

How does environment isolation work when spawning external commands?

Environment isolation works when spawning external commands by applying controlled inheritance strategies, allowing the supervisor to securely manage and restrict environment variables passed to the child process tree.

Does this child process supervisor support streaming output capture for post-run analysis?

Yes, this child process supervisor supports robust output handling by capturing streaming output during execution and retaining it, enabling thorough post-run analysis of the external commands.

When do I need PTY mode for spawning external commands in an agent runtime?

You need PTY mode for spawning external commands when your agent runtime requires interactive shell sessions, whereas non-interactive modes handle standard automated command execution without user input.