# Release shipped

Posts a short note to Slack when you publish a GitHub release, and thanks the people who built it.

Requires GitHub, through its own MCP server. Requires Slack, through Composio. Starts from a public feed it checks.

## Install

Public repositories only: it watches the repository's release feed, and a private repository's feed needs a login. Make one fine-grained GitHub token with Contents read-only on that repository, and add it as the GitHub (token) server in Settings → MCP servers with Read-only on.

No one has run this against real Slack accounts through Composio yet. Its eval cases use stand-ins.

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

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

## What it does

When you publish a release on GitHub, posts one short celebration to your team's Slack channel. It says what shipped in plain words, taken from the release notes and the pull requests merged for it, links the release and thanks the people who wrote it, by name and without pinging anyone. Pre-releases stay quiet unless you want them, and a release is never announced twice, even when you edit it. It watches the repository's release feed every 15 minutes, so it works on public repositories only (a private repository's feed needs a login). It reads GitHub with one fine-grained token, Contents read-only on that repository, added as the GitHub (token) server with Read-only on. It posts on its own only if you pick Never for approvals at install; it stays held to your repository and channel either way.

- Skill `celebrate`: Announce one published GitHub release in Slack, once. Read the release, find the pull requests merged for it, pick the few changes a user would notice, and post one short celebration that links the release and thanks its authors without pinging them. Skip drafts, pre-releases (unless the owner wants them) and releases already announced, edited ones included. Use for the release-published trigger's feed items and for "announce v2.4.0".

## What starts it

- Checks https://github.com/<owner>/<repo>/releases.atom every 15 minutes: each new or updated item starts one run. At most 1 at once.
- By hand, any time: from the console, the API or the CLI.

## Inputs

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `tag` | string, 0 to 100 characters | no | Announce one release by hand, by its tag. Leave it out on the trigger's runs: the feed item names the release. Example: `v2.4.0`. |

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `owner` | string | yes | The GitHub account or organization that owns the repository, like Parcha-ai. |
| `repo` | string | yes | The repository's name without the owner, like agentrun. |
| `channel` | string | yes | The Slack channel ID the celebration goes to, like C0123ABCD (in Slack: the channel's details, at the bottom). Not a #name. |
| `include_prereleases` | boolean | no | Also celebrate releases GitHub marks as pre-release (betas, release candidates); off unless you turn it on. Default: `false`. |

## What it needs

- Harness: pi, claude-agent, codex
- Model: balanced tier, low effort
- Tools: read
- GitHub MCP server tools: get_release_by_tag, list_releases, list_pull_requests, pull_request_read. Reads the release, the release before it and the pull requests merged for it, with your token (Contents read-only on this repository is enough). Every call is held to the repository you set. It writes nothing on GitHub.
- Composio Slack tools: SLACK_SEND_MESSAGE. Posts one message per release to the one Slack channel you set, and nowhere else.
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: on

## Sample output

Input:

```json
{
  "content": "Announce this release.",
  "tag": "v2.4.0"
}
```

Output:

Illustrative output, written by hand from the `highlights-from-notes` eval case's test release. A measured eval run
replaces it.

lantern v2.4.0 was published, and one message went to the team's channel: PDF export, the Safari sign-in fix, and a
warning that the CLI now needs Node 20. It linked the release and thanked mira-k and jon-b by name without pinging
them. The Dependabot bump counted toward the total and wasn't called out.

## Tested

Passes 5 of 5 eval cases on pi, 5 of 5 on Claude Code and 5 of 5 on Codex.

5 eval cases: edited-release, first-release-thin, highlights-from-notes, injection-in-notes, no-repeats.

## Source

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