# Upgrade watch

Every Monday, says whether upgrading a project you depend on is safe for what you use from it, each break quoted from its release notes.

Requires web fetch. Runs on a schedule.

## Install

```sh
npx @parcha/agentrun template install github:Parcha-ai/agentrun-templates/templates/upgrade-watch@242f29da8317fbe51d0cce4628bdb5ab61d7ccc9 --trust
```

Or open `<your AgentRun address>/#/templates/install?src=github%3AParcha-ai%2Fagentrun-templates%2Ftemplates%2Fupgrade-watch%40242f29da8317fbe51d0cce4628bdb5ab61d7ccc9`. Pinned to commit 242f29da8317fbe51d0cce4628bdb5ab61d7ccc9.

## What it does

Every Monday, reads what a project you depend on released since the version you run, checks each breaking or behavior change against the list of what your project uses from it, and answers safe to upgrade or names what breaks and what to do, each finding quoted from the release notes and linked. Notes it could not read are said, never guessed.

- Skill `upgrade`: Check whether upgrading a dependency is safe for the owner's project. List the watched GitHub repository's version tags, work out by version order which releases lie between the version in use and the newest, read the notes of every one of them on a fixed small fetch plan, match each breaking or behavior change against the owner's list of what their project uses, and answer safe, changes needed (each finding quoted, linked, with what to do), up to date, or incomplete when any release's notes could not be read. Use for the scheduled weekly run and for "is it safe to upgrade", "what breaks if we upgrade", "check the new release".
- Rules: `UPGRADE.md`

## What starts it

- On a schedule: Mondays at 08:00 (UTC), unless you pick another time when you install it.
- By hand, any time: from the console, the API or the CLI.

## Inputs

Each run takes a plain message (`content`).

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `repository` | string | yes | The GitHub repository whose releases to watch, as owner/name ("acme/widget") |
| `current_version` | string | yes | The version you run now, as its release tag ("v2.3.1"). After you upgrade, tell the agent the new one in a run and it remembers it. |
| `depends_on` | string | yes | What your project uses from it, semicolon-separated, each a thing a release note could name: a command and its flags, an HTTP route, a config key, an environment variable, a file format, an exported function ("the serve command's --port and --data flags; POST /v2/agents; the WIDGET\_TOKEN variable") |
| `cron` | string, cron | no | When the check runs, as a cron line (minute hour day-of-month month day-of-week): Monday 08:00 unless you set it. Default: `0 8 * * 1`. |
| `timezone` | string, timezone | no | The IANA time zone the cron line is read in (Europe/Madrid, America/New\_York): UTC unless you set it. Default: `UTC`. |

## What it needs

- Harness: pi, claude-agent, codex
- Model: balanced tier, medium effort
- Tools: web_fetch, read
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: on

## Sample output

No sample output ships with this template yet.

## Tested

Passes 20 of 20 eval cases on pi, 20 of 20 on Claude Code and 20 of 20 on Codex. Not yet tried on the live web.

20 eval cases: backport-order, breaks-a-flag, current-beyond-pages, deprecation-only, empty-notes, far-behind, finding-stays, hidden-newer-line, injection, maintenance-line, no-tags, notes-unreadable, other-tag-series, partial-range, prerelease-newer, safe-upgrade, tag-without-release, unknown-version, up-to-date, usage-changed.

## Source

- Package: https://github.com/Parcha-ai/agentrun-templates/tree/242f29da8317fbe51d0cce4628bdb5ab61d7ccc9/templates/upgrade-watch
- Publisher: Parcha-ai
- Author: Parcha Labs
- Version: 0.1.0
- License: Apache-2.0
- Category: Engineering
- Page: https://marketplace.agentrun.ai/templates/upgrade-watch/
