---
title: "axiom pin"
description: "Pin a node or flow as a favorite tool"
category: reference
surfaces: [cli]
related: [reference/cli/axiom, reference/cli/axiom-pin-flow, reference/cli/axiom-pin-node]
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 pin

Pin a node or flow as a favorite tool

Pin a published node or compiled flow as a favorite.

Pins live in your tenant+client's shared tool store — the SAME store the hosted
Axiom MCP server reads — so a tool pinned here surfaces as a first-class typed
tool there too, and vice versa.

```text
axiom pin node nadia/summarizer/Summarize@0.1.0
axiom pin flow 01HQY5K7XWZ6N8R2BTEF4...
```

Pinning is idempotent: re-pinning an already-pinned target is a no-op.

Requires a prior "axiom login" (pins are scoped to your identity).

## Usage

```sh
axiom pin [flags]
axiom pin [command]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for pin |

## Subcommands

| Command | Description |
|---|---|
| [axiom pin flow](./axiom-pin-flow.md) | Pin a flow as a favorite tool |
| [axiom pin node](./axiom-pin-node.md) | Pin a node as a favorite tool |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages
- [axiom pin flow](./axiom-pin-flow.md) — Pin a flow as a favorite tool
- [axiom pin node](./axiom-pin-node.md) — Pin a node as a favorite tool