Expand description
wire CLI surface.
Every subcommand emits human-readable text by default and structured JSON
when --json is passed. Stable JSON shape is part of the API contract —
see docs/AGENT_INTEGRATION.md.
Subcommand split:
- agent-safe:
whoami,peers,verify,send,tail— pure message-layer ops, no trust establishment. - trust-establishing:
init,dial,accept/reject,invite/accept-invite. The bilateral gate (operator-sideaccept) preserves the human-in-loop step — seedocs/THREAT_MODEL.mdT10/T14.
Structs§
- Cli
- Top-level CLI.
Enums§
- Command
- Diag
Action - Enroll
Command wire enroll …— mint the operator/org identities + certs the offline org-membership layer (RFC-001) consumes. Keys are stored 0600 alongsideprivate.key. (Publishing these claims on the agent’s own card — the card-emit integration — is a separate follow-up.)- Group
Command - v0.6.3: top-level
wire meshverbs. Each verb operates on the current session’s view of the pinned peer set.statusis the read-only observability primitive (alias forwire session mesh-status); Group-chat verbs (v0.13.3). Membership is a creator-signed roster (src/group.rs); send fans a signed message over the member set. - Identity
Command - Mesh
Command broadcastfans a signed event to every pinned peer in one call.- Mesh
Role Action - v0.6.4: subcommands of
wire mesh role. - OrgCommand
wire org …— trust organizations by their domain (RFC-001 §2 DNS-TXT floor). Binding resolves_wire-org.<domain>to anorg_didand records a per-org inbound policy; a peer with a verifiedmember_certfor a bound org then reachesORG_VERIFIEDunder the chosen mode.- Profile
Action - Quiet
Action - Responder
Command - Service
Action - Session
Command
Functions§
- closest_
candidates - Return up to
max_resultsnames frompoolwhose edit distance toneedleis ≤max_distance, sorted by distance ascending. Used for “did you mean” suggestions on resolution miss. - error_
smells_ like_ slot_ 4xx - Issue #69 follow-up to #15: predicate “does this error smell like a
4xx slot rotation?” — used by
try_reresolve_peer_on_slot_4xxto decide whether to spend a whois RTT on a re-resolve. - maybe_
auto_ init_ cwd_ session - v0.7.0-alpha.2: idempotent per-cwd session creation.
- run
- Entry point — parse and dispatch.
- run_
sync_ pull - Programmatic pull. Same shape as
wire pull --json. - run_
sync_ push - Programmatic push (no stdout, no exit on errors). Returns the same JSON
shape
wire push --jsonemits.