---
title: "axiom feedback"
description: "Send Axiom a bug report, feature request, or general feedback"
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 feedback

Send Axiom a bug report, feature request, or general feedback

Send the Axiom team feedback about the product itself.

```text
axiom feedback bug      "the flow canvas loses my selection when I scroll"
axiom feedback feature  "let me pin a node's output panel while I edit others"
axiom feedback general  "marketplace search is great — I just forget to use it"
```

The message may be given as arguments or piped on stdin:

```text
echo "…" | axiom feedback bug
```

For a BUG against a marketplace artifact you CONSUMED (not authored) — a
package, node, or flow you called and hit a defect in — file a structured
report so it isn't lost in a run transcript. --workaround is required
whenever --package is set: report on the workaround, not just the failure,
because a workaround is simultaneously evidence the bug exists and the
thing that quietly hides it.

```text
axiom feedback bug "FetchJSON panics on an empty url" \
  --package christian/http-tools@1.2.3 --node FetchJSON \
  --workaround "validated the URL client-side before calling the node" \
  --error-file err.txt --repro-file repro.txt
```

To ask for a marketplace artifact that does not exist yet — a package, node, or
flow — use "axiom propose" instead. Requires a prior "axiom login".

## Usage

```sh
axiom feedback <bug|feature|general> [message] [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--error-file` |  | string |  | Structured bug report only: path to a file with the verbatim error text |
| `--help` | `-h` | bool |  | help for feedback |
| `--json` |  | bool |  | Print the persisted submission as JSON |
| `--node` |  | string |  | Structured bug report only: which node inside --package the defect is in |
| `--package` |  | string |  | Structured bug report only: the consumed artifact, "scope/name@version" |
| `--repro-file` |  | string |  | Structured bug report only: path to a file with the minimal repro |
| `--workaround` |  | string |  | Structured bug report only: what you did to route around the defect (required with --package) |

## See also

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