clawft

CLI Reference: weaver

Generated reference for every weaver command and subcommand, taken from the built binary.

Generated by scripts/gen-cli-reference.sh from weaver --help. Do not edit by hand; run scripts/build.sh gen-cli-reference.

Commands

weaver

WeftOS operator CLI — kernel, agents, and system management

Usage: weaver [OPTIONS] <COMMAND>

Commands:
  kernel     Kernel management (boot, status, services, processes)
  project    Per-project kernel operations (migrate-kernel)
  agent      Agent lifecycle management (spawn, stop, restart, inspect)
  app        Application management (install, start, stop, list)
  workload   Governed workloads placed across the mesh (ADR-099)
  model      Adopt, verify and explain locally held model weights (ADR-101)
  cog        Project cog sources (WeftOS, Cognitum, private), licences, search, install (ADR-105)
  mesh       Machine mesh service: serve it, inspect it, administer bindings and peers (ADR-103)
  cluster    Cluster management (nodes, shards, health)
  fleet      Fleet manager: every known node with trust, last seen, cogs and location
  dashboard  Dashboard reporter: status and token rotation (locally or on a peer)
  expose     What this node exposes to the mesh: list, on, off, pause, log (ADR-120)
  cogbus     The node's cog data plane broker: list topics (ADR-122)
  route      Tailnet router: routes, reload, and the Tailscale Serve front door (ADR-116)
  chain      Chain management (status, events, checkpoints)
  custody    Custody attestation (signed proof of system state)
  resource   Resource tree management (tree, inspect, stats)
  soul       Identity-journal operator commands (promote, status)
  cron       Cron job management (add, list, remove)
  ipc        IPC management (topics, subscribe, publish)
  console    Interactive kernel console (boot + REPL, or attach to running kernel)
  ecc        ECC cognitive substrate management (status, calibrate, search)
  graphify   Knowledge graph extraction, query, and export (graphify)
  versions   Version index of first-class objects: list, tree, deps (ADR-121)
  vault      Obsidian vault cultivation (frontmatter, links, graph analysis)
  topology   Topology layout, schema validation, and geometry detection
  leaf       Leaf device control (push audio, display, effects)
  benchmark  Run standardized kernel performance benchmark
  service    Print a launchd / systemd unit for the per-user daemon
  init       Initialize development environment (install skills, verify tools)
  update     Update weft, weaver and weftos to the latest verified release
  doctor     Check install, daemon, runtime and MCP health (read-only; `--fix` for stale files)
  migrate    Migrate WeftOS state (user chain)
  version    Show version and build info

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
  -V, --version  Print version

weaver agent

Agent lifecycle management (spawn, stop, restart, inspect)

Usage: weaver agent [OPTIONS] <COMMAND>

Commands:
  spawn    Spawn a new supervised agent
  stop     Stop a running agent
  restart  Restart an agent (stop + respawn with same config)
  inspect  Inspect a specific agent process
  list     List all agent processes
  send     Send a text message to an agent
  attach   Attach to an agent's output stream (planned)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver agent attach

Attach to an agent's output stream (planned)

Usage: weaver agent attach [OPTIONS] <PID>

Arguments:
  <PID>  PID of the agent to attach to

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver agent inspect

Inspect a specific agent process

Usage: weaver agent inspect [OPTIONS] <PID>

Arguments:
  <PID>  PID of the agent to inspect

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver agent list

List all agent processes

