CLI recipes - Praxa

Verify the public package

npx --package=@praxa/cli@0.3.0 praxa version

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

Diagnose a Gateway

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

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

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.

Last modified on August 14, 2026