Store Commands

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

# The 'weave' CLI exposes one subcommand per storage subsystem. Each command
# maps directly to a method on the underlying SDK (Strand / Locus / Lens / Nexus
# / Forum / Gnosis / Basis).

# Strand (append-only log)
weave strand create audit-log
weave strand append audit-log "first event"
weave strand get audit-log 0

# Locus (POSIX-shaped drive)
weave locus init workspace
weave locus write workspace /docs/intro.md "hello"
weave locus ls workspace /docs

# Lens (B-tree KV)
weave lens open settings
weave lens put settings theme dark
weave lens get settings theme

# Nexus (merged view of multiple strands)
weave nexus create merged
weave nexus add-input merged audit-log
weave nexus view merged --limit 50