Skip to main content

CLI reference

The mnemom CLI manages authentication, alignment cards, protection cards, and agent diagnostics for the Mnemom trust stack.

Installation

Authentication

Organizations

Card commands

Protection commands

Agent listing

mnemom agents

List all agents associated with your authenticated account.
Example output:
Requires authentication via mnemom login. Agents are auto-created by the gateway on first API call — there is no registration step.

mnemom agents claim <id-or-name>

Claim a gateway-provisioned agent into an org by proving you hold its provider key. See the Agent Claim Flow guide for the full lifecycle.
  • --org <slug|id> — destination org. Defaults to your personal org (with a loud notice) when omitted.
  • --key <key> — the agent’s provider API key; the CLI derives the hash_proof locally. Alternatively pass --hash-proof <64-hex> directly.
To re-home an agent, re-claim it with a new --org (possession-based: requires the agent’s key). The destination org’s template can floor/cap the agent’s composed card — its effective posture may change. See Idempotency and re-homing.

Diagnostics

License

Global options

Agent selection

Commands that operate on an agent use this priority to determine which agent:
  1. --agent <name> flag (highest priority)
  2. MNEMOM_AGENT environment variable
There is no default agent concept. If neither --agent nor MNEMOM_AGENT is set, the CLI will prompt you to specify one (or error in non-interactive mode). Environment: Set MNEMOM_ENV to control which environment the CLI targets: Example:

Workflow

A typical workflow with the mnemom CLI:

Supported providers

The gateway supports tracing for these providers:

See also