---
title: "axiom publish"
description: "Publish a pushed package to the public marketplace"
category: reference
surfaces: [cli]
related: [reference/cli/axiom]
last_reviewed: 2026-06-06
---

<!-- GENERATED by docs/scripts/gen-cli-reference — DO NOT EDIT.
     Source of truth: the cobra command definitions in cmd/axiom/cmd/.
     Regenerate from the repo root with: go run ./docs/scripts/gen-cli-reference -->

# axiom publish

Publish a pushed package to the public marketplace

Publish a pushed package to the public marketplace.

Publishing flips a package you previously deployed with "axiom push" from
tenant-private to publicly visible. The package must already be pushed and
owned by your tenant; publishing deploys nothing new.

Making a version public is immutable — you cannot unpublish or overwrite it.
Iterate privately with "axiom push" (which may overwrite the same version),
then publish when you are satisfied.

```text
axiom publish my-handle/my-package@0.1.0
axiom publish my-handle/my-package@0.1.0 --yes   # skip the prompt (CI)
```

Requires a prior "axiom login".

## Usage

```sh
axiom publish <package>@<version> [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for publish |
| `--yes` | `-y` | bool |  | Skip the confirmation prompt (for CI and scripted use) |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages