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 agentweaver appweaver benchmarkweaver chainweaver clusterweaver cogweaver cogbusweaver consoleweaver cronweaver custodyweaver dashboardweaver doctorweaver eccweaver exposeweaver fleetweaver graphifyweaver initweaver ipcweaver kernelweaver leafweaver meshweaver migrateweaver modelweaver projectweaver resourceweaver routeweaver serviceweaver soulweaver topologyweaver updateweaver vaultweaver versionweaver versionsweaver workload
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 versionweaver 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 helpweaver 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 helpweaver 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 helpweaver agent list
List all agent processes
Usage: weaver agent list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver app list
List installed applications
Usage: weaver app list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver chain checkpoint
Create a chain checkpoint
Usage: weaver chain checkpoint [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver chain status
Show local chain status
Usage: weaver chain status [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver chain verify
Verify chain integrity (hash linking)
Usage: weaver chain verify [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver cluster health
Show per-node health status
Usage: weaver cluster health [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver cluster shards
Show shard distribution
Usage: weaver cluster shards [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver cog licence list
List the effective licences
Usage: weaver cog licence list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver cog search
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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver cron list
List all cron jobs
Usage: weaver cron list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver custody attest
Generate a signed custody attestation document
Usage: weaver custody attest [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver ecc calibrate
Re-run boot calibration
Usage: weaver ecc calibrate [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver ecc search
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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver ecc spatial branch list
List branches
Usage: weaver ecc spatial branch list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver ecc tick
Show current tick statistics
Usage: weaver ecc tick [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver resource stats
Show resource tree statistics
Usage: weaver resource stats [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver resource tree
Display the full resource tree
Usage: weaver resource tree [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver update check
Same as `weaver update --check`
Usage: weaver update check [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver vault auto-link
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 helpweaver vault backlinks
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 helpweaver 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 helpweaver 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 helpweaver version
Show version and build info
Usage: weaver version [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-h, --help Print helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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 helpweaver 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