---
title: "axiom test"
description: "Run language-native tests with axiom validation"
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 test

Run language-native tests with axiom validation

Run the language-native test suite after validating the axiom package.

Steps:
```text
1. Compile proto bindings  (axiom generate)
2. Validate package        (axiom validate — fail fast on errors)
3. Run tests               (language-native runner, output streamed live)
```

Exit code mirrors the test runner exit code.

Pass extra arguments to the native runner after --:
```text
axiom test -- -v                      (Go: verbose output)
axiom test -- -run TestProcessOrder   (Go: run a specific test)
axiom test -- -k test_process_order   (Python: filter by name)
axiom test -- --testNamePattern Foo   (TypeScript: filter by name)
```

## Usage

```sh
axiom test [-- <native-args>] [flags]
```

## Flags

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

## 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)