CLI Map

Purpose

Main Weave CLI and TUI covering strand, dSocial, Locus, Lens, Nexus, DHT, AgentFS, mirror, config, forum, gnosis, and basis commands.

This page follows the real source shape for Weave and explains the workflow a developer is likely to use first.

Command surface

Use this page to understand the operational commands exposed by the tool. Prefer command groups that match the subsystem you are testing, then inspect the API surface page for the exact Rust enum or command handler.

Primary types to know

• App — tools/weave/src/tui/app.rs
• Cli — tools/weave/src/cli.rs
• NetworkConfig — tools/weave/src/config.rs
• PeerInfo — tools/weave/src/tui/app.rs
• StorageConfig — tools/weave/src/config.rs
• TuiConfig — tools/weave/src/config.rs
• WeaveConfig — tools/weave/src/config.rs
• AgentFsCommand — tools/weave/src/cli.rs
• BasisCommand — tools/weave/src/cli.rs
• Command — tools/weave/src/cli.rs
• ConfigCommand — tools/weave/src/cli.rs
• DhtCommand — tools/weave/src/cli.rs

Example shape

# Top-level command map (every subsystem has its own subtree).

weave init --storage ~/.weave --namespace l1fe --identifier my-agent

# Storage subsystems
weave strand <create|append|get|info|sub>
weave locus  <init|read|write|mkdir|ls|rm|sync>
weave lens   <open|put|get|delete|scan>
weave nexus  <create|add-input|view>
weave forum  <write|read|take>
weave gnosis <add|query|neighbors>
weave basis  <add|search|remove>

# Network + daemon
weave daemon --listen /ip4/0.0.0.0/udp/4040/quic
weave dht    <peers|listeners|announce|resolve>
weave swarm  <dial|join|leave>

# Operator
weave config <show|set|get>
weave tui          # interactive curses dashboard
weave agentfs init # local AgentFS scaffolding