Enum Command 

pub enum Command {
    Serve(ServeArgs),
    Mcp {
        tier: String,
        profile: Option<String>,
    },
    Store(StoreArgs),
    Update(UpdateArgs),
    Recall(RecallArgs),
    Search(SearchArgs),
    Get(GetArgs),
    List(ListArgs),
    Delete(DeleteArgs),
    Promote(PromoteArgs),
    Forget(ForgetArgs),
    Link(LinkArgs),
    Consolidate(ConsolidateArgs),
    Gc,
    Stats,
    Namespaces,
    Export,
    Import(ImportArgs),
    Resolve(ResolveArgs),
    Shell,
    Sync(SyncArgs),
    SyncDaemon(SyncDaemonArgs),
    AutoConsolidate(AutoConsolidateArgs),
    Completions(CompletionsArgs),
    Man,
    Mine(MineArgs),
    Archive(ArchiveArgs),
    Agents(AgentsArgs),
    Pending(PendingArgs),
    Backup(BackupArgs),
    Restore(RestoreArgs),
    Curator(CuratorArgs),
    Bench(BenchArgs),
    Doctor(DoctorCliArgs),
    Boot(BootArgs),
    Install(InstallArgs),
    Wrap(WrapArgs),
    Logs(LogsArgs),
    Audit(AuditArgs),
}

Variants

Serve(ServeArgs)

Start the HTTP memory daemon

Mcp

Run as an MCP (Model Context Protocol) tool server over stdio

Fields

tier: String

Feature tier: keyword (FTS only) or semantic (embeddings + FTS)

profile: Option<String>

v0.6.4 — Tool surface profile. One of core, graph, admin, power, full, or a comma-separated custom list (e.g., core,graph,archive). Default core (5 tools). Resolution order: this CLI flag > AI_MEMORY_PROFILE env > [mcp].profile in config.toml > core. Set --profile full to reproduce v0.6.3 surface 1:1 (43 tools).

Store(StoreArgs)

Store a new memory

Update(UpdateArgs)

Update an existing memory by ID

Recall(RecallArgs)

Recall memories relevant to a context

Search(SearchArgs)

Search memories by text

Get(GetArgs)

Retrieve a memory by ID

List(ListArgs)

List memories

Delete(DeleteArgs)

Delete a memory by ID

Promote(PromoteArgs)

Promote a memory to long-term

Forget(ForgetArgs)

Delete memories matching a pattern

Link(LinkArgs)

Link two memories

Consolidate(ConsolidateArgs)

Consolidate multiple memories into one

Gc

Run garbage collection

Stats

Show statistics

Namespaces

List all namespaces

Export

Export all memories as JSON

Import(ImportArgs)

Import memories from JSON (stdin)

Resolve(ResolveArgs)

Resolve a contradiction — mark one memory as superseding another

Shell

Interactive memory shell (REPL)

Sync(SyncArgs)

Sync memories between two database files

SyncDaemon(SyncDaemonArgs)

Run the peer-to-peer sync daemon — continuously exchange memories with one or more HTTP peers (Phase 3 Task 3b.1). The defining grand-slam capability: two agents on two machines form a live knowledge mesh with no cloud, no login, no SaaS.

AutoConsolidate(AutoConsolidateArgs)

Auto-consolidate short-term memories by namespace

Completions(CompletionsArgs)

Generate shell completions

Man

Generate man page

Mine(MineArgs)

Import memories from historical conversations (Claude, ChatGPT, Slack exports)

Archive(ArchiveArgs)

Manage the memory archive (list, restore, purge, stats)

Agents(AgentsArgs)

Register or list agents (Task 1.3)

Pending(PendingArgs)

List / approve / reject governance-pending actions (Task 1.9)

Backup(BackupArgs)

v0.6.0.0: snapshot the SQLite database to a timestamped backup file. Uses SQLite VACUUM INTO which is hot-backup safe (no daemon stop required). Writes a manifest.json alongside (sha256 + version).

Restore(RestoreArgs)

v0.6.0.0: restore the SQLite database from a backup file written by ai-memory backup. Verifies the manifest sha256 before replacing the current DB. The current DB is moved aside as a safety net before the replacement.

Curator(CuratorArgs)

v0.6.1: run the autonomous curator. --once runs a single sweep and prints a JSON report; --daemon loops with --interval-secs between cycles. Auto-tags memories without tags and flags contradictions against nearby siblings in the same namespace.

Bench(BenchArgs)

v0.6.3 (Pillar 3 / Stream E): run the canonical performance workload and print measured p50/p95/p99 against the budgets in PERFORMANCE.md. Each invocation seeds a disposable temp DB so the user’s main DB is untouched. Exits non-zero when any p95 exceeds its budget by more than the published 10% tolerance.

Doctor(DoctorCliArgs)

v0.6.3.1 (P7 / R7): operator-visible health dashboard. Reads Capabilities v2 (P1) + data integrity surfaces (P2) + recall observability (P3). With --remote <url> becomes a fleet doctor at T3+. Read-only — never mutates the database. Exits 0 on a healthy report, 2 on critical findings, and 1 on warnings when --fail-on-warn is passed.

Boot(BootArgs)

Issue #487: emit session-boot context. Universal primitive every AI-agent integration recipe (Claude Code SessionStart hook, Cursor / Cline / Continue / Windsurf system-message, Codex / Apps SDK / Agent SDK programmatic prepend, OpenClaw built-in, local models via LM Studio / Ollama / vLLM) calls before the agent’s first turn. Read-only, fast, never blocks. With --quiet (recommended for hooks) a missing DB exits 0 with empty stdout.

Install(InstallArgs)

Issue #487 PR-2: wire ai-memory boot and the ai-memory-mcp server into AI agents’ config files (Claude Code SessionStart hook, Cursor / Cline / Continue / Windsurf / OpenClaw MCP config). Default is --dry-run (prints the diff, writes nothing). Pass --apply to commit. Pass --uninstall --apply to remove a previously-installed managed block.

Wrap(WrapArgs)

Issue #487 PR-6: cross-platform Rust replacement for the bash / PowerShell wrappers PR-1 shipped in the integration recipes. Runs ai-memory boot in-process, builds a system message, then spawns the named agent CLI with the system message delivered via the strategy chosen by default_strategy(<agent>) (or an explicit --system-flag / --system-env / --message-file-flag override). Exit code is propagated from the wrapped agent.

Logs(LogsArgs)

Issue #487 PR-5: operator-facing CLI for the operational logging facility (tail, cat, archive, purge). Default-OFF — emits nothing useful unless [logging] enabled = true is set in config.toml.

Audit(AuditArgs)

Issue #487 PR-5: operator-facing CLI for the security audit trail (verify, tail, path). Default-OFF — emits nothing useful unless [audit] enabled = true is set in config.toml.

Trait Implementations

impl FromArgMatches for Command

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Command

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand