---
title: "axiom propose"
description: "Propose a new package, node, or flow for the Axiom 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 propose

Propose a new package, node, or flow for the Axiom marketplace

Ask the Axiom team to build a marketplace artifact that does not exist yet.

```text
axiom propose node    "refund a Stripe charge by id, returning the refund"
axiom propose package "first-class Notion connector (query + append)"
axiom propose flow    "new-signup onboarding: create user, email, seed workspace"
```

Use --details for the longer shape (inputs/outputs, an example), and --for to
point at an existing artifact the proposal is against (e.g. "add pagination to
this package"):

```text
axiom propose node "add pagination" --for acme/notion \
  --details "page through database rows with a cursor"
```

The summary may be given as arguments or piped on stdin. Proposals go to the
Axiom review queue. Requires a prior "axiom login".

## Usage

```sh
axiom propose <package|node|flow> [summary] [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--details` | `-d` | string |  | Longer description (inputs/outputs, an example) appended to the summary |
| `--for` |  | string |  | An existing artifact the proposal is against (e.g. handle/package) |
| `--help` | `-h` | bool |  | help for propose |
| `--json` |  | bool |  | Print the persisted submission as JSON |

## See also

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