stop-rudder-dev-maintainer

Stop repo-local Rudder pnpm dev processes with SIGTERM and optional forced cleanup.

280|30|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Undertone0809/rudder --skill stop-rudder-dev-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stop-rudder-dev-maintainer
Source: https://github.com/Undertone0809/rudder/tree/main/.agents/skills/maintainer/stop-rudder-dev-maintainer
Command: npx skills add https://github.com/Undertone0809/rudder --skill stop-rudder-dev-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It prevents accidental, overly broad process killing by stopping only the current Rudder repo-local development runtime (e.g., pnpm dev and its related dev runner/desktop processes) in a controlled way.

Core Features & Use Cases

  • Graceful shutdown first: Uses SIGTERM via a bundled script to stop matched Rudder dev processes and verifies whether anything survived.
  • Targeted scope only: Ensures matches belong to the current Rudder checkout (repo-root path checks) and avoids stopping unrelated pnpm/node/vite/Electron work.
  • Optional forced cleanup: Uses hard kill (SIGKILL) only when --force is explicitly provided and only for survivors.

Use cases include stopping or restarting the local Rudder development environment when it needs to be cleaned up, freed from stuck processes, or shut down before another run.

Quick Start

Run: bash .agents/skills/maintainer/stop-rudder-dev-maintainer/scripts/stop_rudder_dev.sh

Frequently Asked Questions about stop-rudder-dev-maintainer

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

FAQPage Schema
How do I safely stop pnpm dev processes without killing unrelated node or vite work?

To stop pnpm dev safely, target only the current Rudder checkout's runtime using repo-root path checks and SIGTERM verification. This avoids broad pkill commands and prevents accidental shutdown of unrelated node, vite, or Electron processes.

What is the best way to clean up stuck Rudder local development processes?

The best way to clean up stuck Rudder local development processes is running a bundled stop script that matches repo-local dev runners and applies SIGTERM. It verifies survivors and only uses SIGKILL when explicitly passed with --force.

How does graceful shutdown work for Rudder dev runner and desktop processes?

Graceful shutdown works by sending SIGTERM to matched Rudder dev and desktop runner processes, then verifying if anything survived. It confines matching to the current repository checkout, ensuring no production or unrelated repos are affected during the shutdown.

Can I use a dry run to check which processes a Rudder dev stop script will target?

Yes, you can use the optional --dry-run flag with the stop script. This allows you to verify which repo-local pnpm dev processes match the current Rudder checkout before actually sending any SIGTERM or SIGKILL signals.

Why does my Rudder dev environment have leftover processes after a standard termination?

Leftover processes occur when standard termination fails to kill all child or desktop runners. You can handle survivors deterministically by running the stop script with the --force flag, which applies a targeted SIGKILL only to the remaining matched processes.