> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praxa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI recipes

> Use the Praxa CLI for clean-install verification, Gateway diagnosis, mission operation, and read-only memory planning.

## Verify the public package

```bash theme={null}
npx --package=@praxa/cli@0.3.0 praxa version
```

The command must report CLI version <code>0.3.0</code>. It does not prove that
a Gateway is deployed or that your token is valid.

## Diagnose a Gateway

```bash theme={null}
export PRAXA_BASE_URL="https://gateway.example.com"
export PRAXA_ACCESS_TOKEN="<short-lived delegated token>"
npx --package=@praxa/cli@0.3.0 praxa doctor
```

## Submit and inspect a mission

```bash theme={null}
praxa mission submit \
  --intent "Prepare a governed deployment plan" \
  --idempotency-key "deployment-plan-2026-08-14"

praxa mission get --run-id "<run-id>"
```

Reuse the stable key when retrying the same logical submission.

## Plan memory federation locally

```bash theme={null}
praxa memory source add mem0 \
  --mode federated \
  --dry-run

praxa memory sync plan --dry-run
```

The plan stores or previews local metadata only. It does not connect to Mem0,
import records, mirror data, or execute a cutover.