Usage: weaver agent list [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver agent restart

Restart an agent (stop + respawn with same config)

Usage: weaver agent restart [OPTIONS] <PID>

Arguments:
  <PID>  PID of the agent to restart

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver agent send

Send a text message to an agent

Usage: weaver agent send [OPTIONS] <PID> <MESSAGE>

Arguments:
  <PID>      Target agent PID
  <MESSAGE>  Message text

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver agent spawn

Spawn a new supervised agent

Usage: weaver agent spawn [OPTIONS] <AGENT_ID>

Arguments:
  <AGENT_ID>  Agent identifier

Options:
      --parent <PARENT>  Parent PID (for spawn lineage)
  -v, --verbose          Enable verbose (debug-level) logging
  -h, --help             Print help

weaver agent stop

Stop a running agent

Usage: weaver agent stop [OPTIONS] <PID>

Arguments:
  <PID>  PID of the agent to stop

Options:
  -f, --force    Force immediate stop (skip graceful shutdown)
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver app

Application management (install, start, stop, list)

Usage: weaver app [OPTIONS] <COMMAND>

Commands:
  install  Install application from a manifest
  start    Start an installed application
  stop     Stop a running application
  remove   Remove an installed application
  list     List installed applications
  inspect  Show application details

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver app inspect

Show application details

Usage: weaver app inspect [OPTIONS] <NAME>

Arguments:
  <NAME>  Application name

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver app install

Install application from a manifest

Usage: weaver app install [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to directory containing weftapp.toml (or JSON manifest)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver app list

List installed applications

Usage: weaver app list [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver app remove

Remove an installed application

Usage: weaver app remove [OPTIONS] <NAME>

Arguments:
  <NAME>  Application name

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver app start

Start an installed application

Usage: weaver app start [OPTIONS] <NAME>

Arguments:
  <NAME>  Application name

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver app stop

Stop a running application

Usage: weaver app stop [OPTIONS] <NAME>

Arguments:
  <NAME>  Application name

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver benchmark

Run standardized kernel performance benchmark

Usage: weaver benchmark [OPTIONS] <COMMAND>

Commands:
  run   Run the full benchmark suite against a running kernel
  last  Show results from the last benchmark run

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver benchmark last

Show results from the last benchmark run

Usage: weaver benchmark last [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver benchmark run

Run the full benchmark suite against a running kernel

Usage: weaver benchmark run [OPTIONS]

Options:
  -f, --format <FORMAT>          Output format: table (default), json [default: table]
  -v, --verbose                  Enable verbose (debug-level) logging
  -n, --iterations <ITERATIONS>  Number of iterations per test (default: 100) [default: 100]
      --quick                    Skip stress and endurance phases (phases 5-6)
      --endurance                Run the 60-second endurance test (phase 6)
      --learned                  Use EML learned scoring instead of hardcoded piecewise-linear
  -h, --help                     Print help

weaver chain

Chain management (status, events, checkpoints)

Usage: weaver chain [OPTIONS] <COMMAND>

Commands:
  status      Show local chain status
  local       List recent chain events
  checkpoint  Create a chain checkpoint
  verify      Verify chain integrity (hash linking)
  export      Export chain to file (JSON or RVF format)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver chain checkpoint

Create a chain checkpoint

Usage: weaver chain checkpoint [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver chain export

Export chain to file (JSON or RVF format)

Usage: weaver chain export [OPTIONS]

Options:
  -f, --format <FORMAT>  Output format: json or rvf [default: json]
  -v, --verbose          Enable verbose (debug-level) logging
  -o, --output <OUTPUT>  Output file path. JSON defaults to stdout; RVF defaults to daemon-side export
  -h, --help             Print help

weaver chain local

List recent chain events

Usage: weaver chain local [OPTIONS]

Options:
  -c, --count <COUNT>  Number of events to show (default: 20) [default: 20]
  -v, --verbose        Enable verbose (debug-level) logging
  -h, --help           Print help

weaver chain status

Show local chain status

Usage: weaver chain status [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver chain verify

Verify chain integrity (hash linking)

Usage: weaver chain verify [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cluster

Cluster management (nodes, shards, health)

Usage: weaver cluster [OPTIONS] <COMMAND>

Commands:
  status  Show cluster summary (node count, shard count, consensus)
  nodes   List all nodes in the cluster
  join    Add a node to the cluster
  leave   Remove a node from the cluster
  health  Show per-node health status
  shards  Show shard distribution

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cluster health

Show per-node health status

Usage: weaver cluster health [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cluster join

Add a node to the cluster

Usage: weaver cluster join [OPTIONS] [ADDRESS]

Arguments:
  [ADDRESS]  Address of the node to join (e.g. "10.0.0.1:8080")

Options:
  -p, --platform <PLATFORM>  Platform type: native, browser, edge, wasi [default: native]
  -v, --verbose              Enable verbose (debug-level) logging
  -n, --name <NAME>          Node display name
  -h, --help                 Print help

weaver cluster leave

Remove a node from the cluster

Usage: weaver cluster leave [OPTIONS] <NODE_ID>

Arguments:
  <NODE_ID>  Node ID to remove

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cluster nodes

List all nodes in the cluster

Usage: weaver cluster nodes [OPTIONS]

Options:
      --facts        Show each node's signed facts (capabilities with provenance)
  -v, --verbose      Enable verbose (debug-level) logging
      --refresh      With --facts: re-probe the local node first
      --node <NODE>  With --facts: only this node id
      --json         With --facts: print raw JSON (includes signed envelopes)
  -h, --help         Print help

weaver cluster shards

Show shard distribution

Usage: weaver cluster shards [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cluster status

Show cluster summary (node count, shard count, consensus)

Usage: weaver cluster status [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cog

Project cog sources (WeftOS, Cognitum, private), licences, search, install (ADR-105)

Usage: weaver cog [OPTIONS] <COMMAND>

Commands:
  source    Manage where this project gets cogs (WeftOS, Cognitum, private)
  licence   Declare a Cognitum licence entitlement for this project
  search    Search the cogs of every enabled source
  info      Show one cog (`cog-id` or `source:cog-id`): source, trust, policy
  install   Verify and install a cog into the local cog-host root
  checkout  Check out a Cognitum cog through the mesh's Seed steward, approve its hashes, or list grants and approvals (ADR-106; needs the daemon)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cog checkout

Check out a Cognitum cog through the mesh's Seed steward, approve its hashes, or list grants and approvals (ADR-106; needs the daemon)

Usage: weaver cog checkout [OPTIONS] [REFERENCE]
       weaver cog checkout <COMMAND>

Commands:
  approve      Approve the hashes of a checked-out cog version (operator, Admin)
  status       Grants and approvals this node holds
  release      End a checkout: the steward asks the Seed for a withdrawal, which is flooded (operator, Admin; run on the steward). The same Seed call also renews every other active checkout of the mesh
  renew        Renew now instead of at the next 12-hourly pass (Admin; run on the steward). The Seed renews every active checkout in one call
  list         Held grants, approvals and expiry (read-only)
  reset-floor  Forget the grant clock high-water mark (alias of `weaver workload node reset-floor`); changes nothing without `--confirm <floor>`

Arguments:
  [REFERENCE]  `<cog>@<version>` (`latest` is allowed) to check out

Options:
  -v, --verbose      Enable verbose (debug-level) logging
      --arch <ARCH>  Target arch (default: this node's)
      --json         Print raw JSON
  -h, --help         Print help
weaver cog checkout approve
Approve the hashes of a checked-out cog version (operator, Admin)

Usage: weaver cog checkout approve [OPTIONS] --operator-key <OPERATOR_KEY> [REFERENCE]

Arguments:
  [REFERENCE]  `<cog>@<version>` (an exact version)

Options:
      --operator-key <OPERATOR_KEY>   Operator key file (hex seed), pinned on the daemon
  -v, --verbose                       Enable verbose (debug-level) logging
      --sha256 <SHA256>               Approve exactly this sha256 (repeat); default: every artifact of the held grant
      --reapprove-orphaned            Re-sign, for the current mesh id, every approval a `mesh_nonce` change orphaned
      --confirm <CONTENT_KEY|DIGEST>  Sign and send, pinned to what the dry run printed: the approval's content key, or with `--reapprove-orphaned` the batch digest. Without it the content is shown and nothing is signed; a value that no longer matches the freshly prepared content is refused
  -h, --help                          Print help
weaver cog checkout list
Held grants, approvals and expiry (read-only)

Usage: weaver cog checkout list [OPTIONS]

Options:
      --json     Print raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog checkout release
End a checkout: the steward asks the Seed for a withdrawal, which is flooded (operator, Admin; run on the steward). The same Seed call also renews every other active checkout of the mesh

Usage: weaver cog checkout release [OPTIONS] <REFERENCE>

Arguments:
  <REFERENCE>  `<cog>@<version>` (an exact version)

Options:
      --json     Print raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog checkout renew
Renew now instead of at the next 12-hourly pass (Admin; run on the steward). The Seed renews every active checkout in one call

Usage: weaver cog checkout renew [OPTIONS] <REFERENCE>

Arguments:
  <REFERENCE>  `<cog>@<version>` (an exact version) to report on

Options:
      --json     Print raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog checkout reset-floor
Forget the grant clock high-water mark (alias of `weaver workload node reset-floor`); changes nothing without `--confirm <floor>`

Usage: weaver cog checkout reset-floor [OPTIONS]

Options:
      --confirm [<FLOOR>]  Apply the reset (chained), pinned to the floor the dry run printed
  -v, --verbose            Enable verbose (debug-level) logging
  -h, --help               Print help
weaver cog checkout status
Grants and approvals this node holds

Usage: weaver cog checkout status [OPTIONS]

Options:
      --explain  Show the run gate's verdict for every artifact
  -v, --verbose  Enable verbose (debug-level) logging
      --json     Print raw JSON
  -h, --help     Print help

weaver cog info

Show one cog (`cog-id` or `source:cog-id`): source, trust, policy

Usage: weaver cog info [OPTIONS] <REFERENCE>

Arguments:
  <REFERENCE>  `cog-id` or `source:cog-id`

Options:
      --json                         Print JSON
  -v, --verbose                      Enable verbose (debug-level) logging
      --baseline <BASELINE>          Conformance baseline (default `scripts/cogs/expectations.json` if it exists here)
      --cog-toml-dir <COG_TOML_DIR>  Directory of cog source dirs holding `<id>/cog.toml` (resources, secrets, hardware)
  -h, --help                         Print help

weaver cog install

Verify and install a cog into the local cog-host root

Usage: weaver cog install [OPTIONS] <REFERENCE>

Arguments:
  <REFERENCE>  `cog-id` or `source:cog-id`

Options:
      --arch <ARCH>             `arm` or `arm64` [default: arm]
  -v, --verbose                 Enable verbose (debug-level) logging
      --enable                  Start it (the cog-host supervisor keeps it running)
      --arg <ARGS>              CLI arg for the cog (repeat), e.g. `--arg=--interval --arg=1`
      --root <ROOT>             cog-host root (default `$WEFTOS_COG_ROOT` or `~/.weftos/cogs`)
      --confirm-project-source  Allow `--enable` for a bare id that resolved to a source defined only in this project's cog-sources.toml (a cloned repo can define its own sources)
  -h, --help                    Print help

weaver cog licence

Declare a Cognitum licence entitlement for this project

Usage: weaver cog licence [OPTIONS] <COMMAND>

Commands:
  add     Record a licence. A declaration, not a payment check
  list    List the effective licences
  remove  Remove every licence for a source

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog licence add
Record a licence. A declaration, not a payment check

Usage: weaver cog licence add [OPTIONS]

Options:
      --source <SOURCE>    Source the licence is for [default: cognitum]
  -v, --verbose            Enable verbose (debug-level) logging
      --cog <COGS>         Licensed cog id (repeat), or use `--all`
      --all                Covers every cog of the source
      --account <ACCOUNT>  Licensee account label [default: ]
      --expires <EXPIRES>  `YYYY-MM-DD` or RFC 3339
      --user               Edit the user default list
  -h, --help               Print help
weaver cog licence list
List the effective licences

Usage: weaver cog licence list [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog licence remove
Remove every licence for a source

Usage: weaver cog licence remove [OPTIONS] <SOURCE>

Arguments:
  <SOURCE>  Source name

Options:
      --user     Edit the user default list
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
Search the cogs of every enabled source

Usage: weaver cog search [OPTIONS] [QUERY]

Arguments:
  [QUERY]  Substring of the id, name, category or description

Options:
      --source <SOURCE>  Only this source
  -v, --verbose          Enable verbose (debug-level) logging
      --json             Print JSON
  -h, --help             Print help

weaver cog source

Manage where this project gets cogs (WeftOS, Cognitum, private)

Usage: weaver cog source [OPTIONS] <COMMAND>

Commands:
  add      Add a source
  list     List the effective sources (project overlaid on user defaults)
  remove   Remove a source
  enable   Enable a source
  disable  Disable a source (kept in the file, skipped by search and install)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog source add
Add a source

Usage: weaver cog source add [OPTIONS] --kind <KIND> <NAME>

Arguments:
  <NAME>
          Name, used as the `name:cog-id` namespace

Options:
      --kind <KIND>
          `weftos`, `cognitum` or `private`

          Possible values:
          - weftos:   WeftOS / WeaveLogic signed registry
          - cognitum: Cognitum app registry (licence required to install)
          - private:  The project's own signed registry

  -v, --verbose
          Enable verbose (debug-level) logging

      --url <URL>
          registry.json / app-registry.json URL, file path or repo directory (a `cognitum` source defaults to Cognitum's public registry)

      --key <KEYS>
          Ed25519 public key (64 hex) allowed to sign this source (repeat). Required for `private`

      --priority <PRIORITY>
          Higher wins when a bare id is in several sources

          [default: 0]

      --user
          Edit the user default list instead of the project

      --allow-insecure
          Development only: let a cognitum source use http:// or a local path

  -h, --help
          Print help (see a summary with '-h')
weaver cog source disable
Disable a source (kept in the file, skipped by search and install)

Usage: weaver cog source disable [OPTIONS] <NAME>

Arguments:
  <NAME>  Source name

Options:
      --user     Edit the user default list
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog source enable
Enable a source

Usage: weaver cog source enable [OPTIONS] <NAME>

Arguments:
  <NAME>  Source name

Options:
      --user     Edit the user default list
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog source list
List the effective sources (project overlaid on user defaults)

Usage: weaver cog source list [OPTIONS]

Options:
      --json     Print JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver cog source remove
Remove a source

Usage: weaver cog source remove [OPTIONS] <NAME>

Arguments:
  <NAME>  Source name

Options:
      --user     Edit the user default list
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cogbus

The node's cog data plane broker: list topics (ADR-122)

Usage: weaver cogbus [OPTIONS] <COMMAND>

Commands:
  list  Show every topic on this node

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cogbus list

Show every topic on this node

Usage: weaver cogbus list [OPTIONS]

Options:
      --json     Print the raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver console

Interactive kernel console (boot + REPL, or attach to running kernel)

Usage: weaver console [OPTIONS]

Options:
      --attach           Attach to an already-running kernel instead of booting one
  -v, --verbose          Enable verbose (debug-level) logging
      --replay-boot      Show boot log of running kernel and exit (no REPL)
  -c, --config <CONFIG>  Config file path override
  -h, --help             Print help

weaver cron

Cron job management (add, list, remove)

Usage: weaver cron [OPTIONS] <COMMAND>

Commands:
  add     Add a new cron job
  list    List all cron jobs
  remove  Remove a cron job by ID

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cron add

Add a new cron job

Usage: weaver cron add [OPTIONS] --name <NAME> --interval <INTERVAL> --command <COMMAND>

Options:
      --name <NAME>          Human-readable name for the job
  -v, --verbose              Enable verbose (debug-level) logging
      --interval <INTERVAL>  Fire every N seconds
      --command <COMMAND>    Command payload to send
      --target <TARGET>      Target agent PID (sends cron fire messages to this agent)
  -h, --help                 Print help

weaver cron list

List all cron jobs

Usage: weaver cron list [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver cron remove

Remove a cron job by ID

Usage: weaver cron remove [OPTIONS] <ID>

Arguments:
  <ID>  Job ID to remove

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver custody

Custody attestation (signed proof of system state)

Usage: weaver custody [OPTIONS] <COMMAND>

Commands:
  attest  Generate a signed custody attestation document

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver custody attest

Generate a signed custody attestation document

Usage: weaver custody attest [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver dashboard

Dashboard reporter: status and token rotation (locally or on a peer)

Usage: weaver dashboard [OPTIONS] <COMMAND>

Commands:
  status        Show the reporter's state (enabled, last heartbeat, last rotation)
  actions       List recent dashboard actions (install, update, remove, pair) and how they ended
  rotate-token  Rotate the dashboard token: the old one is revoked, the new one saved 0600

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver dashboard actions

List recent dashboard actions (install, update, remove, pair) and how they ended

Usage: weaver dashboard actions [OPTIONS]

Options:
      --json     Print the raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver dashboard rotate-token

Rotate the dashboard token: the old one is revoked, the new one saved 0600

Usage: weaver dashboard rotate-token [OPTIONS]

Options:
      --node <NODE>  Rotate on this peer instead of the local daemon (mesh node id)
  -v, --verbose      Enable verbose (debug-level) logging
  -h, --help         Print help

weaver dashboard status

Show the reporter's state (enabled, last heartbeat, last rotation)

Usage: weaver dashboard status [OPTIONS]

Options:
      --node <NODE>  Ask this peer instead of the local daemon (mesh node id)
  -v, --verbose      Enable verbose (debug-level) logging
      --json         Print the raw JSON
  -h, --help         Print help

weaver doctor

Check install, daemon, runtime and MCP health (read-only; `--fix` for stale files)

Usage: weaver doctor [OPTIONS] [COMPONENT]...

Arguments:
  [COMPONENT]...  Limit to these components (also accepted as `--component`) [possible values: install, daemon, runtime, mcp]

Options:
      --component <COMPONENT>  Component(s) to check: install, daemon, runtime, mcp [possible values: install, daemon, runtime, mcp]
  -v, --verbose                Enable verbose (debug-level) logging
      --strict                 Treat warnings as failures (non-zero exit)
      --json                   Machine-readable JSON output
      --fix                    Apply safe local repairs (remove provably stale socket/pid files in the ACTIVE runtime dir) and report exactly what changed. Off by default
      --all-runtimes           With --fix, also repair every runtime dir doctor can see (~/.clawft, ~/.weftos/runtime, ancestor .weftos/runtime), not just the active one. Setting WEFTOS_RUNTIME_DIR restricts doctor to that single dir
  -h, --help                   Print help

weaver ecc

ECC cognitive substrate management (status, calibrate, search)

Usage: weaver ecc [OPTIONS] <COMMAND>

Commands:
  status         Show ECC subsystem status (calibration, tick stats)
  calibrate      Re-run boot calibration
  search         HNSW similarity search
  causal         Show causal edges for a node
  crossrefs      Show cross-references for a Universal Node ID
  tick           Show current tick statistics
  vector-config  Show active vector backend config (WEFT-364)
  spatial        BVH spatial index (ADR-056 / WEFT-720)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ecc calibrate

Re-run boot calibration

Usage: weaver ecc calibrate [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ecc causal

Show causal edges for a node

Usage: weaver ecc causal [OPTIONS] <NODE>

Arguments:
  <NODE>  Node ID to inspect

Options:
  -d, --direction <DIRECTION>  Direction: forward or reverse [default: forward]
  -v, --verbose                Enable verbose (debug-level) logging
  -D, --depth <DEPTH>          Traversal depth [default: 3]
  -h, --help                   Print help

weaver ecc crossrefs

Show cross-references for a Universal Node ID

Usage: weaver ecc crossrefs [OPTIONS] <ID>

Arguments:
  <ID>  Hex-encoded Universal Node ID

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
HNSW similarity search

Usage: weaver ecc search [OPTIONS] <QUERY>

Arguments:
  <QUERY>  Search query text (will be hashed to a vector)

Options:
  -k, --k <K>    Number of results [default: 10]
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ecc spatial

BVH spatial index (ADR-056 / WEFT-720)

Usage: weaver ecc spatial [OPTIONS] <COMMAND>

Commands:
  insert  Insert a leaf: `--tag` + `--aabb minx,miny,minz,maxx,maxy,maxz`
  query   Broad-phase query
  branch  Branch lifecycle
  diff    Diff two branches inside a region AABB
  status  Service health, leaf counts, epoch, chain event count
  events  Dump recorded chain events (scaffold replay source)
  replay  Replay chain events into a fresh store and report status (E2E helper)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver ecc spatial branch
Branch lifecycle

Usage: weaver ecc spatial branch [OPTIONS] <COMMAND>

Commands:
  derive  Derive a COW child branch from parent
  list    List branches

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver ecc spatial branch derive
Derive a COW child branch from parent

Usage: weaver ecc spatial branch derive [OPTIONS] --name <NAME>

Options:
      --parent <PARENT>  Parent branch id [default: 0]
  -v, --verbose          Enable verbose (debug-level) logging
      --name <NAME>      Child branch name
      --note <NOTE>      Optional note [default: ]
  -h, --help             Print help
weaver ecc spatial branch list
List branches

Usage: weaver ecc spatial branch list [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver ecc spatial diff
Diff two branches inside a region AABB

Usage: weaver ecc spatial diff [OPTIONS] --a <A> --b <B> --region <REGION>

Options:
      --a <A>            Branch A id
  -v, --verbose          Enable verbose (debug-level) logging
      --b <B>            Branch B id
      --region <REGION>  Region AABB: minx,miny,minz,maxx,maxy,maxz
  -h, --help             Print help
weaver ecc spatial events
Dump recorded chain events (scaffold replay source)

Usage: weaver ecc spatial events [OPTIONS]

Options:
      --limit <LIMIT>  Limit number of events printed (0 = all) [default: 0]
  -v, --verbose        Enable verbose (debug-level) logging
  -h, --help           Print help
weaver ecc spatial insert
Insert a leaf: `--tag` + `--aabb minx,miny,minz,maxx,maxy,maxz`

Usage: weaver ecc spatial insert [OPTIONS] --tag <TAG> --aabb <AABB>

Options:
      --tag <TAG>            Registry tag name (`wm_object`, `sphere`, …) or numeric / `0x…`
  -v, --verbose              Enable verbose (debug-level) logging
      --aabb <AABB>          Axis-aligned bound: minx,miny,minz,maxx,maxy,maxz
      --payload <PAYLOAD>    Optional hex payload bytes
      --identity <IDENTITY>  Identity kind: `object` (default) or `event` [default: object]
      --branch <BRANCH>      Branch id (default main = 0) [default: 0]
  -h, --help                 Print help
weaver ecc spatial query
Broad-phase query

Usage: weaver ecc spatial query [OPTIONS] <COMMAND>

Commands:
  point   Leaves whose AABB contains the point
  aabb    Leaves intersecting an AABB
  sphere  Leaves intersecting a sphere
  ray     Ray cast (broad-phase)
  knn     k nearest by AABB center distance

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver ecc spatial query aabb
Leaves intersecting an AABB

Usage: weaver ecc spatial query aabb [OPTIONS] --region <REGION>

Options:
      --region <REGION>            AABB minx,miny,minz,maxx,maxy,maxz
  -v, --verbose                    Enable verbose (debug-level) logging
      --branch <BRANCH>            [default: 0]
      --filter-tags <FILTER_TAGS>
      --limit <LIMIT>              [default: 0]
  -h, --help                       Print help
weaver ecc spatial query knn
k nearest by AABB center distance

Usage: weaver ecc spatial query knn [OPTIONS] --at <AT>

Options:
      --at <AT>          Point x,y,z
  -v, --verbose          Enable verbose (debug-level) logging
  -k, --k <K>            [default: 5]
      --branch <BRANCH>  [default: 0]
  -h, --help             Print help
weaver ecc spatial query point
Leaves whose AABB contains the point

Usage: weaver ecc spatial query point [OPTIONS] --at <AT>

Options:
      --at <AT>                    Point x,y,z
  -v, --verbose                    Enable verbose (debug-level) logging
      --branch <BRANCH>            [default: 0]
      --filter-tags <FILTER_TAGS>  Optional tag allow-list (comma-separated) — OQ4 membership wrapper
  -h, --help                       Print help
weaver ecc spatial query ray
Ray cast (broad-phase)

Usage: weaver ecc spatial query ray [OPTIONS] --origin <ORIGIN> --dir <DIR>

Options:
      --origin <ORIGIN>  Origin x,y,z
  -v, --verbose          Enable verbose (debug-level) logging
      --dir <DIR>        Direction x,y,z
      --max-t <MAX_T>    [default: 1000000]
      --branch <BRANCH>  [default: 0]
  -h, --help             Print help
weaver ecc spatial query sphere
Leaves intersecting a sphere

Usage: weaver ecc spatial query sphere [OPTIONS] --center <CENTER> --radius <RADIUS>

Options:
      --center <CENTER>            Center x,y,z
  -v, --verbose                    Enable verbose (debug-level) logging
      --radius <RADIUS>            Radius
      --branch <BRANCH>            [default: 0]
      --filter-tags <FILTER_TAGS>
  -h, --help                       Print help
weaver ecc spatial replay
Replay chain events into a fresh store and report status (E2E helper)

Usage: weaver ecc spatial replay [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver ecc spatial status
Service health, leaf counts, epoch, chain event count

Usage: weaver ecc spatial status [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ecc status

Show ECC subsystem status (calibration, tick stats)

Usage: weaver ecc status [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ecc tick

Show current tick statistics

Usage: weaver ecc tick [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ecc vector-config

Show active vector backend config (WEFT-364)

Usage: weaver ecc vector-config [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver expose

What this node exposes to the mesh: list, on, off, pause, log (ADR-120)

Usage: weaver expose [OPTIONS] <COMMAND>

Commands:
  list   Show every exposure
  on     Switch an exposure on (to its audience; `local` unless widened)
  off    Switch an exposure off, or every exposure with `--all`
  pause  Pause an exposure (not served; stays registered)
  log    Show recent requests to exposures

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver expose list

Show every exposure

Usage: weaver expose list [OPTIONS]

Options:
      --json     Print the raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver expose log

Show recent requests to exposures

Usage: weaver expose log [OPTIONS] [ID]

Arguments:
  [ID]  Only this exposure

Options:
      --limit <LIMIT>  Newest N records [default: 50]
  -v, --verbose        Enable verbose (debug-level) logging
      --json           Print the raw JSON
  -h, --help           Print help

weaver expose off

Switch an exposure off, or every exposure with `--all`

Usage: weaver expose off [OPTIONS] [ID]

Arguments:
  [ID]  Exposure id

Options:
      --all      Switch every exposure off
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver expose on

Switch an exposure on (to its audience; `local` unless widened)

Usage: weaver expose on [OPTIONS] <ID>

Arguments:
  <ID>  Exposure id (`infer.chat`, ...)

Options:
      --audience <AUDIENCE>  Who may use it: local, paired, nodes:<a,b> or project:<id>
  -v, --verbose              Enable verbose (debug-level) logging
      --raw                  Allow raw data (microphone PCM, camera frames, IQ) on a topic exposure; only with an audience of named nodes. Without it, `on` clears raw (ADR-122 section 14)
  -h, --help                 Print help

weaver expose pause

Pause an exposure (not served; stays registered)

Usage: weaver expose pause [OPTIONS] <ID>

Arguments:
  <ID>  Exposure id

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver fleet

Fleet manager: every known node with trust, last seen, cogs and location

Usage: weaver fleet [OPTIONS] <COMMAND>

Commands:
  status    Show every known node with trust, last announce, placed cogs and location
  location  Operator-set physical location labels

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver fleet location

Operator-set physical location labels

Usage: weaver fleet location [OPTIONS] <COMMAND>

Commands:
  set  Set a node's site and room (Admin; recorded on the chain)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver fleet location set
Set a node's site and room (Admin; recorded on the chain)

Usage: weaver fleet location set [OPTIONS] --site <SITE> --room <ROOM> <NODE>

Arguments:
  <NODE>  Node id (or the id an edge node checks in with)

Options:
      --site <SITE>  Site: building, lab or rig
  -v, --verbose      Enable verbose (debug-level) logging
      --room <ROOM>  Room within the site
  -h, --help         Print help

weaver fleet status

Show every known node with trust, last announce, placed cogs and location

Usage: weaver fleet status [OPTIONS]

Options:
      --json     Print the raw snapshot JSON (every field with its provenance)
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver graphify

Knowledge graph extraction, query, and export (graphify)

Usage: weaver graphify [OPTIONS] <COMMAND>

Commands:
  ingest   Ingest a local path or URL into the knowledge graph
  query    Search the knowledge graph with a natural-language question
  export   Export the knowledge graph to a file
  diff     Compare the current graph against a cached/previous version
  rebuild  Force a full re-extraction of the knowledge graph
  watch    Start the file watcher for automatic re-extraction
  hooks    Manage git hooks for automatic graph rebuilding
  serve    Run the graphify MCP server over stdio (WEFT-369 / Phase 6)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver graphify diff

Compare the current graph against a cached/previous version

Usage: weaver graphify diff [OPTIONS] [OLD] [CURRENT]

Arguments:
  [OLD]      Path to the old graph JSON [default: graphify-out/graph.json.bak]
  [CURRENT]  Path to the current graph JSON [default: graphify-out/graph.json]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver graphify export

Export the knowledge graph to a file

Usage: weaver graphify export [OPTIONS] <FORMAT>

Arguments:
  <FORMAT>  Export format: json, graphml, cypher, html, obsidian, wiki, svg

Options:
  -o, --output <OUTPUT>  Output path (default: graphify-out/<format>)
  -v, --verbose          Enable verbose (debug-level) logging
  -g, --graph <GRAPH>    Graph JSON path [default: graphify-out/graph.json]
  -h, --help             Print help

weaver graphify hooks

Manage git hooks for automatic graph rebuilding

Usage: weaver graphify hooks [OPTIONS] <COMMAND>

Commands:
  install    Install graphify post-commit and post-checkout hooks
  uninstall  Remove graphify hooks
  status     Check hook installation status

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver graphify hooks install
Install graphify post-commit and post-checkout hooks

Usage: weaver graphify hooks install [OPTIONS] [PATH]

Arguments:
  [PATH]  Repository root (default: current directory) [default: .]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver graphify hooks status
Check hook installation status

Usage: weaver graphify hooks status [OPTIONS] [PATH]

Arguments:
  [PATH]  Repository root (default: current directory) [default: .]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver graphify hooks uninstall
Remove graphify hooks

Usage: weaver graphify hooks uninstall [OPTIONS] [PATH]

Arguments:
  [PATH]  Repository root (default: current directory) [default: .]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver graphify ingest

Ingest a local path or URL into the knowledge graph

Usage: weaver graphify ingest [OPTIONS] <TARGET>

Arguments:
  <TARGET>  Path to a local file/directory or a URL to fetch

Options:
  -o, --output <OUTPUT>            Output directory for ingested files [default: graphify-out/memory]
  -v, --verbose                    Enable verbose (debug-level) logging
      --contributor <CONTRIBUTOR>  Contributor name for metadata
  -h, --help                       Print help

weaver graphify query

Search the knowledge graph with a natural-language question

Usage: weaver graphify query [OPTIONS] <QUESTION>

Arguments:
  <QUESTION>  The question or keyword search

Options:
  -g, --graph <GRAPH>  Graph JSON path [default: graphify-out/graph.json]
  -v, --verbose        Enable verbose (debug-level) logging
  -m, --mode <MODE>    Traversal mode: bfs or dfs [default: bfs]
  -d, --depth <DEPTH>  Traversal depth (1-6) [default: 3]
  -h, --help           Print help

weaver graphify rebuild

Force a full re-extraction of the knowledge graph

Usage: weaver graphify rebuild [OPTIONS] [ROOT]

Arguments:
  [ROOT]  Root directory to scan [default: .]

Options:
      --clean    Clear cache before rebuilding
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver graphify serve

Run the graphify MCP server over stdio (WEFT-369 / Phase 6).

Exposes `graphify_query`, `graphify_ingest`, `graphify_export`, and `graphify_diff` to MCP clients (Claude Desktop, Cursor, etc.).

Usage: weaver graphify serve [OPTIONS]

Options:
  -v, --verbose
          Enable verbose (debug-level) logging

      --work-dir <WORK_DIR>
          Working directory for relative graph paths (default: cwd)

      --graph <GRAPH>
          Default graph JSON path relative to work-dir

          [default: graphify-out/graph.json]

  -h, --help
          Print help (see a summary with '-h')

weaver graphify watch

Start the file watcher for automatic re-extraction

Usage: weaver graphify watch [OPTIONS] [ROOT]

Arguments:
  [ROOT]  Root directory to watch [default: .]

Options:
  -d, --debounce <DEBOUNCE>  Debounce window in seconds [default: 2]
  -v, --verbose              Enable verbose (debug-level) logging
  -h, --help                 Print help

weaver init

Initialize development environment (install skills, verify tools)

Usage: weaver init [OPTIONS]

Options:
  -f, --force        Overwrite existing weave.toml AND any existing `.clawft/` identity files (`SOUL.md`, `IDENTITY.md`, `SOUL.journal.md`). Use this to reset a project to canonical seed state
  -v, --verbose      Enable verbose (debug-level) logging
  -u, --update       Add files this version of `weaver init` would seed without touching anything that already exists. Use this to pick up newly-added init artifacts (e.g. when the project upgrades to a release that introduces additional `.clawft/` files) on a workspace that already has a customized `weave.toml`. Mutually exclusive with `--force`
  -n, --name <NAME>  Project name (defaults to current directory name)
      --mesh         Enable mesh networking in the generated config
      --ecc          Enable ECC cognitive substrate
  -y, --yes          Skip interactive prompts
  -h, --help         Print help

weaver ipc

IPC management (topics, subscribe, publish)

Usage: weaver ipc [OPTIONS] <COMMAND>

Commands:
  topics     List all active topics and their subscribers
  subscribe  Subscribe a PID to a topic
  publish    Publish a message to a topic

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ipc publish

Publish a message to a topic

Usage: weaver ipc publish [OPTIONS] <TOPIC> <MESSAGE>

Arguments:
  <TOPIC>    Topic name
  <MESSAGE>  Message (text or JSON)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ipc subscribe

Subscribe a PID to a topic

Usage: weaver ipc subscribe [OPTIONS] <PID> <TOPIC>

Arguments:
  <PID>    PID to subscribe
  <TOPIC>  Topic name

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver ipc topics

List all active topics and their subscribers

Usage: weaver ipc topics [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver kernel

Kernel management (boot, status, services, processes)

Usage: weaver kernel [OPTIONS] <COMMAND>

Commands:
  start       Start the kernel daemon (backgrounds by default)
  stop        Stop a running kernel daemon (sends SIGTERM)
  restart     Restart a running kernel daemon (sends SIGHUP for re-exec)
  status      Show kernel state, uptime, process count, service count
  liveness    Liveness self-check: exit 0 only when the daemon answers within 10 s and its last probe round (runtime, locks, RPC) passed recently
  services    List registered services with name, type, health status
  ps          List process table entries
  attach      Attach to a running daemon and stream logs in real time
  logs        Show kernel event log
  rotate-key  Rotate the node Ed25519 identity key (S10 / WEFT-107)

Options:
  -v, --verbose            Enable verbose (debug-level) logging
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel attach

Attach to a running daemon and stream logs in real time

Usage: weaver kernel attach [OPTIONS]

Options:
  -n, --tail <TAIL>        Number of recent entries to show before streaming (default: 20) [default: 20]
  -v, --verbose            Enable verbose (debug-level) logging
  -l, --level <LEVEL>      Minimum log level: debug, info, warn, error
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel liveness

Liveness self-check: exit 0 only when the daemon answers within 10 s and its last probe round (runtime, locks, RPC) passed recently

Usage: weaver kernel liveness [OPTIONS]

Options:
      --json               Print the report as JSON
  -v, --verbose            Enable verbose (debug-level) logging
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel logs

Show kernel event log

Usage: weaver kernel logs [OPTIONS]

Options:
  -n, --count <COUNT>      Number of recent entries to show (default: 50, 0 = all) [default: 50]
  -v, --verbose            Enable verbose (debug-level) logging
  -l, --level <LEVEL>      Minimum log level: debug, info, warn, error
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel ps

List process table entries

Usage: weaver kernel ps [OPTIONS]

Options:
  -v, --verbose            Enable verbose (debug-level) logging
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel restart

Restart a running kernel daemon (sends SIGHUP for re-exec)

Usage: weaver kernel restart [OPTIONS]

Options:
      --project <ID|NAME>  Restart only this project's kernel under the user daemon: stop it, clear a `failed` state and start it again
  -v, --verbose            Enable verbose (debug-level) logging
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel rotate-key

Rotate the node Ed25519 identity key (S10 / WEFT-107).

Generates a new keypair, dual-signs an `identity.key_rotation` ExoChain event with both old and new keys, appends it to the local chain export, and replaces `<runtime>/node.key`.

Usage: weaver kernel rotate-key [OPTIONS]

Options:
      --grace-period-secs <GRACE_PERIOD_SECS>
          Grace period in seconds during which the old key remains trusted

          [default: 86400]

  -v, --verbose
          Enable verbose (debug-level) logging

      --dry-run
          Dry-run: build and verify the dual-signed payload without writing

  -c, --config <CONFIG>
          Config file path (overrides auto-discovery)

      --profile <PROFILE>
          Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon

  -h, --help
          Print help (see a summary with '-h')

weaver kernel services

List registered services with name, type, health status

Usage: weaver kernel services [OPTIONS]

Options:
  -v, --verbose            Enable verbose (debug-level) logging
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel start

Start the kernel daemon (backgrounds by default)

Usage: weaver kernel start [OPTIONS]

Options:
      --foreground             Run in foreground instead of backgrounding
  -v, --verbose                Enable verbose (debug-level) logging
      --new-chain              Start a fresh chain at the resolved path instead of adopting the legacy `~/.clawft` chain (the legacy chain is left untouched)
      --adopt-legacy-chain     Adopt the legacy `~/.clawft` chain for the first time (also overrides a `weaver migrate user-chain` marker, with a WARN: it forks history). Required once, after stopping every older weaver daemon, while no `chain.lock` exists beside that chain
      --project <ID|NAME>      Start (or find) this project's kernel under the user daemon instead of starting a daemon here. Takes a project id or its registered name. With `--profile project` this is the child's own boot: the user daemon passes its project id this way
      --legacy-project-daemon  Start a project-rooted daemon even though a user daemon is running (deprecated, removed next release)
  -c, --config <CONFIG>        Config file path (overrides auto-discovery)
      --profile <PROFILE>      Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help                   Print help

weaver kernel status

Show kernel state, uptime, process count, service count

Usage: weaver kernel status [OPTIONS]

Options:
  -v, --verbose            Enable verbose (debug-level) logging
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver kernel stop

Stop a running kernel daemon (sends SIGTERM)

Usage: weaver kernel stop [OPTIONS]

Options:
      --force              Force-kill with SIGKILL if graceful shutdown times out
  -v, --verbose            Enable verbose (debug-level) logging
      --project <ID|NAME>  Stop only this project's kernel (under the user daemon)
      --all-children       Stop every project kernel under the user daemon and leave the daemon running
      --keep-children      With `--profile user`: stop only the user daemon and leave the project kernels running for the next daemon to adopt. The default stops them cleanly first
  -c, --config <CONFIG>    Config file path (overrides auto-discovery)
      --profile <PROFILE>  Daemon profile. `user` addresses the per-user daemon: runtime root `~/.weftos/run`, config `~/.weftos/weave.toml` over the legacy config. Applies to start, stop, restart, status and every other subcommand. Falls back to `WEAVER_PROFILE`; omit for the default (project or legacy) daemon
  -h, --help               Print help

weaver leaf

Leaf device control (push audio, display, effects)

Usage: weaver leaf [OPTIONS] <COMMAND>

Commands:
  provision  Issue a parent-certified Ed25519 identity for a leaf. No hardware is accessed
  enroll     Install a provisioned public certificate in a parent mesh registry
  enqueue    Sign an outbound mesh envelope and append it durably before sending
  replay     Discover the certified parent and replay queued frames in order
  push       Push an audio payload to a leaf device
  status     Is this leaf connected to the daemon, and who holds its display (ADR-117)
  scene      Vector-scene operations — host → leaf display path

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver leaf enqueue

Sign an outbound mesh envelope and append it durably before sending

Usage: weaver leaf enqueue [OPTIONS] --seed <SEED> --public <PUBLIC> --journal <JOURNAL> --target <TARGET> --payload-file <PAYLOAD_FILE>

Options:
      --seed <SEED>
  -v, --verbose                      Enable verbose (debug-level) logging
      --public <PUBLIC>
      --journal <JOURNAL>
      --target <TARGET>
      --payload-file <PAYLOAD_FILE>  JSON MeshIpcEnvelope bytes, including the same routed target
  -h, --help                         Print help

weaver leaf enroll

Install a provisioned public certificate in a parent mesh registry

Usage: weaver leaf enroll [OPTIONS] --public <PUBLIC> --registry-dir <REGISTRY_DIR> --parent-pubkey <PARENT_PUBKEY> --mesh-pubkey <MESH_PUBKEY> --parent-scope <PARENT_SCOPE>

Options:
      --public <PUBLIC>
  -v, --verbose                        Enable verbose (debug-level) logging
      --registry-dir <REGISTRY_DIR>
      --parent-pubkey <PARENT_PUBKEY>
      --mesh-pubkey <MESH_PUBKEY>
      --parent-scope <PARENT_SCOPE>
  -h, --help                           Print help

weaver leaf provision

Issue a parent-certified Ed25519 identity for a leaf. No hardware is accessed

Usage: weaver leaf provision [OPTIONS] --parent-key <PARENT_KEY> --parent-scope <PARENT_SCOPE> --out-dir <OUT_DIR>

Options:
      --parent-key <PARENT_KEY>      Existing raw 32-byte user or project signing key
  -v, --verbose                      Enable verbose (debug-level) logging
      --mesh-pubkey <MESH_PUBKEY>    Raw 32-byte machine mesh public key. Defaults to the parent key for a collapsed host
      --parent-scope <PARENT_SCOPE>  Canonical tenant: `user:<32 lowercase hex>` or `project:<user-id>:<26 uppercase ULID>`
      --project-cert <PROJECT_CERT>  Required for a project scope: user-signed certificate for the project key that issues this leaf identity
      --out-dir <OUT_DIR>            Empty destination directory for private seed and public registration
      --days <DAYS>                  Certificate validity in days [default: 365]
      --capabilities <CAPABILITIES>  Comma-separated declared leaf capabilities [default: input.publish,announce.publish,push.subscribe]
  -h, --help                         Print help

weaver leaf push

Push an audio payload to a leaf device.

Display payloads now live under `weaver leaf scene`; the old `text` / `clear` / `brightness` / `effect` subcommands are removed (see docs/design/vector-leaf-display.md §10 Migration Plan, "Phase E").

Usage: weaver leaf push [OPTIONS] --target <TARGET> <COMMAND>

Commands:
  chord    Push audio chord
  scuttle  Push procedural crab scuttle sound

Options:
  -t, --target <TARGET>
          Target leaf pubkey (hex, with or without 0x prefix)

  -v, --verbose
          Enable verbose (debug-level) logging

      --dry-run
          Print encoded payload and exit without sending

  -h, --help
          Print help (see a summary with '-h')
weaver leaf push chord
Push audio chord

Usage: weaver leaf push --target <TARGET> chord [OPTIONS] --freqs <FREQS>

Options:
      --freqs <FREQS>        Comma-separated frequencies in Hz
  -v, --verbose              Enable verbose (debug-level) logging
      --gain <GAIN>          Gain 0.0–1.0 [default: 0.3]
      --duration <DURATION>  Duration in milliseconds [default: 1500]
      --at <AT>              Present delay in milliseconds from now [default: 0]
  -h, --help                 Print help
weaver leaf push scuttle
Push procedural crab scuttle sound

Usage: weaver leaf push --target <TARGET> scuttle [OPTIONS]

Options:
      --count <COUNT>  Number of scuttles [default: 1]
  -v, --verbose        Enable verbose (debug-level) logging
      --gain <GAIN>    Gain 0.0–1.0 [default: 0.5]
      --at <AT>        Present delay in milliseconds [default: 0]
  -h, --help           Print help

weaver leaf replay

Discover the certified parent and replay queued frames in order

Usage: weaver leaf replay [OPTIONS] --public <PUBLIC> --journal <JOURNAL>

Options:
      --public <PUBLIC>
  -v, --verbose                Enable verbose (debug-level) logging
      --journal <JOURNAL>
      --discovery <DISCOVERY>  UDP discovery address, usually the parent LAN broadcast on mesh port + 1 [default: 255.255.255.255:9490]
  -h, --help                   Print help

weaver leaf scene

Vector-scene operations — host → leaf display path

Usage: weaver leaf scene [OPTIONS] <COMMAND>

Commands:
  push      Push a `Vec<SceneOp>` as a single envelope. The ops file is JSON-serialized `Vec<SceneOp>` (the wire format is CBOR but JSON is the producer-friendly source format — we transcode internally)
  clear     Emit a `Clear` op for the given display
  snapshot  Push a full-scene snapshot — `Replace(Scene)`. The scene file is JSON-serialized [`weftos_leaf_scene::Scene`]
  ps        Produce a kernel.ps scene and push it as a delta (or snapshot if this is the first run for this leaf)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver leaf scene clear
Emit a `Clear` op for the given display

Usage: weaver leaf scene clear [OPTIONS] --target <TARGET>

Options:
  -t, --target <TARGET>
  -v, --verbose            Enable verbose (debug-level) logging
      --display <DISPLAY>  [default: 0]
      --dry-run
  -h, --help               Print help
weaver leaf scene ps
Produce a kernel.ps scene and push it as a delta (or snapshot if this is the first run for this leaf).

The previous scene state is cached at `~/.clawft/leaf-state/<target>-<display>.cbor`; deleting that file forces a fresh snapshot on the next invocation.

Usage: weaver leaf scene ps [OPTIONS] --target <TARGET>

Options:
  -t, --target <TARGET>


  -v, --verbose
          Enable verbose (debug-level) logging

      --display <DISPLAY>
          [default: 0]

      --snapshot
          Force a full snapshot (Replace(Scene)) even if a cached previous state exists

      --dry-run


  -h, --help
          Print help (see a summary with '-h')
weaver leaf scene push
Push a `Vec<SceneOp>` as a single envelope. The ops file is JSON-serialized `Vec<SceneOp>` (the wire format is CBOR but JSON is the producer-friendly source format — we transcode internally)

Usage: weaver leaf scene push [OPTIONS] --target <TARGET> <OPS_FILE>

Arguments:
  <OPS_FILE>  Path to a JSON file containing `Vec<SceneOp>`

Options:
  -t, --target <TARGET>    Target leaf pubkey (hex, with or without 0x prefix)
  -v, --verbose            Enable verbose (debug-level) logging
      --display <DISPLAY>  Display id on the leaf (0 for single-display leaves) [default: 0]
      --dry-run            Print encoded payload and exit without sending
  -h, --help               Print help
weaver leaf scene snapshot
Push a full-scene snapshot — `Replace(Scene)`. The scene file is JSON-serialized [`weftos_leaf_scene::Scene`]

Usage: weaver leaf scene snapshot [OPTIONS] --target <TARGET> <SCENE_FILE>

Arguments:
  <SCENE_FILE>

Options:
  -t, --target <TARGET>
  -v, --verbose            Enable verbose (debug-level) logging
      --display <DISPLAY>  [default: 0]
      --dry-run
  -h, --help               Print help

weaver leaf status

Is this leaf connected to the daemon, and who holds its display (ADR-117)

Usage: weaver leaf status [OPTIONS] --leaf-id <LEAF_ID>

Options:
      --leaf-id <LEAF_ID>  The leaf id (32 hex characters) `weaver leaf provision` printed
  -v, --verbose            Enable verbose (debug-level) logging
  -h, --help               Print help

weaver mesh

Machine mesh service: serve it, inspect it, administer bindings and peers (ADR-103)

Usage: weaver mesh [OPTIONS] <COMMAND>

Commands:
  serve              Run the machine mesh service in the foreground (never as root)
  status             Service status: identity, policy, registrations, peers, journal
  bindings           List bound, pending and revoked users (admin)
  bind               Approve, revoke or rebind a user binding (admin)
  peer               Revoke or restore a mesh peer (admin)
  journal            Verify the machine journal; acknowledge a quarantined tail (admin)
  trust              Pin the service's machine key after verifying its fingerprint out of band
  identity           Print this node's mesh identity — node id, fingerprint and Ed25519 public key — from `<runtime>/node.key`. Read-only; the private key is never printed. `--out` also writes the raw 32-byte public key, which is what `weaver leaf provision --mesh-pubkey` pins
  create             Mint this mesh's MeshId (the `weftos://` authority) on its primary when there is no Seed licence; refuses if the mesh already has one
  adopt-licence      Confirm this node uses its Seed licence's MeshId; refuses a conflicting record
  id                 Print this node's MeshId and where it came from (licence, genesis, learned, imported)
  export             Write this node's signed mesh record as JSON (no secrets in it) so a node that cannot pair with this one can `weaver mesh import` it
  import             Import a mesh record exported elsewhere. Accepted only when it is signed by a node this node already trusts (workload-peers.json at pinned/paired, a workload-host.json controller, or a pairing)
  nonce              Mesh nonce for the Seed licence mesh id (ADR-106); runs locally
  pair               Ask to pair this node with another for project work (ADR-108 P2b); the dashboard approves
  install-service    PRINT a reviewed shell script that installs the service (runs nothing)
  uninstall-service  PRINT the inverse script (keeps node.key unless --purge-key; runs nothing)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver mesh adopt-licence

Confirm this node uses its Seed licence's MeshId; refuses a conflicting record

Usage: weaver mesh adopt-licence [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver mesh bind

Approve, revoke or rebind a user binding (admin)

Usage: weaver mesh bind [OPTIONS] <COMMAND>

Commands:
  approve  Approve a bind waiting for approval. The key is named by its user id (fingerprint): by default the one pending now, shown before approving; the service refuses if the pending key is a different one
  revoke   Revoke the user's binding and every certificate issued to its key
  rebind   Replace the user's key (default: the key the uid last offered in conflict)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver mesh bind approve
Approve a bind waiting for approval. The key is named by its user id (fingerprint): by default the one pending now, shown before approving; the service refuses if the pending key is a different one

Usage: weaver mesh bind approve [OPTIONS] <UID>

Arguments:
  <UID>

Options:
      --user-id <USER_ID>  The pending key's user id, as shown by `weaver mesh bindings`
  -v, --verbose            Enable verbose (debug-level) logging
      --socket <SOCKET>    Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
      --pin <PIN>          Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json               Print the raw JSON reply
  -h, --help               Print help
weaver mesh bind rebind
Replace the user's key (default: the key the uid last offered in conflict)

Usage: weaver mesh bind rebind [OPTIONS] <UID>

Arguments:
  <UID>

Options:
      --pubkey <PUBKEY>  New user public key (64 hex)
  -v, --verbose          Enable verbose (debug-level) logging
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
  -h, --help             Print help
weaver mesh bind revoke
Revoke the user's binding and every certificate issued to its key

Usage: weaver mesh bind revoke [OPTIONS] <UID>

Arguments:
  <UID>

Options:
      --reason <REASON>  [default: ]
  -v, --verbose          Enable verbose (debug-level) logging
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
  -h, --help             Print help

weaver mesh bindings

List bound, pending and revoked users (admin)

Usage: weaver mesh bindings [OPTIONS]

Options:
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
  -v, --verbose          Enable verbose (debug-level) logging
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
  -h, --help             Print help

weaver mesh create

Mint this mesh's MeshId (the `weftos://` authority) on its primary when there is no Seed licence; refuses if the mesh already has one

Usage: weaver mesh create [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver mesh export

Write this node's signed mesh record as JSON (no secrets in it) so a node that cannot pair with this one can `weaver mesh import` it

Usage: weaver mesh export [OPTIONS]

Options:
      --out <OUT>  Write the record here (mode 0600, never replaces a file); default stdout
  -v, --verbose    Enable verbose (debug-level) logging
  -h, --help       Print help

weaver mesh id

Print this node's MeshId and where it came from (licence, genesis, learned, imported)

Usage: weaver mesh id [OPTIONS]

Options:
      --json     Print JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver mesh identity

Print this node's mesh identity — node id, fingerprint and Ed25519 public key — from `<runtime>/node.key`. Read-only; the private key is never printed. `--out` also writes the raw 32-byte public key, which is what `weaver leaf provision --mesh-pubkey` pins

Usage: weaver mesh identity [OPTIONS]

Options:
      --out <OUT>  Also write the raw 32-byte Ed25519 public key here (for `weaver leaf provision --mesh-pubkey`). Refuses to overwrite
  -v, --verbose    Enable verbose (debug-level) logging
      --json       Print JSON (`report.mesh_identity` shape) instead of text
      --user       The user key (`~/.weftos/user.key`, else the migrated chain key) instead of the node key: its key id is the `user:<id>` scope and `--out` writes the raw public key that `weaver leaf enroll --parent-pubkey` pins
  -h, --help       Print help

weaver mesh import

Import a mesh record exported elsewhere. Accepted only when it is signed by a node this node already trusts (workload-peers.json at pinned/paired, a workload-host.json controller, or a pairing)

Usage: weaver mesh import [OPTIONS] <FILE>

Arguments:
  <FILE>  The exported record, or `-` for stdin

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver mesh install-service

PRINT a reviewed shell script that installs the service (runs nothing)

Usage: weaver mesh install-service [OPTIONS]

Options:
      --kind <KIND>
          Service manager (default: this host's) [possible values: launchd, systemd]
  -v, --verbose
          Enable verbose (debug-level) logging
      --adopt-node-key <PATH>
          Copy an existing node key (the collapsed daemon's `~/.weftos/run/node.key`) into the service state so the machine keeps its node id (install only)
      --fresh-node-key
          Let the service generate a NEW box key even though this machine has one (`~/.weftos/run/node.key`): the node id changes and peers must re-pin
      --listen <LISTEN>
          Mesh listener written to mesh.toml (non-loopback exposes it to the network) [default: 127.0.0.1:9489]
      --admin-uid <ADMIN_UIDS>
          Extra uid(s) allowed to run admin verbs (root always may)
      --max-connections-per-ip <N>
          Written to mesh.toml as `max_connections_per_ip` (service default 64)
      --first-frame-timeout-secs <SECS>
          Written to mesh.toml as `first_frame_timeout_secs` (service default 10)
      --purge-key
          uninstall only: also delete /var/lib/weftos/mesh/node.key
  -h, --help
          Print help

weaver mesh journal

Verify the machine journal; acknowledge a quarantined tail (admin)

Usage: weaver mesh journal [OPTIONS] <COMMAND>

Commands:
  verify  Re-verify the hash chain and signatures; fails when it does not verify

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver mesh journal verify
Re-verify the hash chain and signatures; fails when it does not verify

Usage: weaver mesh journal verify [OPTIONS]

Options:
      --accept-truncate  Acknowledge a quarantined tail (journals what was lost; lifts read-only)
  -v, --verbose          Enable verbose (debug-level) logging
      --seq <SEQ>        Quarantine record to accept (default: the newest pending one)
      --floor <FLOOR>    Raise the certificate serial floor (never lowers it)
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
  -h, --help             Print help

weaver mesh nonce

Mesh nonce for the Seed licence mesh id (ADR-106); runs locally

Usage: weaver mesh nonce [OPTIONS] <COMMAND>

Commands:
  generate  Print a new random mesh nonce (64 hex chars) and where it goes

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver mesh nonce generate
Print a new random mesh nonce (64 hex chars) and where it goes

Usage: weaver mesh nonce generate [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver mesh pair

Ask to pair this node with another for project work (ADR-108 P2b); the dashboard approves

Usage: weaver mesh pair [OPTIONS] <COMMAND>

Commands:
  request  Ask to pair with a node (its mesh node id, as the dashboard shows it)
  list     List this node's pending requests
  cancel   Withdraw a pending request

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver mesh pair cancel
Withdraw a pending request

Usage: weaver mesh pair cancel [OPTIONS] <REQUEST_ID>

Arguments:
  <REQUEST_ID>  The request id from `list`

Options:
      --json
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver mesh pair list
List this node's pending requests

Usage: weaver mesh pair list [OPTIONS]

Options:
      --json
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver mesh pair request
Ask to pair with a node (its mesh node id, as the dashboard shows it)

Usage: weaver mesh pair request [OPTIONS] --with <WITH_NODE>

Options:
  -v, --verbose             Enable verbose (debug-level) logging
      --with <WITH_NODE>    Mesh node id of the other side (32 hex), from its `mesh_identity`
      --project <PROJECTS>  Project ULID the pairing is for (repeatable; none means any project)
      --json                Print the raw JSON reply
  -h, --help                Print help

weaver mesh peer

Revoke or restore a mesh peer (admin)

Usage: weaver mesh peer [OPTIONS] <COMMAND>

Commands:
  revoke    Refuse and disconnect a peer node id
  unrevoke  Remove a peer revocation

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver mesh peer revoke
Refuse and disconnect a peer node id

Usage: weaver mesh peer revoke [OPTIONS] <NODE_ID>

Arguments:
  <NODE_ID>

Options:
      --reason <REASON>  [default: ]
  -v, --verbose          Enable verbose (debug-level) logging
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
  -h, --help             Print help
weaver mesh peer unrevoke
Remove a peer revocation

Usage: weaver mesh peer unrevoke [OPTIONS] <NODE_ID>

Arguments:
  <NODE_ID>

Options:
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
  -v, --verbose          Enable verbose (debug-level) logging
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
  -h, --help             Print help

weaver mesh serve

Run the machine mesh service in the foreground (never as root)

Usage: weaver mesh serve [OPTIONS]

Options:
      --config <CONFIG>                mesh.toml (production: /etc/weftos/mesh.toml)
  -v, --verbose                        Enable verbose (debug-level) logging
      --state-dir <STATE_DIR>          State directory (default /var/lib/weftos/mesh; tests: a tempdir)
      --socket <SOCKET>                mesh-local socket path
      --listen <LISTEN>                Mesh listener address (default 127.0.0.1:9489; 0.0.0.0 exposes it to the LAN)
      --health-listen <HEALTH_LISTEN>  Loopback health address, or `off` (default 127.0.0.1:9490)
  -h, --help                           Print help

weaver mesh status

Service status: identity, policy, registrations, peers, journal

Usage: weaver mesh status [OPTIONS]

Options:
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
  -v, --verbose          Enable verbose (debug-level) logging
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
  -h, --help             Print help

weaver mesh trust

Pin the service's machine key after verifying its fingerprint out of band

Usage: weaver mesh trust [OPTIONS]

Options:
      --socket <SOCKET>  Mesh-local socket (default: $WEFTOS_MESH_SOCKET, else /var/run/weftos/mesh.sock)
  -v, --verbose          Enable verbose (debug-level) logging
      --pin <PIN>        Machine-key pin to compare against (default: ~/.weftos/mesh/machine.pub when present)
      --json             Print the raw JSON reply
      --replace          Replace an existing pin that holds a different key
  -h, --help             Print help

weaver mesh uninstall-service

PRINT the inverse script (keeps node.key unless --purge-key; runs nothing)

Usage: weaver mesh uninstall-service [OPTIONS]

Options:
      --kind <KIND>
          Service manager (default: this host's) [possible values: launchd, systemd]
  -v, --verbose
          Enable verbose (debug-level) logging
      --adopt-node-key <PATH>
          Copy an existing node key (the collapsed daemon's `~/.weftos/run/node.key`) into the service state so the machine keeps its node id (install only)
      --fresh-node-key
          Let the service generate a NEW box key even though this machine has one (`~/.weftos/run/node.key`): the node id changes and peers must re-pin
      --listen <LISTEN>
          Mesh listener written to mesh.toml (non-loopback exposes it to the network) [default: 127.0.0.1:9489]
      --admin-uid <ADMIN_UIDS>
          Extra uid(s) allowed to run admin verbs (root always may)
      --max-connections-per-ip <N>
          Written to mesh.toml as `max_connections_per_ip` (service default 64)
      --first-frame-timeout-secs <SECS>
          Written to mesh.toml as `first_frame_timeout_secs` (service default 10)
      --purge-key
          uninstall only: also delete /var/lib/weftos/mesh/node.key
  -h, --help
          Print help

weaver migrate

Migrate WeftOS state (user chain)

Usage: weaver migrate [OPTIONS] <COMMAND>

Commands:
  user-chain  Copy the legacy ~/.clawft chain to ~/.weftos/chain (verified; source kept)
  user-key    Copy chain.key's seed to ~/.weftos/user.key (same public key, same user id)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver migrate user-chain

Copy the legacy ~/.clawft chain to ~/.weftos/chain (verified; source kept)

Usage: weaver migrate user-chain [OPTIONS]

Options:
      --dry-run         Print what would happen (sizes, head seq/hash) and write nothing
  -v, --verbose         Enable verbose (debug-level) logging
      --from <FROM>     Legacy chain directory (default: ~/.clawft)
      --to <TO>         Destination chain directory (default: ~/.weftos/chain)
      --allow-unsigned  Migrate even if chain.key is missing or the chain signature cannot be verified against it
  -h, --help            Print help

weaver migrate user-key

Copy chain.key's seed to ~/.weftos/user.key (same public key, same user id).

With --rotate: replace the user key instead. The handover is recorded in the manifest store, signed by the old and the new key, so certificates, anchor records and policies sealed by the old key keep verifying up to the rotation point (ADR-103 A13). Stop the user daemon first; afterwards restart it, restart project kernels, and run `weaver mesh bind rebind` if the machine mesh service is installed.

Usage: weaver migrate user-key [OPTIONS]

Options:
      --dry-run
          Show what would happen without writing anything

  -v, --verbose
          Enable verbose (debug-level) logging

      --rotate
          Rotate the user key (new key, dual-signed handover) instead of migrating

  -h, --help
          Print help (see a summary with '-h')

weaver model

Adopt, verify and explain locally held model weights (ADR-101)

Usage: weaver model [OPTIONS] <COMMAND>

Commands:
  adopt      Adopt model files in place: hash them where they lie and attest the hashes
  list       List adopted models with their current state
  verify     Check an adopted model's files against its attestation
  advertise  Hide a model from node facts, or advertise it again. Shard hashes fingerprint which models this node holds; hidden models are still usable locally
  explain    Explain the fetch-versus-relocate decision for a model over described nodes

Options:
  -v, --verbose              Enable verbose (debug-level) logging
      --registry <REGISTRY>  Registry file (default: `<runtime dir>/models/registry.json`)
  -h, --help                 Print help

weaver model adopt

Adopt model files in place: hash them where they lie and attest the hashes

Usage: weaver model adopt [OPTIONS] --name <NAME> --key <KEY> --trust <TRUST> <PATH>

Arguments:
  <PATH>
          Model directory or single weight file; for `--ollama`, the Ollama models directory

Options:
      --name <NAME>
          Model name (the `model` parameter of `perf.infer.tok_s`)

  -v, --verbose
          Enable verbose (debug-level) logging

      --format <FORMAT>
          Layout (ignored with `--ollama`)

          Possible values:
          - mlx:         MLX quantisation directory
          - gguf:        GGUF file or directory
          - safetensors: Safetensors (HF snapshot)

          [default: mlx]

      --ollama <NAME:TAG>
          Adopt through an Ollama manifest, `<name>:<tag>`

      --hf-repo <HF_REPO>
          Hugging Face repo id (provenance)

      --hf-revision <HF_REVISION>
          Hugging Face revision (provenance)

      --key <KEY>
          Operator signing key file (64 hex chars; see `weaver workload keygen`)

      --registry <REGISTRY>
          Registry file (default: `<runtime dir>/models/registry.json`)

      --trust <TRUST>
          Trust file pinning the operator key (weftos.workload-trust.v1)

      --redistributable
          Explicitly opt in to sharing the weights with other nodes

      --replace
          Replace an existing model of the same name

      --no-advertise
          Do not advertise this model in node facts

  -h, --help
          Print help (see a summary with '-h')

weaver model advertise

Hide a model from node facts, or advertise it again. Shard hashes fingerprint which models this node holds; hidden models are still usable locally

Usage: weaver model advertise [OPTIONS] <MODEL> <STATE>

Arguments:
  <MODEL>  Model name or package id
  <STATE>  `on` to advertise, `off` to hide [possible values: on, off]

Options:
  -v, --verbose              Enable verbose (debug-level) logging
      --registry <REGISTRY>  Registry file (default: `<runtime dir>/models/registry.json`)
  -h, --help                 Print help

weaver model explain

Explain the fetch-versus-relocate decision for a model over described nodes

Usage: weaver model explain [OPTIONS] --node <SPEC> <MODEL>

Arguments:
  <MODEL>  Model name or package id

Options:
      --node <SPEC>          A node: `<id>=complete|none[:<free GiB>][,ineligible]` (repeat)
  -v, --verbose              Enable verbose (debug-level) logging
      --allow-transfer       Allow fetching weights from another node
      --max-gib <MAX_GIB>    Largest transfer, in GiB (default: no ceiling)
      --registry <REGISTRY>  Registry file (default: `<runtime dir>/models/registry.json`)
  -h, --help                 Print help

weaver model list

List adopted models with their current state

Usage: weaver model list [OPTIONS]

Options:
  -v, --verbose              Enable verbose (debug-level) logging
      --registry <REGISTRY>  Registry file (default: `<runtime dir>/models/registry.json`)
  -h, --help                 Print help

weaver model verify

Check an adopted model's files against its attestation

Usage: weaver model verify [OPTIONS] <MODEL>

Arguments:
  <MODEL>  Model name or package id

Options:
      --full                 Re-hash every file, not only those whose size or mtime changed
  -v, --verbose              Enable verbose (debug-level) logging
      --registry <REGISTRY>  Registry file (default: `<runtime dir>/models/registry.json`)
  -h, --help                 Print help

weaver project

Per-project kernel operations (migrate-kernel)

Usage: weaver project [OPTIONS] <COMMAND>

Commands:
  migrate-kernel  Opt one project into a supervised child kernel (or back out)
  add             Add a project to this machine in one step: fetch it, register it, detect how it runs, install its router route, and say what to do next
  up              Start a project added here (process-compose, detached)
  down            Stop a project added here
  status          Show processes, route, local URL and tailnet URL (every added project when no slug)
  remove          Undo what `add` did: stop it, drop its route, unregister it. Keeps the checkout
  anchor          Anchor operations on the user daemon (owner only)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver project add

Add a project to this machine in one step: fetch it, register it, detect how it runs, install its router route, and say what to do next.

SOURCE is `weftos://<mesh>/projects/<ULID>` (over the mesh, from the paired primary) or a git URL. Never copies `.env` files or values; lists the environment variable names the project asks for.

Usage: weaver project add [OPTIONS] <SOURCE>

Arguments:
  <SOURCE>
          What to add: `weftos://<mesh>/projects/<ULID>` (fetched over the mesh from the paired primary), or a git URL (`https://...`, `git@host:org/repo`)

Options:
      --path <PATH>
          Where to put it (default `~/Projects/<slug>`). Must be inside your home directory

  -v, --verbose
          Enable verbose (debug-level) logging

      --slug <SLUG>
          Name for the project: its directory, its route (`/<slug>`) and the handle for `up`/`down`/`status`/`remove`. Defaults to the git repository's name

      --branch <BRANCH>
          Branch to check out

      --project <ULID>
          For a git URL: register the checkout as a working copy of this existing project ULID instead of as a project of its own

      --repo <DIR>
          For a weftos:// name: the project's repository to check out at the target path, when its root is not itself one (`.` names the root). Without it a sole repository is chosen; several are checked out side by side

      --json
          Print the report as JSON

  -h, --help
          Print help (see a summary with '-h')

weaver project anchor

Anchor operations on the user daemon (owner only)

Usage: weaver project anchor [OPTIONS] <COMMAND>

Commands:
  reset  Retire a project's anchor head after its chain was reset on purpose

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver project anchor reset
Retire a project's anchor head after its chain was reset on purpose.

A project whose chain was moved aside restarts its anchors at seq 1, which the user daemon refuses while it holds the old head. This records a signed reset on the user chain (the old statements stay as history) and lets the project anchor again from genesis. Run it only when the project chain really was reset; it changes nothing about the project's key. Needs the owner's local socket (Admin); a token is refused.

Usage: weaver project anchor reset [OPTIONS] --project <PROJECT>

Options:
      --project <PROJECT>
          Project id (a ULID)

  -v, --verbose
          Enable verbose (debug-level) logging

      --reason <REASON>
          Why (kept on the chain; control characters are removed)

          [default: ]

  -h, --help
          Print help (see a summary with '-h')

weaver project down

Stop a project added here

Usage: weaver project down [OPTIONS] <SLUG>

Arguments:
  <SLUG>  The project's slug

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver project migrate-kernel

Opt one project into a supervised child kernel (or back out).

Refuses while the project's own daemon runs (it is never signalled), copies workloads.json and apps.json into <root>/.weftos/state/, sets `[serve] via = "child-kernel"` and prints the rollback line.

Usage: weaver project migrate-kernel [OPTIONS] <PROJECT>

Arguments:
  <PROJECT>
          Project id or unique registered name

Options:
      --dry-run
          Print what would change; change nothing

  -v, --verbose
          Enable verbose (debug-level) logging

      --revert
          Set the project back to the user daemon (copies are left)

  -h, --help
          Print help (see a summary with '-h')

weaver project remove

Undo what `add` did: stop it, drop its route, unregister it. Keeps the checkout

Usage: weaver project remove [OPTIONS] <SLUG>

Arguments:
  <SLUG>  The project's slug

Options:
      --purge    Also delete the checkout (refuses uncommitted changes)
  -v, --verbose  Enable verbose (debug-level) logging
      --force    With --purge: delete even with uncommitted changes
  -h, --help     Print help

weaver project status

Show processes, route, local URL and tailnet URL (every added project when no slug)

Usage: weaver project status [OPTIONS] [SLUG]

Arguments:
  [SLUG]  The project's slug

Options:
      --json     Print JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver project up

Start a project added here (process-compose, detached)

Usage: weaver project up [OPTIONS] <SLUG>

Arguments:
  <SLUG>  The project's slug

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver resource

Resource tree management (tree, inspect, stats)

Usage: weaver resource [OPTIONS] <COMMAND>

Commands:
  tree     Display the full resource tree
  inspect  Inspect a specific resource node
  stats    Show resource tree statistics
  score    Show scoring for a resource node
  rank     Rank resource nodes by composite score
  grant    Grant an ACL action to a principal DID on a resource path (WEFT-554)
  revoke   Revoke a previously granted ACL action (local checker session / re-deny)
  check    Check whether a principal may perform an action on a path (WEFT-554)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver resource check

Check whether a principal may perform an action on a path (WEFT-554)

Usage: weaver resource check [OPTIONS] --principal <PRINCIPAL> --path <PATH>

Options:
  -p, --principal <PRINCIPAL>  Principal DID
  -v, --verbose                Enable verbose (debug-level) logging
  -r, --path <PATH>            Resource path
  -a, --action <ACTION>        Action to check [default: Read]
      --role <ROLE>            Optional role label (Owner|Admin|Operator|Viewer). Default Viewer [default: Viewer]
  -h, --help                   Print help

weaver resource grant

Grant an ACL action to a principal DID on a resource path (WEFT-554).

Runs against a local in-process CapabilityChecker (default-deny). Daemon-persisted ACL is residual — this surfaces the K1 engine for operators and scripts.

Usage: weaver resource grant [OPTIONS] --principal <PRINCIPAL> --path <PATH>

Options:
  -p, --principal <PRINCIPAL>
          Principal DID (e.g. `did:weft:alice` or opaque id)

  -v, --verbose
          Enable verbose (debug-level) logging

  -r, --path <PATH>
          Resource path (e.g. `/apps/secret`)

  -a, --action <ACTION>
          Action: Read | Write | Execute | Admin | Create | Delete

          [default: Read]

  -h, --help
          Print help (see a summary with '-h')

weaver resource inspect

Inspect a specific resource node

Usage: weaver resource inspect [OPTIONS] <PATH>

Arguments:
  <PATH>  Resource path (e.g. "/kernel/services/cron")

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver resource rank

Rank resource nodes by composite score

Usage: weaver resource rank [OPTIONS]

Options:
  -n, --count <COUNT>  Number of top-ranked nodes to show [default: 10]
  -v, --verbose        Enable verbose (debug-level) logging
  -h, --help           Print help

weaver resource revoke

Revoke a previously granted ACL action (local checker session / re-deny)

Usage: weaver resource revoke [OPTIONS] --principal <PRINCIPAL> --path <PATH>

Options:
  -p, --principal <PRINCIPAL>  Principal DID
  -v, --verbose                Enable verbose (debug-level) logging
  -r, --path <PATH>            Resource path
  -a, --action <ACTION>        Action to deny [default: Read]
  -h, --help                   Print help

weaver resource score

Show scoring for a resource node

Usage: weaver resource score [OPTIONS] <PATH>

Arguments:
  <PATH>  Resource path (e.g. "/kernel/agents/worker-1")

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver resource stats

Show resource tree statistics

Usage: weaver resource stats [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver resource tree

Display the full resource tree

Usage: weaver resource tree [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver route

Tailnet router: routes, reload, and the Tailscale Serve front door (ADR-116)

Usage: weaver route [OPTIONS] <COMMAND>

Commands:
  list    Show routes, refused declarations, upstream health and process-compose state
  reload  Re-read every registered project's compose/ports.yaml now
  serve   Show or apply the Tailscale Serve change (`:443 → the router`, tailnet only)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver route list

Show routes, refused declarations, upstream health and process-compose state

Usage: weaver route list [OPTIONS]

Options:
      --json     Print the raw JSON (the `/_weftos/routes.json` document)
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver route reload

Re-read every registered project's compose/ports.yaml now

Usage: weaver route reload [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver route serve

Show or apply the Tailscale Serve change (`:443 → the router`, tailnet only)

Usage: weaver route serve [OPTIONS]

Options:
      --plan                   Print the change and stop
  -v, --verbose                Enable verbose (debug-level) logging
      --apply                  Run the change (after printing it)
      --tailscale <TAILSCALE>  The tailscale binary to run [default: tailscale]
  -h, --help                   Print help

weaver service

Print a launchd / systemd unit for the per-user daemon

Usage: weaver service [OPTIONS] <COMMAND>

Commands:
  unit  Print a service unit for the per-user daemon (never installs it)

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver service unit

Print a service unit for the per-user daemon (never installs it)

Usage: weaver service unit [OPTIONS] --kind <KIND>

Options:
      --kind <KIND>  Service manager the unit is for [possible values: launchd, systemd]
  -v, --verbose      Enable verbose (debug-level) logging
      --out <FILE>   Write the unit to this file instead of printing it
      --force        Overwrite an existing `--out` file
  -h, --help         Print help

weaver soul

Identity-journal operator commands (promote, status)

Usage: weaver soul [OPTIONS] <COMMAND>

Commands:
  promote  Read pending journal entries, show a diff, prompt for confirmation, write the merged result to `.clawft/SOUL.md`, and append a witness audit entry recording the promotion
  status   Show pending journal entries without applying them

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver soul promote

Read pending journal entries, show a diff, prompt for confirmation, write the merged result to `.clawft/SOUL.md`, and append a witness audit entry recording the promotion

Usage: weaver soul promote [OPTIONS]

Options:
  -v, --verbose                Enable verbose (debug-level) logging
  -y, --yes                    Skip the interactive confirmation prompt — apply if non-empty
      --workspace <WORKSPACE>  Workspace path. Defaults to cwd. Mirrors `weaver init`'s flag
  -h, --help                   Print help

weaver soul status

Show pending journal entries without applying them

Usage: weaver soul status [OPTIONS]

Options:
  -v, --verbose                Enable verbose (debug-level) logging
      --workspace <WORKSPACE>  Workspace path. Defaults to cwd
  -h, --help                   Print help

weaver topology

Topology layout, schema validation, and geometry detection

Usage: weaver topology [OPTIONS] <COMMAND>

Commands:
  layout    Compute positioned geometry from a knowledge graph + schema
  validate  Validate a topology schema YAML file
  detect    Auto-detect the best geometry for a knowledge graph
  infer     Infer a topology schema from a knowledge graph
  diff      Diff a declared schema against one inferred from a graph
  slice     Generate sliced graphs for progressive drill-down navigation
  extract   Extract a knowledge graph from a codebase using tree calculus + EML
  vowl      Export a knowledge graph as VOWL JSON for the navigator widget

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver topology detect

Auto-detect the best geometry for a knowledge graph

Usage: weaver topology detect [OPTIONS] <GRAPH>

Arguments:
  <GRAPH>  Path to the knowledge graph JSON

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver topology diff

Diff a declared schema against one inferred from a graph

Usage: weaver topology diff [OPTIONS] <DECLARED> <GRAPH>

Arguments:
  <DECLARED>  Path to the declared schema YAML
  <GRAPH>     Path to the knowledge graph JSON to infer from

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver topology extract

Extract a knowledge graph from a codebase using tree calculus + EML

Usage: weaver topology extract [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to the source code directory

Options:
  -o, --output <OUTPUT>  Output path for the graph JSON [default: graphify-out/graph.json]
  -v, --verbose          Enable verbose (debug-level) logging
      --slices <SLICES>  Also generate slices for the navigator
  -s, --schema <SCHEMA>  Topology schema for slice generation
  -h, --help             Print help

weaver topology infer

Infer a topology schema from a knowledge graph

Usage: weaver topology infer [OPTIONS] <GRAPH>

Arguments:
  <GRAPH>  Path to the knowledge graph JSON

Options:
  -n, --name <NAME>      Name for the inferred schema [default: inferred]
  -v, --verbose          Enable verbose (debug-level) logging
  -o, --output <OUTPUT>  Output path for the inferred schema YAML [default: inferred.topology.yaml]
  -h, --help             Print help

weaver topology layout

Compute positioned geometry from a knowledge graph + schema

Usage: weaver topology layout [OPTIONS] <GRAPH>

Arguments:
  <GRAPH>  Path to the knowledge graph JSON (graphify export)

Options:
  -s, --schema <SCHEMA>  Path to the topology schema YAML
  -v, --verbose          Enable verbose (debug-level) logging
  -o, --output <OUTPUT>  Output path for positioned geometry JSON [default: positioned-graph.json]
      --width <WIDTH>    Viewport width [default: 1200]
      --height <HEIGHT>  Viewport height [default: 800]
  -h, --help             Print help

weaver topology slice

Generate sliced graphs for progressive drill-down navigation

Usage: weaver topology slice [OPTIONS] <GRAPH>

Arguments:
  <GRAPH>  Path to the knowledge graph JSON

Options:
  -s, --schema <SCHEMA>  Path to the topology schema YAML
  -v, --verbose          Enable verbose (debug-level) logging
  -o, --output <OUTPUT>  Output directory for slice JSON files [default: slices]
      --width <WIDTH>    Viewport width [default: 1200]
      --height <HEIGHT>  Viewport height [default: 800]
  -h, --help             Print help

weaver topology validate

Validate a topology schema YAML file

Usage: weaver topology validate [OPTIONS] <SCHEMA>

Arguments:
  <SCHEMA>  Path to the schema YAML

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver topology vowl

Export a knowledge graph as VOWL JSON for the navigator widget

Usage: weaver topology vowl [OPTIONS] <GRAPH>

Arguments:
  <GRAPH>  Path to the knowledge graph JSON

Options:
  -s, --schema <SCHEMA>  Path to the topology schema YAML
  -v, --verbose          Enable verbose (debug-level) logging
  -o, --output <OUTPUT>  Output path for VOWL JSON [default: vowl-graph.json]
  -h, --help             Print help

weaver update

Update weft, weaver and weftos to the latest verified release

Usage: weaver update [OPTIONS] [COMMAND]

Commands:
  check    Same as `weaver update --check`
  install  Same as `weaver update`

Options:
  -v, --verbose                  Enable verbose (debug-level) logging
      --check                    Report whether an update exists and how it would be applied; install nothing
      --dry-run                  Show which binaries would be replaced; download and install nothing
      --force                    Reinstall the same version, or proceed without an install receipt. Never installs an older release
      --allow-downgrade          Install a release older than this build or than the highest version installed before. Unsafe
      --restart                  Restart the per-user daemon after installing, without asking
      --no-restart               Never restart or ask; print the restart command
      --insecure-skip-signature  Install a release without checking its WeaveLogic signature (sha256 still checked). Unsafe
  -h, --help                     Print help

weaver update check

Same as `weaver update --check`

Usage: weaver update check [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver update install

Same as `weaver update`

Usage: weaver update install [OPTIONS]

Options:
      --check                    Report whether an update exists and how it would be applied; install nothing
  -v, --verbose                  Enable verbose (debug-level) logging
      --dry-run                  Show which binaries would be replaced; download and install nothing
      --force                    Reinstall the same version, or proceed without an install receipt. Never installs an older release
      --allow-downgrade          Install a release older than this build or than the highest version installed before. Unsafe
      --restart                  Restart the per-user daemon after installing, without asking
      --no-restart               Never restart or ask; print the restart command
      --insecure-skip-signature  Install a release without checking its WeaveLogic signature (sha256 still checked). Unsafe
  -h, --help                     Print help

weaver vault

Obsidian vault cultivation (frontmatter, links, graph analysis)

Usage: weaver vault [OPTIONS] <COMMAND>

Commands:
  enrich     Add or update YAML frontmatter for markdown files
  analyze    Analyze the vault link graph (orphans, clusters, broken links)
  suggest    Suggest new connections between documents
  auto-link  Insert wikilinks for known document titles in the vault
  backlinks  Generate backlink sections in vault documents

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver vault analyze

Analyze the vault link graph (orphans, clusters, broken links)

Usage: weaver vault analyze [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to the vault directory

Options:
  -f, --format <FORMAT>  Output format: table (default) or json [default: table]
  -v, --verbose          Enable verbose (debug-level) logging
  -h, --help             Print help
Insert wikilinks for known document titles in the vault

Usage: weaver vault auto-link [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to the vault directory

Options:
      --dry-run  Dry-run: show what would change without modifying files
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
Generate backlink sections in vault documents

Usage: weaver vault backlinks [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to the vault directory

Options:
      --dry-run  Dry-run: show what would change without modifying files
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver vault enrich

Add or update YAML frontmatter for markdown files

Usage: weaver vault enrich [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to the vault directory

Options:
      --force    Overwrite existing frontmatter fields (default: only fill empty fields)
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver vault suggest

Suggest new connections between documents

Usage: weaver vault suggest [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to the vault directory

Options:
      --min-score <MIN_SCORE>        Minimum score threshold (default: 5.0) [default: 5]
  -v, --verbose                      Enable verbose (debug-level) logging
      --max-per-file <MAX_PER_FILE>  Max suggestions per file (default: 5) [default: 5]
  -h, --help                         Print help

weaver version

Show version and build info

Usage: weaver version [OPTIONS]

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver versions

Version index of first-class objects: list, tree, deps (ADR-121)

Usage: weaver versions [OPTIONS] <COMMAND>

Commands:
  list            List every recorded version of a kind
  tree            Show the version tree of one object (versions derived from it nest under them)
  deps            Show what an object depends on and what depends on it
  import-catalog  Record a generated agents/catalog.json into the local index

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver versions deps

Show what an object depends on and what depends on it

Usage: weaver versions deps [OPTIONS] <NAME>

Arguments:
  <NAME>

Options:
      --kind <KIND>  [default: agents]
  -v, --verbose      Enable verbose (debug-level) logging
      --json
  -h, --help         Print help

weaver versions import-catalog

Record a generated agents/catalog.json into the local index

Usage: weaver versions import-catalog [OPTIONS]

Options:
      --catalog <CATALOG>  [default: agents/catalog.json]
  -v, --verbose            Enable verbose (debug-level) logging
      --kind <KIND>        [default: agents]
  -h, --help               Print help

weaver versions list

List every recorded version of a kind

Usage: weaver versions list [OPTIONS]

Options:
      --kind <KIND>  [default: agents]
  -v, --verbose      Enable verbose (debug-level) logging
      --json         Print the raw JSON
  -h, --help         Print help

weaver versions tree

Show the version tree of one object (versions derived from it nest under them)

Usage: weaver versions tree [OPTIONS] <NAME>

Arguments:
  <NAME>

Options:
      --kind <KIND>  [default: agents]
  -v, --verbose      Enable verbose (debug-level) logging
      --json
  -h, --help         Print help

weaver workload

Governed workloads placed across the mesh (ADR-099)

Usage: weaver workload [OPTIONS] <COMMAND>

Commands:
  list        List workloads catalogued on this node
  inspect     Show one workload record
  catalog     List cogs across the project's sources with run mode and placement policy (local, no daemon)
  pack        Build (and sign) a cog package from a cog source dir and per-arch binaries
  verify      Verify a package's signatures and file hashes against pinned keys
  keygen      Generate an Ed25519 package-signing key (hex seed, mode 0600)
  place       Place a signed package on the best node (fetch, admit, load, start)
  explain     Decide and explain a placement without dispatching it
  place-seed  Place an operator-pinned store cog on a Cognitum Seed, addressed by its operator-assigned node id (from the daemon's workload-seeds.json)
  status      Placed instances and their live status (or one instance)
  stop        Stop a placed instance (gated and chained on both nodes)
  logs        Captured output of a stopped instance
  revoke      Revoke a package, signer key or artifact hash: this node stops and unloads what it runs from it, drops its bytes, and (with a pinned operator key) tells every peer to do the same. Admin only
  unload      Unload a placed instance, or with `--catalog` a catalogued workload by name
  node        Seed binding (ADR-106): bind, unbind, status

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver workload catalog

List cogs across the project's sources with run mode and placement policy (local, no daemon)

Usage: weaver workload catalog [OPTIONS]

Options:
      --kind <KIND>                  Workload kind to list (only `cog` today) [default: cog]
  -v, --verbose                      Enable verbose (debug-level) logging
      --source <SOURCE>              Only this source
      --json                         Print JSON
      --baseline <BASELINE>          Conformance baseline (default `scripts/cogs/expectations.json` if it exists here)
      --cog-toml-dir <COG_TOML_DIR>  Directory of cog source dirs holding `<id>/cog.toml` (resources, secrets, hardware)
  -h, --help                         Print help

weaver workload explain

Decide and explain a placement without dispatching it

Usage: weaver workload explain [OPTIONS] <PACKAGE>

Arguments:
  <PACKAGE>  Unpacked signed package directory (`weaver workload pack --out`)

Options:
      --peer <PEERS>         `workload-host` address (`host:port`) to also consider (repeat). A peer named here is only `discovered`; assign trust tiers in the daemon's workload-peers.json
  -v, --verbose              Enable verbose (debug-level) logging
      --pin <PIN>            Place on this node id or fail naming the constraint
      --prefer <PREFER>      Prefer these node ids among equally tiered candidates (repeat)
      --avoid <AVOID>        Avoid these node ids unless nothing else fits (repeat)
      --allow-emulated       Allow an emulated route (operator opt-in; recorded as emulated)
      --no-migrate           Never reschedule this instance onto another node when its node is lost (an alert is chained instead). `--pin` has the same effect
      --mode <MODE>          Run mode: once, interval, listener [default: interval]
      --interval <INTERVAL>  Seconds between cycles for `--mode interval` [default: 10]
      --csi-port <CSI_PORT>  UDP port the cog binds for the sensor feed [default: 5006]
      --arg <ARG>            Extra cog argument (repeat, e.g. `--arg=--state-dir --arg=/data/x`). The host checks each against the cog's `[config]` cli_args; `--once`/`--interval` come from `--mode`
      --no-start             Load without starting
      --explain              Print the full explanation (always printed for `explain`)
      --json                 Print raw JSON
  -h, --help                 Print help

weaver workload inspect

Show one workload record

Usage: weaver workload inspect [OPTIONS] <NAME>

Arguments:
  <NAME>  Workload name

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver workload keygen

Generate an Ed25519 package-signing key (hex seed, mode 0600)

Usage: weaver workload keygen [OPTIONS] --out <OUT>

Options:
      --out <OUT>        Output key file (created new, mode 0600)
  -v, --verbose          Enable verbose (debug-level) logging
      --key-id <KEY_ID>  Key id to print in the trust-file snippet (default: derived)
  -h, --help             Print help

weaver workload list

List workloads catalogued on this node

Usage: weaver workload list [OPTIONS]

Options:
      --json     Print raw JSON instead of a table
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver workload logs

Captured output of a stopped instance

Usage: weaver workload logs [OPTIONS] <INSTANCE_ID>

Arguments:
  <INSTANCE_ID>  Instance id

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver workload node

Seed binding (ADR-106): bind, unbind, status

Usage: weaver workload node [OPTIONS] <COMMAND>

Commands:
  bind         Bind a Seed to this mesh (operator-signed, steward-verified)
  unbind       Withdraw the Seed binding (operator-signed; needs no Seed)
  reset-floor  Forget the grant clock high-water mark and restart it from now (undoes a forward clock jump). Shows the floor and the grants it would revive; changes nothing without `--confirm <floor>`
  status       Mesh id and the held binding

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver workload node bind
Bind a Seed to this mesh (operator-signed, steward-verified)

Usage: weaver workload node bind [OPTIONS] --operator-key <OPERATOR_KEY> --grant-pubkey <GRANT_PUBKEY> --grant-fingerprint <GRANT_FINGERPRINT> <SEED_NODE_ID>

Arguments:
  <SEED_NODE_ID>  Operator-assigned Seed node id (from the daemon's workload-seeds.json)

Options:
      --operator-key <OPERATOR_KEY>
          Operator key file (hex seed; `weaver workload keygen`), pinned on the daemon
  -v, --verbose
          Enable verbose (debug-level) logging
      --grant-pubkey <GRANT_PUBKEY>
          The grant public key `weft-licence init` printed (64 hex)
      --grant-fingerprint <GRANT_FINGERPRINT>
          The grant key fingerprint `weft-licence init` printed (`ed25519:` + 16 hex). Compared with the key above before anything is signed
  -h, --help
          Print help
weaver workload node reset-floor
Forget the grant clock high-water mark and restart it from now (undoes a forward clock jump). Shows the floor and the grants it would revive; changes nothing without `--confirm <floor>`

Usage: weaver workload node reset-floor [OPTIONS]

Options:
      --confirm [<FLOOR>]  Apply the reset (chained), pinned to the floor the dry run printed; refused when the floor has moved since
  -v, --verbose            Enable verbose (debug-level) logging
  -h, --help               Print help
weaver workload node status
Mesh id and the held binding

Usage: weaver workload node status [OPTIONS]

Options:
      --json     Print raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help
weaver workload node unbind
Withdraw the Seed binding (operator-signed; needs no Seed)

Usage: weaver workload node unbind [OPTIONS] --operator-key <OPERATOR_KEY>

Options:
      --operator-key <OPERATOR_KEY>  Operator key file (hex seed), pinned on the daemon
  -v, --verbose                      Enable verbose (debug-level) logging
  -h, --help                         Print help

weaver workload pack

Build (and sign) a cog package from a cog source dir and per-arch binaries

Usage: weaver workload pack [OPTIONS] --cog-dir <COG_DIR> --bin <ARCH=PATH> --out <OUT>

Options:
      --cog-dir <COG_DIR>
          Cog source directory holding the unmodified `cog.toml` (e.g. `vendor/cogs/src/cogs/anomaly-detect`)

  -v, --verbose
          Enable verbose (debug-level) logging

      --bin <ARCH=PATH>
          Per-arch binary, `<arch>=<path>` (repeat; arch: aarch64, armv7, x86_64, wasm)

      --out <OUT>
          Output package directory (must not exist or be empty)

      --key <KEY>
          Signing key file (64 hex chars). Omit to write an unsigned package

      --key-id <KEY_ID>
          Key id recorded with the signature (default: derived from the public key)

      --source-commit <SOURCE_COMMIT>
          Source commit (default: `git rev-parse HEAD` in --cog-dir)

      --source-repo <SOURCE_REPO>
          Source repository label

      --release-url <RELEASE_URL>
          Upstream release URL, when packaging released binaries (provenance only)

      --cognitum-record <COGNITUM_RECORD>
          Cognitum ADR-154/155 release record to carry as an attestation

      --redistributable
          Sign the package as redistributable: other nodes may be seeded and served its files over the swarm. Off by default; a package that carries a Cognitum attestation is never redistributed regardless.

          Requires evidence that the binary is not a licensed Cognitum one: a `provenance.json` (from `--provenance`, the cog dir, or next to a `--bin`, where `weaver cog install` writes it) with a trust other than `cognitum-sha256`, and whose sha256 matches a packed binary. Without one, `--redistributable` is refused unless `--no-provenance-ok` is given.

      --provenance <PROVENANCE>
          Explicit `provenance.json` for the binaries (default: the cog dir's, then one next to each `--bin`)

      --no-provenance-ok
          Allow `--redistributable` with no `provenance.json` anywhere (your own build from source). You are asserting the binary is not a Cognitum one

      --store <STORE>
          Also verify and store the package in this file-backed ArtifactStore

      --trust <TRUST>
          Trust file (weftos.workload-trust.v1), required with --store

  -h, --help
          Print help (see a summary with '-h')

weaver workload place

Place a signed package on the best node (fetch, admit, load, start)

Usage: weaver workload place [OPTIONS] <PACKAGE>

Arguments:
  <PACKAGE>  Unpacked signed package directory (`weaver workload pack --out`)

Options:
      --peer <PEERS>         `workload-host` address (`host:port`) to also consider (repeat). A peer named here is only `discovered`; assign trust tiers in the daemon's workload-peers.json
  -v, --verbose              Enable verbose (debug-level) logging
      --pin <PIN>            Place on this node id or fail naming the constraint
      --prefer <PREFER>      Prefer these node ids among equally tiered candidates (repeat)
      --avoid <AVOID>        Avoid these node ids unless nothing else fits (repeat)
      --allow-emulated       Allow an emulated route (operator opt-in; recorded as emulated)
      --no-migrate           Never reschedule this instance onto another node when its node is lost (an alert is chained instead). `--pin` has the same effect
      --mode <MODE>          Run mode: once, interval, listener [default: interval]
      --interval <INTERVAL>  Seconds between cycles for `--mode interval` [default: 10]
      --csi-port <CSI_PORT>  UDP port the cog binds for the sensor feed [default: 5006]
      --arg <ARG>            Extra cog argument (repeat, e.g. `--arg=--state-dir --arg=/data/x`). The host checks each against the cog's `[config]` cli_args; `--once`/`--interval` come from `--mode`
      --no-start             Load without starting
      --explain              Print the full explanation (always printed for `explain`)
      --json                 Print raw JSON
  -h, --help                 Print help

weaver workload place-seed

Place an operator-pinned store cog on a Cognitum Seed, addressed by its operator-assigned node id (from the daemon's workload-seeds.json)

Usage: weaver workload place-seed [OPTIONS] <NODE_ID> <COG>

Arguments:
  <NODE_ID>  Operator-assigned Seed node id
  <COG>      Store cog as `<id>@<version>` (must be pinned for that Seed)

Options:
      --sha256 <SHA256>  Expected SHA-256 of the store binary
  -v, --verbose          Enable verbose (debug-level) logging
      --mode <MODE>      Run mode: once, interval, listener [default: interval]
      --no-start         Install and load without starting
  -h, --help             Print help

weaver workload revoke

Revoke a package, signer key or artifact hash: this node stops and unloads what it runs from it, drops its bytes, and (with a pinned operator key) tells every peer to do the same. Admin only

Usage: weaver workload revoke [OPTIONS] <--package <PACKAGE>|--signer <SIGNER>|--hash <HASH>>

Options:
      --package <PACKAGE>  Package id (the signed statement's BLAKE3, shown by `weaver cog verify`, or a catalog name for `workload install`)
  -v, --verbose            Enable verbose (debug-level) logging
      --signer <SIGNER>    Signer public key (64 hex): revokes every package that key signed
      --hash <HASH>        Artifact BLAKE3 hash (64 hex): a manifest or payload file
      --reason <REASON>    Why (kept in the chain and the revocation list)
      --json               Print raw JSON
  -h, --help               Print help

weaver workload status

Placed instances and their live status (or one instance)

Usage: weaver workload status [OPTIONS] [INSTANCE_ID]

Arguments:
  [INSTANCE_ID]  Instance id (omit for all placements)

Options:
      --json     Print raw JSON
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver workload stop

Stop a placed instance (gated and chained on both nodes)

Usage: weaver workload stop [OPTIONS] <INSTANCE_ID>

Arguments:
  <INSTANCE_ID>  Instance id

Options:
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver workload unload

Unload a placed instance, or with `--catalog` a catalogued workload by name

Usage: weaver workload unload [OPTIONS] <TARGET>

Arguments:
  <TARGET>  Instance id (or catalog name with `--catalog`)

Options:
      --catalog  Remove a node-local catalog entry instead of a placed instance
  -v, --verbose  Enable verbose (debug-level) logging
  -h, --help     Print help

weaver workload verify

Verify a package's signatures and file hashes against pinned keys

Usage: weaver workload verify [OPTIONS] [DIR]

Arguments:
  [DIR]  Package directory (holding `cogpkg.json`)

Options:
      --trust <TRUST>          Trust file (weftos.workload-trust.v1). Without it only the compiled-in WeftOS signer set is trusted
  -v, --verbose                Enable verbose (debug-level) logging
      --cognitum-release       Accept a valid Cognitum release record (pinned key) as a signature
      --cog-toml-pin <BLAKE3>  BLAKE3 of a reviewed `cog.toml` to pin for record-only trust (repeat). A Cognitum record does not cover `cog.toml`, so a package trusted by a record alone is refused unless its `cog.toml` hash is pinned here
      --store <STORE>          Verify from a file-backed ArtifactStore instead of a directory
      --manifest <MANIFEST>    Manifest artifact hash (printed by `pack --store`)
      --json                   Emit a JSON result on stdout
  -h, --help                   Print help

On this page

Commandsweaverweaver agentweaver agent attachweaver agent inspectweaver agent listweaver agent restartweaver agent sendweaver agent spawnweaver agent stopweaver appweaver app inspectweaver app installweaver app listweaver app removeweaver app startweaver app stopweaver benchmarkweaver benchmark lastweaver benchmark runweaver chainweaver chain checkpointweaver chain exportweaver chain localweaver chain statusweaver chain verifyweaver clusterweaver cluster healthweaver cluster joinweaver cluster leaveweaver cluster nodesweaver cluster shardsweaver cluster statusweaver cogweaver cog checkoutweaver cog checkout approveweaver cog checkout listweaver cog checkout releaseweaver cog checkout renewweaver cog checkout reset-floorweaver cog checkout statusweaver cog infoweaver cog installweaver cog licenceweaver cog licence addweaver cog licence listweaver cog licence removeweaver cog searchweaver cog sourceweaver cog source addweaver cog source disableweaver cog source enableweaver cog source listweaver cog source removeweaver cogbusweaver cogbus listweaver consoleweaver cronweaver cron addweaver cron listweaver cron removeweaver custodyweaver custody attestweaver dashboardweaver dashboard actionsweaver dashboard rotate-tokenweaver dashboard statusweaver doctorweaver eccweaver ecc calibrateweaver ecc causalweaver ecc crossrefsweaver ecc searchweaver ecc spatialweaver ecc spatial branchweaver ecc spatial branch deriveweaver ecc spatial branch listweaver ecc spatial diffweaver ecc spatial eventsweaver ecc spatial insertweaver ecc spatial queryweaver ecc spatial query aabbweaver ecc spatial query knnweaver ecc spatial query pointweaver ecc spatial query rayweaver ecc spatial query sphereweaver ecc spatial replayweaver ecc spatial statusweaver ecc statusweaver ecc tickweaver ecc vector-configweaver exposeweaver expose listweaver expose logweaver expose offweaver expose onweaver expose pauseweaver fleetweaver fleet locationweaver fleet location setweaver fleet statusweaver graphifyweaver graphify diffweaver graphify exportweaver graphify hooksweaver graphify hooks installweaver graphify hooks statusweaver graphify hooks uninstallweaver graphify ingestweaver graphify queryweaver graphify rebuildweaver graphify serveweaver graphify watchweaver initweaver ipcweaver ipc publishweaver ipc subscribeweaver ipc topicsweaver kernelweaver kernel attachweaver kernel livenessweaver kernel logsweaver kernel psweaver kernel restartweaver kernel rotate-keyweaver kernel servicesweaver kernel startweaver kernel statusweaver kernel stopweaver leafweaver leaf enqueueweaver leaf enrollweaver leaf provisionweaver leaf pushweaver leaf push chordweaver leaf push scuttleweaver leaf replayweaver leaf sceneweaver leaf scene clearweaver leaf scene psweaver leaf scene pushweaver leaf scene snapshotweaver leaf statusweaver meshweaver mesh adopt-licenceweaver mesh bindweaver mesh bind approveweaver mesh bind rebindweaver mesh bind revokeweaver mesh bindingsweaver mesh createweaver mesh exportweaver mesh idweaver mesh identityweaver mesh importweaver mesh install-serviceweaver mesh journalweaver mesh journal verifyweaver mesh nonceweaver mesh nonce generateweaver mesh pairweaver mesh pair cancelweaver mesh pair listweaver mesh pair requestweaver mesh peerweaver mesh peer revokeweaver mesh peer unrevokeweaver mesh serveweaver mesh statusweaver mesh trustweaver mesh uninstall-serviceweaver migrateweaver migrate user-chainweaver migrate user-keyweaver modelweaver model adoptweaver model advertiseweaver model explainweaver model listweaver model verifyweaver projectweaver project addweaver project anchorweaver project anchor resetweaver project downweaver project migrate-kernelweaver project removeweaver project statusweaver project upweaver resourceweaver resource checkweaver resource grantweaver resource inspectweaver resource rankweaver resource revokeweaver resource scoreweaver resource statsweaver resource treeweaver routeweaver route listweaver route reloadweaver route serveweaver serviceweaver service unitweaver soulweaver soul promoteweaver soul statusweaver topologyweaver topology detectweaver topology diffweaver topology extractweaver topology inferweaver topology layoutweaver topology sliceweaver topology validateweaver topology vowlweaver updateweaver update checkweaver update installweaver vaultweaver vault analyzeweaver vault auto-linkweaver vault backlinksweaver vault enrichweaver vault suggestweaver versionweaver versionsweaver versions depsweaver versions import-catalogweaver versions listweaver versions treeweaver workloadweaver workload catalogweaver workload explainweaver workload inspectweaver workload keygenweaver workload listweaver workload logsweaver workload nodeweaver workload node bindweaver workload node reset-floorweaver workload node statusweaver workload node unbindweaver workload packweaver workload placeweaver workload place-seedweaver workload revokeweaver workload statusweaver workload stopweaver workload unloadweaver workload verify