# Release Preview

> Cut an AgentOS release-preview. Use when the user asks for a preview, release-preview, or a branch dist-tag build.

- Skill: `rivet-dev/release-preview` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rivet-dev/release-preview`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rivet-dev/release-preview/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rivet-dev (https://skillmd.com/u/rivet-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rivet-dev/release-preview

---


# AgentOS Release Preview

AgentOS previews are branch snapshots from this repository. The workflow builds
debug artifacts and publishes npm packages under a sanitized branch dist-tag.
No crates.io release, git tag, or GitHub release is created.

agentos is a generated mirror. Do not bump a agentos ref or cut a
agentos preview by hand.

## Procedure

1. Push the AgentOS branch.
2. Dispatch and watch:

```bash
just release-preview <agentos-branch>
run=$(gh run list -R rivet-dev/agentos --workflow=publish.yaml -L1 --json databaseId --jq '.[0].databaseId')
gh run watch -R rivet-dev/agentos "$run" --exit-status
```

3. Install a preview with:

```bash
npm install @rivet-dev/agentos-core@<sanitized-branch>
```

## Rules

- Release-preview is for previews only; releases use the `release` skill.
- All code changes belong in AgentOS. The agentos mirror is regenerated
  from AgentOS and follows the published AgentOS version.
- On failure: `gh run view <run> --log-failed`, fix, re-dispatch, re-watch.