Enum Commands 

pub enum Commands {
    Init(InitArgs),
    Remember(RememberArgs),
    RememberBatch(RememberBatchArgs),
    Ingest(Box<IngestArgs>),
    Recall(RecallArgs),
    Read(ReadArgs),
    List(ListArgs),
    Forget(ForgetArgs),
    Purge(PurgeArgs),
    Rename(RenameArgs),
    SplitBody(SplitBodyArgs),
    Edit(EditArgs),
    History(HistoryArgs),
    Restore(RestoreArgs),
    HybridSearch(HybridSearchArgs),
    Health(HealthArgs),
    Migrate(MigrateArgs),
    NamespaceDetect(NamespaceDetectArgs),
    Optimize(OptimizeArgs),
    Stats(StatsArgs),
    SyncSafeCopy(SyncSafeCopyArgs),
    Backup(BackupArgs),
    Vacuum(VacuumArgs),
    Link(LinkArgs),
    Unlink(UnlinkArgs),
    DeepResearch(DeepResearchArgs),
    Related(RelatedArgs),
    Graph(GraphArgs),
    Export(ExportArgs),
    Fts(FtsArgs),
    Vec(VecArgs),
    CodexModels(CodexModelsArgs),
    PruneRelations(PruneRelationsArgs),
    PruneNer(PruneNerArgs),
    Slots(SlotsArgs),
    Pending(PendingArgs),
    Embedding(EmbeddingArgs),
    PendingEmbeddings(PendingEmbeddingsArgs),
    CleanupOrphans(CleanupOrphansArgs),
    MemoryEntities(MemoryEntitiesArgs),
    Cache(CacheArgs),
    DeleteEntity(DeleteEntityArgs),
    Reclassify(ReclassifyArgs),
    RenameEntity(RenameEntityArgs),
    MergeEntities(MergeEntitiesArgs),
    Enrich(Box<EnrichArgs>),
    ReclassifyRelation(ReclassifyRelationArgs),
    NormalizeEntities(NormalizeEntitiesArgs),
    Completions(CompletionsArgs),
    DebugSchema(DebugSchemaArgs),
    Config(ConfigArgs),
}

Variants

Init(InitArgs)

Initialize database and download embedding model

Remember(RememberArgs)

Save a memory with optional entity graph

RememberBatch(RememberBatchArgs)

Batch-create memories from NDJSON stdin (one invocation, one slot)

Ingest(Box<IngestArgs>)

Bulk-ingest every file under a directory as separate memories (NDJSON output)

Recall(RecallArgs)

Search memories semantically

Read(ReadArgs)

Read a memory by exact name

List(ListArgs)

List memories with filters

Forget(ForgetArgs)

Soft-delete a memory

Purge(PurgeArgs)

Permanently delete soft-deleted memories

Rename(RenameArgs)

Rename a memory preserving history

SplitBody(SplitBodyArgs)

Split an oversized memory body into N child memories (v1.1.03, GAP-V8)

Edit(EditArgs)

Edit a memory’s body or description

History(HistoryArgs)

List all versions of a memory

Restore(RestoreArgs)

Restore a memory to a previous version

HybridSearch(HybridSearchArgs)

Search using hybrid vector + full-text search

Health(HealthArgs)

Show database health

Migrate(MigrateArgs)

Apply pending schema migrations

NamespaceDetect(NamespaceDetectArgs)

Resolve namespace precedence for the current invocation

Optimize(OptimizeArgs)

Run PRAGMA optimize on the database

Stats(StatsArgs)

Show database statistics

SyncSafeCopy(SyncSafeCopyArgs)

Create a checkpointed copy safe for file sync

Backup(BackupArgs)

Back up the database using the SQLite Online Backup API

Vacuum(VacuumArgs)

Run VACUUM after checkpointing the WAL

Link(LinkArgs)

Create an explicit relationship between two entities

Unlink(UnlinkArgs)

Remove a specific relationship between two entities

DeepResearch(DeepResearchArgs)

Deep parallel multi-hop GraphRAG research

Related(RelatedArgs)

List memories connected via the entity graph

Graph(GraphArgs)

Export a graph snapshot in json, dot or mermaid

Export(ExportArgs)

Export memories as NDJSON (one JSON line per memory, plus a summary line)

Fts(FtsArgs)

FTS5 full-text search index management (rebuild or check)

Vec(VecArgs)

Vector index maintenance (orphan detection, purge, stats) — G39

CodexModels(CodexModelsArgs)

List codex OAuth models accepted by ChatGPT Pro (G33).

GAP-E2E-010 (v1.0.89): accepts --json as a no-op (JSON is always emitted on stdout) so the flag never breaks agent pipelines that append --json to every invocation.

PruneRelations(PruneRelationsArgs)

Bulk-delete all relationships of a given type (e.g. mentions)

PruneNer(PruneNerArgs)

Remove NER bindings (memory_entities rows) for an entity or all entities

Slots(SlotsArgs)

Inspect and manage cross-process LLM slot semaphore (GAP-004, v1.0.82)

Pending(PendingArgs)

Inspect and manage the remember checkpoint queue (GAP-001, v1.0.82)

Embedding(EmbeddingArgs)

Health and per-entry inspection of the pending-embeddings queue (GAP-005, v1.0.82)

PendingEmbeddings(PendingEmbeddingsArgs)

Batch operations over the pending-embeddings queue (GAP-005, v1.0.82)

CleanupOrphans(CleanupOrphansArgs)

Remove entities that have no memories and no relationships

MemoryEntities(MemoryEntitiesArgs)

List entities linked to a specific memory

Cache(CacheArgs)

Manage cached resources (embedding models, etc.)

DeleteEntity(DeleteEntityArgs)

Delete an entity and all its relationships from the graph

Reclassify(ReclassifyArgs)

Reclassify one entity or a batch of entities to a new type

RenameEntity(RenameEntityArgs)

Rename an entity preserving all relationships and memory bindings

MergeEntities(MergeEntitiesArgs)

Merge multiple source entities into a single target entity

Enrich(Box<EnrichArgs>)

Enrich graph memories and entities using an LLM provider

ReclassifyRelation(ReclassifyRelationArgs)

Reclassify relationship types across the graph using rules or LLM judgment

NormalizeEntities(NormalizeEntitiesArgs)

Normalize entity names (deduplicate, kebab-case, merge near-duplicates)

Completions(CompletionsArgs)

Generate shell completions for Bash, Zsh, Fish, PowerShell, or Elvish

DebugSchema(DebugSchemaArgs)

Config(ConfigArgs)

Manage API keys and diagnose provider configuration (v1.0.93)

Implementations

impl Commands

pub fn is_embedding_heavy(&self) -> bool

Returns true for subcommands that load the ONNX model locally.

pub fn uses_cli_slot(&self) -> bool

pub fn tolerates_missing_embedding_key(&self) -> bool

Read-only / no-embedding subcommands that MUST run without an embedding API key. init warms a best-effort smoke test internally and degrades to ok_no_embedding when the backend is unreachable; the enrich queue inspectors (--status / --list-dead / --requeue-dead / --prune-dead-orphans) never embed and never call the LLM. The eager OpenRouter key preflight in main must skip its hard-fail for these.

Trait Implementations

impl Debug for Commands

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Commands

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 Commands

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