Enum Commands 

pub enum Commands {
    Recall {
        query: String,
        budget: usize,
        top: Option<usize>,
        format: String,
        include_sparks: bool,
        expand_deps: String,
        allow_trim: bool,
        refine_mode: String,
        source: String,
    },
    Record {

        trace_id: String,
        query: Option<String>,
        outcome: Option<String>,
        used: Option<String>,
        used_attribution: String,
        used_partial: bool,
        output: Option<String>,
        output_summary: Option<String>,
        nomination: Option<String>,
        source: String,
        feedback: Option<String>,
        feedback_kind: String,
        feedback_actor: Option<String>,
        feedback_reason: Option<String>,
        task_state: Option<String>,
        priority: i64,
    
},
    Add {
        content: String,
        kind: String,
        trigger: Option<String>,
        anti_trigger: Option<String>,
        source: String,
        skill_name: Option<String>,
        depends_on: Vec<String>,
        dep_kind: String,
    },
    Spark {
        content: String,
        trigger: Option<String>,
    },
    Evolve {
        trigger: String,
        rebuild_embeddings: bool,
    },
    Inspect {
        id: Option<String>,
    },
    Approve {
        chunk_id: String,
    },
    Archive {
        chunk_id: String,
        reason: String,
    },
    Invalidate {
        chunk_id: String,
        reason: String,
    },
    Restore {
        chunk_id: String,
    },
    MatureSpark {
        spark_id: String,
        to: String,
    },
    PromoteSpark {
        spark_id: String,
        to: String,
    },
    DropSpark {
        spark_id: String,
        reason: String,
    },
    Backup {
        action: BackupCommands,
    },
    Install,
    Uninstall {
        yes: bool,
        purge_data: bool,
    },
    Migrate,
    Vacuum,
    Upgrade {
        version: Option<String>,
        check: bool,
    },
    Daemon {
        action: DaemonCommands,
    },
    Mcp,
    Web {
        bind: String,
        port: u16,
        no_token: bool,
        allow_remote: bool,
    },
    Hook {
        action: HookCommands,
    },
}

Variants

Recall

Search the knowledge base

Fields

query: String

budget: usize

top: Option<usize>

format: String

include_sparks: bool

expand_deps: String

Dependency expansion: false (default) | direct | closure

allow_trim: bool

Allow Refiner to trim blocks that don’t fit the budget

refine_mode: String

Refine mode written to usage_trace: off (default) | trim | adapt

source: String

Event source written to usage_trace (mcp | sdk | cli | hook | daemon | augmented)

Record

Close a trace with outcome

Fields

trace_id: String

query: Option<String>

outcome: Option<String>

used: Option<String>

Comma-separated chunk ids. An explicit empty value means “known none”.

used_attribution: String

used_partial: bool

Treat –used as partial attribution; omitted selected chunks are not penalized.

output: Option<String>

output_summary: Option<String>

nomination: Option<String>

source: String

feedback: Option<String>

Explicit feedback: up or down (applied to –used chunks if provided)

feedback_kind: String

feedback_actor: Option<String>

feedback_reason: Option<String>

task_state: Option<String>

priority: i64

Add

Add a knowledge chunk

Fields

content: String

kind: String

trigger: Option<String>

anti_trigger: Option<String>

source: String

skill_name: Option<String>

depends_on: Vec<String>

Declare a dependency on another chunk id (repeatable).

dep_kind: String

Dependency kind for –depends-on: hard (fail-closed) or soft (bonus).

Spark

Capture a spark (idea)

Fields

content: String

trigger: Option<String>

Evolve

Distil logs + curate

Fields

trigger: String

rebuild_embeddings: bool

Rebuild embeddings for chunks with embed_version=0 or < meta.embed_version

Inspect

Health check — no arg = library summary; chunk_id or trace_id = detail view

Fields

id: Option<String>

Approve

Approve a pending chunk

Fields

chunk_id: String

Archive

Archive a chunk

Fields

chunk_id: String

reason: String

Invalidate

Invalidate a chunk

Fields

chunk_id: String

reason: String

Restore

Restore an archived chunk

Fields

chunk_id: String

MatureSpark

Mature a spark

Fields

spark_id: String

to: String

PromoteSpark

Promote a spark to knowledge

Fields

spark_id: String

to: String

DropSpark

Drop a spark

Fields

spark_id: String

reason: String

Backup

Backup the database to Cloudflare R2

Fields

action: BackupCommands

Install

Interactive setup wizard — configure agents to use Innate MCP server

Uninstall

Remove Innate from all configured agents and PATH

Fields

yes: bool

Skip confirmation prompts

purge_data: bool

Also delete knowledge data (~/.innate/). Cannot be undone.

Migrate

Upgrade database schema to current version

Vacuum

Reclaim disk space: checkpoint the WAL and VACUUM the database

Upgrade

Upgrade the innate binary to the latest (or specified) release

Fields

version: Option<String>

Install this specific version, e.g. 0.3.0 or v0.3.0 (default: latest)

check: bool

Only report whether an upgrade is available; do not install

Daemon

Daemon control (Linux only)

Fields

action: DaemonCommands

Mcp

Start MCP stdio server

Web

Start a local web UI to view and govern the knowledge base

Fields

bind: String

Address to bind (localhost only by default; exposing beyond is unsafe)

port: u16

Port to listen on

no_token: bool

Disable the governance auth token (NOT recommended; leaves writes unauthenticated)

allow_remote: bool

Required to bind a non-loopback address. Exposes the knowledge base to the network; the auth token then gates reads as well as writes.

Hook

Agent hook handlers (called by agent hooks; reads payload from stdin)

Fields

action: HookCommands

Trait Implementations

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