---
title: "axiom validate"
description: "Validate axiom.yaml, proto definitions, and node signatures"
category: reference
surfaces: [cli]
related: [reference/cli/axiom, guides/create-a-node-python, guides/create-a-node-go, guides/create-a-node-typescript, guides/create-a-node-rust, guides/create-a-node-java, guides/create-a-node-csharp]
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 validate

Validate axiom.yaml, proto definitions, and node signatures

Validate the current axiom package across three layers:

```text
1. axiom.yaml schema    — required fields, semver format, language, message references
2. Proto definitions    — all .proto files in messages/ compile without errors
3. Node signatures      — each node has an implementation with the expected function signature
```

Run automatically as part of: axiom build, axiom publish.

## Usage

```sh
axiom validate [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for validate |
| `--json` |  | bool |  | Emit structured JSON instead of human-readable output |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages
- Guide: [Create a node (Python)](../../guides/create-a-node-python.md)
- Guide: [Create a node (Go)](../../guides/create-a-node-go.md)
- Guide: [Create a node (TypeScript)](../../guides/create-a-node-typescript.md)
- Guide: [Create a node (Rust)](../../guides/create-a-node-rust.md)
- Guide: [Create a node (Java)](../../guides/create-a-node-java.md)
- Guide: [Create a node (C#)](../../guides/create-a-node-csharp.md)