Skip to main content

buttons publish

Publish a local button or drawer to the registry

Synopsis

Publish a local package. A package can be a button (.buttons/buttons/<name>/button.json + code + AGENTS.md) or a drawer (.buttons/drawers/<name>/drawer.json + AGENTS.md). Run history under pressed/ is never published. Publish uses $BUTTONS_REGISTRY_URL as the registry base URL. This repo does not ship a default registry host; the caller must configure the target explicitly. A registry publish takes a scoped name (@desk/name): the on-disk package is found by its bare name, and @desk is its registry namespace. The CLI detects whether the local package is a button or drawer from button.json or drawer.json. The registry pins immutable versions; publish starts at the package’s current version and auto-bumps to the next number if that version already exists. Auth uses the write key (REGISTRY_WRITE_KEY battery or $BUTTONS_BAT_REGISTRY_WRITE_KEY) — distinct from the read key install uses. Examples:

Options

Options inherited from parent commands

SEE ALSO

  • buttons - Deterministic workflow engine for agents