nightsitter

Stop babysitting your AI agents.

You kicked off a Claude Code session (or a cron'd agent job) and walked away. Six hours later you discover it's been sitting on a permission prompt since minute nine — or looping, or dead. nightsitter is the night-shift watchdog: it tells the difference between working, stuck, waiting for you, and dead, and pings your phone only when it matters.

pipx install nightsitter

nightsitter watch                      # watch all local Claude Code sessions
nightsitter status                     # one-shot fleet snapshot
nightsitter run -- python nightly.py   # dead-man wrapper for any command
nightsitter daemon install             # run the watcher as a service (launchd/systemd)

What it detects

Notifications

Zero-signup default: ntfy.sh. Set a topic and install the ntfy app:

export NIGHTSITTER_NTFY_TOPIC="your-secret-topic"
nightsitter test-notify

Telegram and desktop notifications are also supported — see ~/.nightsitter/config.toml:

[notify]
ntfy_topic = "your-secret-topic"
# telegram_token = "..."
# telegram_chat_id = "..."
# desktop = "on"

Run it as a service

The watcher only helps if it outlives your terminal:

nightsitter daemon install    # macOS launchd (KeepAlive) / Linux systemd --user
nightsitter daemon status
nightsitter daemon uninstall

Re-run install with different flags (--stall-after 20) to update in place.

Dead-man wrapper for cron agents

nightsitter run --label nightly-report --max-minutes 45 \
  --heartbeat-url https://hc-ping.com/<uuid> -- python nightly.py

• alerts on failure or when the kill switch fires (SIGTERM → SIGKILL)
• pings your healthchecks.io check on success, /fail on failure
• passes stdio through untouched

Status

v0.1 — local CLI, free forever (MIT). A hosted version (alert history, multi-machine fleet view, mobile) is planned — founding-user preorders coming with the launch.