@provines/agent-ops

Zero-config heartbeat monitor for Claude agents and cron jobs.

Quick Start

# One-shot ping (cron jobs)
npx @provines/agent-ops --once --name "my-cron" --schedule every-1h

# Persistent heartbeat (always-on agents)
npx @provines/agent-ops --name "my-agent"

# Auto-detect everything from package.json
npx @provines/agent-ops

CLI Options

| Flag | Description | Default | |------|-------------|---------| | --name | Agent name | Auto-detected from package.json or directory | | --project | Project name | Auto-detected from package.json or git remote | | --schedule | always-on, every-1h, every-6h, every-24h, manual | always-on | | --message | Status message shown on dashboard | — | | --log | Tail a log file (last 10 lines sent as message) | — | | --url | Custom ping endpoint | https://agent-ops-coral.vercel.app/api/ping | | --once | Send single ping and exit | false |

As a Library

const { ping, startHeartbeat } = require('@provines/agent-ops');

// One-shot
await ping({ name: 'my-cron', schedule: 'every-1h', message: 'Done' });

// Persistent (returns stop function)
const stop = startHeartbeat({ name: 'my-server' });

Dashboard

https://agent-ops-coral.vercel.app