# Publish Registry

> Publish @agentos-software/* registry packages from AgentOS. Use whenever the user asks to publish or release registry software/agent packages.

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

---


# Publish AgentOS Registry Packages

Registry packages live in `agentos/registry` and publish as
`@agentos-software/*`. They version independently per package.

## Procedure

1. Build native command artifacts and package tarballs:

```bash
just registry-native
just registry-build [pkg]
just registry-status --remote
```

2. Bump the package's own `package.json` version and commit it.
3. Publish from AgentOS:

```bash
just registry-publish <pkg>         # dist-tag dev
just registry-publish <pkg> latest  # deliberate latest release
just registry-publish-all [tag]
```

## Rules

- Do not publish registry packages from agentos.
- Do not move `latest` unless the user explicitly asks for a release.
- Prefer AgentOS workspace builds while iterating; published pins are for
  consumers and release validation.