Enum IdentityCommand 

pub enum IdentityCommand {
    Rename {
        name: Option<String>,
        emoji: Option<String>,
        clear: bool,
        random: bool,
        json: bool,
    },
    Show {
        json: bool,
    },
    List {
        json: bool,
    },
    Publish {
        nick: String,
        relay: Option<String>,
        public_url: Option<String>,
        hidden: bool,
        json: bool,
    },
    Destroy {
        name: String,
        force: bool,
        json: bool,
    },
    Create {
        name: Option<String>,
        anonymous: bool,
        local: bool,
        json: bool,
    },
    Persist {
        name: String,
        as_name: Option<String>,
        json: bool,
    },
    Demote {
        name: String,
        json: bool,
    },
}

Variants

Rename

Override the auto-derived nickname and/or emoji. Persists to <WIRE_HOME>/config/wire/display.json. Local-only; peers still see the auto-derived character from your DID (until federation publishes overrides in a future release).

Examples: wire identity rename –name foxtrot-meadow –emoji 🦊 wire identity rename –emoji 🐉 (keep auto nickname) wire identity rename –random (re-roll auto from seed; clears overrides)

Fields

name: Option<String>

New nickname (any non-empty string; convention is adjective-noun, e.g. foxtrot-meadow). Omit to leave nickname at its current value (auto-derived unless previously set).

emoji: Option<String>

New emoji glyph. Any single grapheme; the curated set is recommended for cross-terminal compatibility.

clear: bool

Clear all overrides; revert to auto-derived from DID hash. Mutually exclusive with --name / --emoji.

random: bool

Re-roll: alias for --clear plus an explanatory stderr line. Auto-derived is itself deterministic, so this just removes any previously-set override.

json: bool

Show

Print the current character (auto-derived OR override). Equivalent to wire whoami --short but scoped here for grouping.

Fields

json: bool

List

List all identities on this machine — one row per session, with each session’s character, DID, federation handle, and cwd. Same shape as wire session list, scoped here for the v0.7+ noun- CLI surface.

Fields

json: bool

Publish

Promote this identity to FEDERATION lifecycle: claim a handle on the relay so peers can wire add <name>@<relay-domain> you. Re-claims with current display fields (after wire identity rename) so the relay always serves the latest signed card. Equivalent to wire claim but scoped here for the v0.7+ noun-CLI surface.

Fields

nick: String

The handle to claim on the relay (e.g. coffee-ghost).

relay: Option<String>

Override the relay URL. Defaults to the session’s bound relay from wire init --relay <url>. Public relay if unset.

public_url: Option<String>

Public-facing URL for the agent-card location (when the relay is behind a CDN with a different public domain).

hidden: bool

Skip listing in the relay’s public phonebook. The card is still claimable + reachable; just doesn’t appear in wireup.net/phonebook for stranger-discovery.

json: bool

Destroy

Destroy a session entirely — keys, agent-card, relay state, daemon. Equivalent to wire session destroy <name>, scoped here for the noun-CLI surface. Requires --force (the underlying command does).

Fields

name: String

Session name to destroy (use wire identity list to see).

force: bool

Bypass the confirmation prompt.

json: bool

Create

Create an identity in an EXPLICIT lifecycle state (vs. the implicit wire init + wire claim flow). v0.7.0-alpha.20 closes the v0.7+ identity-first noun-CLI.

--anonymous puts the identity in a tmpdir (auto-cleanup on next reboot). In-memory semantics not yet supported — the pragmatic shape is “tmpdir + sentinel + register-for-cleanup.” For pure-RAM identities, see v1.0 vision.

--local is the explicit form of today’s default; identity persists to the machine-wide sessions root.

Fields

name: Option<String>

Session name. Defaults to derived from cwd (anonymous mode uses a random name).

anonymous: bool

Create an ANONYMOUS identity (tmpdir-backed, dies on reboot, no federation). Mutually exclusive with –local.

local: bool

Create a LOCAL identity (machine-persistent, no federation). Default — explicit flag for clarity.

json: bool

Persist

Promote an ANONYMOUS identity to LOCAL — move from tmpdir to the machine-wide sessions root + register in the cwd map. After persist, the identity survives reboot. v0.7.0-alpha.20.

Fields

name: String

The anonymous identity’s name (from wire identity list).

as_name: Option<String>

Optional rename during persist. Default: keep the anon name.

json: bool

Demote

Demote an identity ONE level in the lifecycle: federation → local: removes the relay slot binding but keeps the keypair + agent-card. Operator can later re-publish with wire identity publish. v0.7.0-alpha.20.

(local → anonymous is not exposed; the safer flow is destroy + recreate, since “demoting” a persistent identity to ephemeral has surprising semantics — what about the keypair? what about pinned peers? Better to be explicit with destroy.)

Fields

name: String

Session name to demote.

json: bool

Trait Implementations

impl Debug for IdentityCommand

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

Formats the value using the given formatter.

impl FromArgMatches for IdentityCommand

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 IdentityCommand

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