hellhound-cli

Monitor Make.com scenarios, n8n workflows, Zapier zaps, AI agents, and CLI scripts. Get alerted by email, Slack, or SMS when something breaks.

Full docs: https://hellhound.dev/docs

Install

npm install -g hellhound-cli

Requires Node.js 18+.

Quick start

hellhound init
hellhound watch --name "lead-pipeline" --run "node agent.js"
hellhound alert add --name "lead-pipeline" --channel email --to [email protected]

What it monitors

CLI scripts and agents — wrap any command, zero code changes:

hellhound watch --name "invoice-processor" --run "node process.js"
hellhound watch --name "daily-report"      --run "python report.py"
hellhound watch --name "backup-job"        --run "./backup.sh"

# Long-running agents with heartbeat monitoring
hellhound attach --name "support-bot" --run "node bot.js"

Make.com, n8n, Zapier, Activepieces — add two HTTP modules to your scenario, nothing else changes:

POST https://hellhound.dev/api/webhook/run-start
POST https://hellhound.dev/api/webhook/run-end

Setup guide: https://hellhound.dev/docs/make

What it detects

Hellhound learns what normal looks like over the first 10 runs then alerts on significant deviations:

• Crash or non-zero exit code — immediate alert
• Output 90%+ shorter than baseline — silent failure detection
• Duration 10x+ slower than baseline — stuck or frozen automation
• run-end never received — hung scenario detection
• Error keywords in output — "failed", "error", "timeout"
• Heartbeat missed — long-running agent went quiet

Day-to-day variation does not trigger alerts. Only extreme outliers do.

Alert channels

hellhound alert add --name "my-agent" --channel email --to [email protected]
hellhound alert add --name "my-agent" --channel slack --to "https://hooks.slack.com/..."
hellhound alert add --name "my-agent" --channel sms   --to +14155552671

All commands

hellhound init
hellhound watch  --name <n> --run <command>
hellhound attach --name <n> --run <command>
hellhound attach --name <n> --pid <pid>
hellhound alert add    --name <n> --channel <email|slack|sms> --to <dest>
hellhound alert list   --name <n>
hellhound alert remove --name <n> --id <id>
hellhound logs   --name <n> [--limit 50]
hellhound status
hellhound dashboard

CI/CD

# GitHub Actions — use secret instead of config file
HELLHOUND_API_KEY=${{ secrets.HELLHOUND_API_KEY }} \
  hellhound watch --name "deploy" --run "./deploy.sh"

Crontab

# Before
*/15 * * * * node /home/user/pipeline.js

# After — zero changes to pipeline.js
*/15 * * * * hellhound watch --name "pipeline" --run "node /home/user/pipeline.js"

Environment variables

HELLHOUND_API_KEY    API key — overrides config file

Docs

• Getting started: https://hellhound.dev/docs
• CLI reference: https://hellhound.dev/docs/cli
• Make.com setup: https://hellhound.dev/docs/make
• API reference: https://hellhound.dev/docs/api
• Support: [email protected]

License

UNLICENSED — © Zerostone Digital