Publish a package

A package is a directory containing an openagent.yaml manifest, a README.md, and any number of files. Free packages are always free to publish. Paid packages keep a 90% creator share after the 10% platform fee — connect a payout account first at Settings → Payouts.

openagent.yaml

schema: 1
name: pr-reviewer
owner: openagents
version: 1.2.0
kind: workflow
title: Pull Request Reviewer
summary: One-line description (<= 160 chars)
license: MIT
tags: [code-review, github, quality]
runtimes: [claude-code, cursor, codex, generic]
pricing:
  model: free
  amount_cents: 0
  currency: usd
entry: WORKFLOW.md
files:
  - WORKFLOW.md
  - rules/review-checklist.md
inputs:
  - name: repo
    type: string
    required: true
    description: owner/name of the repository
requires:
  - openagents/base-rules@^1

Publish with the CLI

Run this from inside your package directory once your manifest and files are ready.

npx openagents-cli publish

Create a token under Settings → API tokens, run npx openagents-cli loginonce, then publish from your package directory. --dry-run checks without uploading; see the CLI docs.

Publish a free package

Free packages can also be contributed via pull request to the catalog/ folder on GitHub — no account required.

Open the catalog on GitHub

Upload

Read the full package format in the docs.