Enum SessionCommand 

pub enum SessionCommand {
    New {
        name: Option<String>,
        relay: String,
        with_local: bool,
        local_relay: String,
        no_daemon: bool,
        json: bool,
    },
    List {
        json: bool,
    },
    ListLocal {
        json: bool,
    },
    Env {
        name: Option<String>,
        json: bool,
    },
    Current {
        json: bool,
    },
    Destroy {
        name: String,
        force: bool,
        json: bool,
    },
}

Variants

New

Bootstrap a new isolated session in this machine’s sessions root. With no name, derives one from basename(cwd) and caches it in the registry so re-running from the same project reuses it. Runs init + claim + spawns a session-local daemon, all inside the new session’s WIRE_HOME. Output includes the export WIRE_HOME=... line operators paste into their shell to activate it.

Fields

name: Option<String>

Optional session name. Default = derived from basename(cwd).

relay: String

Relay URL for the session’s slot allocation + handle claim.

with_local: bool

v0.5.17: also allocate a second slot on a same-machine local relay (defaults to http://127.0.0.1:8771). Within-machine sister-session traffic prefers this path: zero round-trip latency, zero metadata exposure to the public relay. Probes <local-relay>/healthz first; silently skips if the local relay isn’t running.

local_relay: String

v0.5.17: override the local relay URL probed by --with-local. Default is http://127.0.0.1:8771 to match wire relay-server --bind 127.0.0.1:8771 --local-only.

no_daemon: bool

Skip spawning the session-local daemon. Use when you want to drive sync explicitly from the agent or test rig.

json: bool

Emit JSON.

List

List all sessions on this machine with their handle, DID, daemon liveness, and the cwd they’re associated with.

Fields

json: bool

ListLocal

List sister sessions reachable via a same-machine local relay (v0.5.17 dual-slot). Groups sessions by the local-relay URL they share. Sessions without a Local-scope endpoint are listed separately so the operator can tell which are federation-only. Read-only — does not probe any relay or touch daemons.

Fields

json: bool

Env

Print the export WIRE_HOME=... line for a session, so a shell can eval $(wire session env <name>) to activate it. With no name, resolves the cwd through the registry.

Fields

name: Option<String>

Session name. Default = derived from cwd via the registry.

json: bool

Current

Identify which session the current cwd maps to in the registry. Prints (none) if cwd isn’t registered — wire session new would create one.

Fields

json: bool

Destroy

Tear down a session: kills its daemon (if running), deletes its state directory, and removes it from the registry. Requires --force because state loss is unrecoverable (keypair gone).

Fields

name: String

force: bool

Confirm state-deleting operation.

json: bool

Trait Implementations

impl Debug for SessionCommand

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

Formats the value using the given formatter.

impl FromArgMatches for SessionCommand

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 SessionCommand

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