Enum Commands 

pub enum Commands {
    Sense {
        uri: String,
        id: Option<String>,
    },
    Taste {
        uri: String,
        verdict: Option<TasteVerdict>,
        notes: Option<String>,
        synapse: Option<String>,
        synapse_token_secret: Option<String>,
        domain: Option<String>,
    },
    Spawn {
        uri: String,
        directory: Option<String>,
        vcs: Option<VcsArg>,
        dist: Option<DistArg>,
        bond: bool,
    },
    Grow {
        dist: Option<DistArg>,
        synapse: Option<String>,
        synapse_token_secret: Option<String>,
        bond: bool,
    },
    Absorb {
        uris: Vec<String>,
        discover: bool,
        synapse: Option<String>,
        synapse_token_secret: Option<String>,
        max_depth: u32,
    },
    Bond {
        clean: bool,
        status: bool,
    },
    Replicate {
        uris: Vec<String>,
        refs: bool,
        domain: String,
        site_path: Option<String>,
    },
    Hatch {
        id: Option<String>,
        version: Option<String>,
        name: Option<String>,
        domain: Option<String>,
        synopsis: Option<String>,
        intent: Vec<String>,
        mutations: Vec<String>,
        license: Option<String>,
        command: Option<HatchCommands>,
    },
    Release {
        domain: String,
        source: Option<String>,
        site_path: Option<String>,
        dist_git: Option<String>,
        dist_ref: Option<String>,
        archive: String,
        dry_run: bool,
    },
    Lineage {
        uri: String,
        direction: Option<DirectionArg>,
        synapse: Option<String>,
        synapse_token_secret: Option<String>,
        max_depth: u32,
    },
    Search {
        query: String,
        synapse: Option<String>,
        synapse_token_secret: Option<String>,
        domain: Option<String>,
        license: Option<String>,
        bonds: Option<String>,
        limit: u32,
    },
    Mycelium {
        action: MyceliumAction,
    },
    Synapse {
        action: SynapseAction,
    },
    Cache {
        action: CacheAction,
    },
    Config {
        action: ConfigAction,
    },
    Skill {
        action: SkillCommand,
    },
}

Variants

Sense

Resolve a CMN URI and show metadata without downloading

Fields

uri: String

CMN URI (cmn://DOMAIN or cmn://DOMAIN/HASH)

id: Option<String>

Spore id to resolve from the domain’s latest mycelium inventory

Taste

Evaluate spore: download for review, or record a verdict

Fields

uri: String

CMN URI (e.g., cmn://cmn.dev/HASH)

verdict: Option<TasteVerdict>

Record verdict: sweet, fresh, safe, rotten, or toxic

notes: Option<String>

Notes about the verdict

synapse: Option<String>

Synapse URL to pull/share taste reports

synapse_token_secret: Option<String>

Auth token for synapse (overrides configured token)

domain: Option<String>

Domain to sign report with (requires –synapse and –verdict)

Spawn

Create a working copy of a spore (auto-detects best distribution format)

Fields

uri: String

CMN URI (e.g., cmn://cmn.dev/HASH)

directory: Option<String>

Target directory (default: ./)

vcs: Option<VcsArg>

Initialize version control after spawn (e.g., –vcs git)

dist: Option<DistArg>

Preferred distribution source: archive (default) or git

bond: bool

Fetch bonds after spawn

Grow

Pull latest changes from spawn source via Synapse lineage

Fields

dist: Option<DistArg>

Override distribution source: archive or git

synapse: Option<String>

Synapse to query for updates (domain or URL)

synapse_token_secret: Option<String>

Auth token for synapse (overrides configured token)

bond: bool

Also check depends_on/follows/extends bonds for updates via Synapse lineage, and fetch all bonds to .cmn/bonds/

Absorb

Prepare spores for AI-assisted merge

Fields

uris: Vec<String>

CMN URIs to absorb (e.g., cmn://cmn.dev/HASH)

discover: bool

Auto-discover descendants from current spore’s spawned_from bonds

synapse: Option<String>

Synapse server URL (required with –discover)

synapse_token_secret: Option<String>

Auth token for synapse (overrides configured token)

max_depth: u32

Maximum depth for lineage discovery (default: 10)

Bond

Fetch all bonds from spore.core.json to .cmn/bonds/

Fields

clean: bool

Clean orphaned bonds not in spore.core.json

status: bool

Show bond status without fetching

Replicate

Copy a spore to your domain (same hash, re-signed capsule)

Fields

uris: Vec<String>

CMN URI(s) to replicate

refs: bool

Replicate all non-self bonds from spore.core.json

domain: String

Target domain (required)

site_path: Option<String>

Custom site directory

Hatch

Create or update spore.core.json in working directory

Fields

id: Option<String>

Opaque identifier stored in spore.core.json

version: Option<String>

Version string (e.g., 1.0.0)

name: Option<String>

Display name

domain: Option<String>

Publisher domain

synopsis: Option<String>

Short description

intent: Vec<String>

Why this spore exists — permanent across releases (repeatable)

mutations: Vec<String>

What changed relative to the spawned-from parent (repeatable)

license: Option<String>

License (SPDX identifier)

command: Option<HatchCommands>

Release

Sign and publish spore to mycelium site

Fields

domain: String

Target domain (required)

source: Option<String>

Spore source directory (default: current directory)

site_path: Option<String>

Custom site directory (default: ~/.cmn/mycelium/)

dist_git: Option<String>

External git repository URL

dist_ref: Option<String>

Git ref: tag/branch/commit (requires –dist-git)

archive: String

Archive format for release generation (currently only: zstd)

dry_run: bool

Pre-compute URI without writing any files

Lineage

Trace spore lineage: descendants (in, default) or ancestors (out)

Fields

uri: String

CMN URI (e.g., cmn://cmn.dev/HASH)

direction: Option<DirectionArg>

Direction: in (descendants, default) or out (ancestors)

synapse: Option<String>

Synapse server (domain or URL, default: configured default)

synapse_token_secret: Option<String>

Auth token for synapse (overrides configured token)

max_depth: u32

Maximum traversal depth (default: 10)

Search

Search for spores by keyword (semantic search via Synapse)

Fields

query: String

Search query text

synapse: Option<String>

Synapse server (domain or URL, default: configured default)

synapse_token_secret: Option<String>

Auth token for synapse (overrides configured token)

domain: Option<String>

Filter by domain

license: Option<String>

Filter by license (SPDX identifier)

bonds: Option<String>

Filter by bond relationship (format: relation:uri, comma-separated for AND)

limit: u32

Maximum results (default: 20)

Mycelium

Manage local mycelium site

Fields

action: MyceliumAction

Synapse

Manage Synapse node connections

Fields

action: SynapseAction

Cache

Manage local cache

Fields

action: CacheAction

Config

View or modify hypha configuration

Fields

action: ConfigAction

Skill

Install, uninstall, or inspect the bundled Hypha agent skill

Fields

action: SkillCommand

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 Serialize for Commands

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

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