---
title: "axiom memory search"
description: "Semantic search over memories for a flow"
category: reference
surfaces: [cli]
related: [reference/cli/axiom-memory, guides/inspect-agent-memory]
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 memory search

Semantic search over memories for a flow

Performs a semantic/hybrid search over all memories associated with a flow.

The --flow flag is required. Results are printed as a table with
content, importance score, and retrieval score.

Example:
```text
axiom memory search --flow my-flow-id "preferred output format"
```

## Usage

```sh
axiom memory search --flow <flow-id> <query> [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--flow` |  | string |  | flow ID to search within (required) |
| `--help` | `-h` | bool |  | help for search |

## See also

- [axiom memory](./axiom-memory.md) — Inspect and manage agent memory for your flows
- Guide: [Inspect agent memory](../../guides/inspect-agent-memory.md)