illari: know when your scheduled jobs stop running

crontab

# add illari to the end of the crontab line
* * * * *  /usr/local/bin/backup.sh && curl -fsS https://illari.dev/ping/abc123

backup.sh

#!/bin/bash
set -e
./run-nightly-etl.sh

# only pings if every command above succeeded
curl -fsS --retry 3 https://illari.dev/ping/abc123

python

import urllib.request

do_the_work()

# ping on success
urllib.request.urlopen("https://illari.dev/ping/abc123", timeout=10)

node

await doTheWork();

// ping on success
await fetch("https://illari.dev/ping/abc123");

scheduled agent

# a scheduled agent run: report the outcome and the numbers
python agent.py; code=$?

curl -fsS -m 10 \
  -d "cost_usd=$(jq -r .cost run.json)" \
  -d "tool_calls=$(jq -r .tool_calls run.json)" \
  "https://illari.dev/ping/abc123/$code"

illari CLI

# no edits to the script: the CLI wraps it
npm install -g illari

illari run --key abc123 -- ./nightly-etl.sh

How is this different from checking the exit code in my script?

You still have to be watching. illari watches for you, and it catches what your script can't report on at all: the scheduler never fired, the machine was down, the job definition got dropped in a deploy. No ping arrives, and you hear about it.

My job runs but sometimes does the wrong thing. Does illari catch that?

The free tier checks that the job checked in on schedule. Pro reads the run too: send the exit code, duration, output tail, and numbers like a row count on the same ping, and illari alerts you when a run fails, takes far longer than its baseline, or reports a value past a threshold you set (rows < 1, errors > 0).

Do I need to install anything?

No. One HTTP request from anywhere your job can reach the internet, no agent or SDK. There's an optional CLI (npm install -g illari) that wraps a command and sends the start ping, exit code, and output for you, but it isn't required.

Can a coding agent set this up?

Yes. The docs are published as plain markdown at illari.dev/llms-full.txt, with an index at /llms.txt. Point your agent at that URL and ask it to add illari to the scheduled jobs in the repo. It has the ping URL pattern, the event suffixes, and the metric-rule syntax.

Can I monitor a scheduled AI agent?

Yes. An agent run is a run: ping the monitor URL when it finishes with the exit code, and send the numbers that describe a good run (cost_usd, tool_calls, rows_written). illari alerts if the run never checks in, exits non-zero, or reports a metric past a threshold you set, like cost_usd over 5. Same mechanism as a cron job.

What happens if illari goes down?

illari runs on separate infrastructure from the jobs it watches. When your server, scheduler, or network fails, illari is on the other side of that failure, still running and able to alert you. Staying up while your side is down is the entire point of the service.