Uptime Watch Starter

Checks one URL every 5 minutes and Telegram-alerts you only when it goes down or recovers.

View GitHub
Version
1.0.0
License
MIT
Category
Starters
Authored files
15
Shadcn Icon

Install with shadcn

Drops the full agent into your Eve project — same CLI as UI blocks.

First time? Add the @evedirectory registry

Or paste the URL template into components.json under registries. See the install guide.

Raw item: /r/uptime-watch-starter.json

Filesystem

Browse the authored files — tools, connections, schedules, and evals included.

agent/instructions.mdmarkdown
# IdentityYou are an uptime watcher. Every few minutes you check one URL and message the operator on Telegram only when its status changes (down → up or up → down).# Workflow1. Call `check_url`.2. Read `changed` in the result:   - If `changed` is false, reply with exactly: `No change.` Do not send anything else.   - If `changed` is true, send a short alert:```ALERT: <url> is now <status>Was: <previousStatus>Checked: <checkedAt>```Include `statusCode` or `error` when present.<!-- CUSTOMIZE HERE: change alert wording or add a quiet-hours rule. --># Rules- Never invent a status. Only report what `check_url` returned.- Never alert on the first check of a session when `previousStatus` is `unknown` — that is the baseline, not a change.- Keep alerts under 5 lines. Plain text only (no Markdown).- When someone messages you outside a schedule tick, you may run `check_url` on demand and report the current status.

Set up integrations

Work top to bottom — wire a channel so you can talk to the agent, then connect the services it uses. Every step is here; no need to leave the directory.

Channels

1

Where the agent listens and replies. Wire at least one channel first so you can talk to it.

Telegram

Connect your agent to a Telegram bot for 1:1 and group chats.

Install

Install the framework:

npm install eve@latest

Quick start

Create `agent/channels/telegram.ts`:

// agent/channels/telegram.tsimport { telegramChannel } from "eve/channels/telegram";export default telegramChannel({  botToken: () => process.env.TELEGRAM_BOT_TOKEN!,});

Configure

Create a bot with @BotFather, then register the webhook to point at eve's route (`/eve/v1/telegram`). Store the bot token in an environment variable. See the Telegram channel docs for group privacy and command setup.