Works with the AI Agents you already use
wdog
A watchdog runner that monitors long-running shell commands for hangs, prompts, and orphan processes.
Free
wdog
Example session with this skill installed
Run a clean install and build for this npm project. It usually takes 5 minutes. If it hangs or asks for input, stop it.
- Read your context and instructions
- Compiled the wdog
I will execute the install and build process using wdog to monitor for hangs or interactive prompts.
Build Execution
# Starting the build as a named job to monitor progress
wdog start --name project-build --max 15m -- 'npm ci' 'npm run build'
# Waiting for completion with an 8-minute poll interval
# (exit 124 will trigger a retry if the job is still healthy)
wdog wait project-build --for 8m
The command initiated a supervised process tree. wdog is monitoring for STALL alerts (120s of inactivity) and PROMPT detection.
| Field | Value |
|---|---|
| Job Name | project-build |
| Max Timeout | 15m |
| Status | RUNNING |
| Steps | npm ci, npm run build |
Next steps
- Run
wdog status project-buildto check the current step and runtime. - Use
wdog tail project-build -n 50if you see anERROR_LIVEalert. - The processes will be automatically cleaned up if a stall is detected.
Connects securely to your tools. The creator never sees your data.
About this skill
Long-running shell commands often fail silently, hang on hidden prompts, or leave orphan processes that eat resources. Plain shell redirection and manual polling make it impossible to track the health of a build or a remote migration without constant babysitting.
What it does
- Watchdog execution monitors process trees for CPU stalls, I/O activity, and hung states.
- Prompt detection identifies when a command is waiting for user input and fails fast to prevent hangs.
- Job management handles background processes with named tracking, status monitoring, and cleanup.
- Remote orchestration executes and monitors commands on remote hosts over SSH with automatic self-installation.
- Port/URL polling waits for dev servers or services to become healthy before proceeding.
- Log analysis extracts error patterns and summarizes failures without dumping thousands of lines of noise.
How it works
- Wrap commands using
wdog run -- 'command'for immediate tasks orwdog startfor background jobs. - Monitor alerts by checking for
STALL,PROMPT, orORPHANlines in the output stream. - Control execution with
wdog waitto block until a specific port is open or a timeout is reached. - Inspect failures using
wdog tailorwdog errorsto see exactly why a process tree stopped.
Frameworks & tools
This tool is a Linux-compatible binary that works with any shell command, including Docker, Node.js, Rust, Python, and SSH. It integrates with system-level process tracking and requires no root privileges.
Why this beats prompting it yourself
Writing robust shell wrappers for timeouts and orphan cleanup is error-prone and usually misses edge cases like zombie processes or interactive prompts. This skill provides a standardized protocol for process supervision that handles the lifecycle and failure modes of complex dev ops tasks out of the box.
Use cases
- Supervise long CI/CD build pipelines and test suites to prevent runner timeouts.
- Orchestrate dev server startup sequences that depend on database migrations.
- Manage remote database maintenance tasks over flaky SSH connections.
- Clean up leaked processes from complex integration tests automatically.
Known limitations
Supports Linux only (x86_64). Requires a binary installation on the host or remote machine. Standard input is closed by default to prevent silent hangs on prompts.
Linux x86_64 only. Requires binary installation. Closes stdin to prevent hangs, so interactive commands must be run in non-interactive modes.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 10 days ago
- Free with an Agensi account
Requires
Permissions
Allowed Hosts