CLI Reference: weft
Generated reference for every weft command and subcommand, taken from the built binary.
Generated by scripts/gen-cli-reference.sh from weft --help. Do not edit by hand; run scripts/build.sh gen-cli-reference.
Commands
weft agentweft agentsweft analyzeweft assessweft channelsweft completionsweft configweft cosweft cronweft delegateweft doctorweft gatewayweft mcpweft mcp-serverweft memoryweft onboardweft pluginsweft projectweft routingweft securityweft sessionsweft skillsweft statusweft swarmweft tokenweft toolsweft uiweft updateweft workspace
weft
WeftOS AI assistant CLI
Usage: weft [OPTIONS] <COMMAND>
Commands:
agent Start an interactive agent session or send a single message
gateway Start the gateway (channels + agent loop)
cos Chief-of-staff agent host: conversation API and push-to-talk (ADR-118)
mcp Manage MCP server connections (add / list / remove)
mcp-server Run as an MCP tool server over stdio
status Show configuration status
channels Inspect channel configuration
cron Manage scheduled (cron) jobs
sessions Manage agent sessions
memory Read and search agent memory
config Show resolved configuration
skills Manage skills (list, show, install)
tools Manage tools (list, show, search, deny/allow)
agents Manage agents (list, show, use)
swarm Multi-agent swarm demo (AgentBus + SwarmCoordinator)
delegate Inspect task-delegation routing decisions
routing Context-router decision trace and replay (WEFT-336)
doctor Environment and multi-agent readiness checks
project Manage projects (init, fork, list, show, seed)
workspace Manage workspaces
token Issue, revoke and list daemon bearer tokens (ADR-102)
onboard Initialize clawft config and workspace
analyze Code analysis: extract graphs, detect topology, enrich docs
assess Run SOP assessment workflow (analyze codebase, report findings)
plugins Plugin development tools (create, validate, package)
security Security scanning, auditing, and hardening
ui Start the web dashboard (gateway + API + browser)
help Show help for a topic (skills, agents, tools, commands, config)
update Update weft and weaver binaries to latest release
completions Generate shell completions
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print help
-V, --version Print versionweft agent
Start an interactive agent session or send a single message
Usage: weft agent [OPTIONS]
Options:
-m, --message <MESSAGE>
Send a single message and exit (non-interactive mode).
Each `-m` turn starts a fresh conversation with no prior history unless `--session` names one to continue.
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--session <ID>
Continue a named conversation with `-m` (letters, digits, `.`, `_`, `-`; up to 128 characters). Two `-m` calls with the same `--session` share history. The interactive REPL keeps its own `cli-session` conversation and does not take this flag
--model <MODEL>
Model to use (overrides config)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-c, --config <CONFIG>
Config file path (overrides auto-discovery)
--intelligent-routing
Enable intelligent routing (requires vector-memory feature)
--local
Run the agent loop inside this process when no kernel daemon is reachable. Without it, a missing daemon is an error: an in-process agent can run tools and write files the daemon never sees
--trust-project-skills
Trust workspace-level (project) skills.
Without this flag, only user and built-in skills are loaded. Workspace skills in `.clawft/skills/` are skipped as a security measure (SEC-SKILL-05).
-h, --help
Print help (see a summary with '-h')weft agents
Manage agents (list, show, use)
Usage: weft agents [OPTIONS] <COMMAND>
Commands:
list List all agents with source annotation
show Show details of a specific agent
use Set the active agent for the next session
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft agents list
List all agents with source annotation
Usage: weft agents list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft agents show
Show details of a specific agent
Usage: weft agents show [OPTIONS] <NAME>
Arguments:
<NAME> Agent name to inspect
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft agents use
Set the active agent for the next session
Usage: weft agents use [OPTIONS] <NAME>
Arguments:
<NAME> Agent name to activate
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze
Code analysis: extract graphs, detect topology, enrich docs
Usage: weft analyze [OPTIONS] <COMMAND>
Commands:
extract Extract a knowledge graph from a codebase
detect Detect the topology structure of a knowledge graph
infer Infer a topology schema from a knowledge graph
diff Diff declared schema against inferred from graph
slice Generate drill-down slices for the navigator
vowl Export graph as VOWL JSON for the navigator widget
enrich Enrich markdown files with YAML frontmatter
links Analyze vault link graph (orphans, clusters, density)
suggest Suggest new connections between documents
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze detect
Detect the topology structure of a knowledge graph
Usage: weft analyze detect [OPTIONS] <GRAPH>
Arguments:
<GRAPH> Path to graph JSON
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze diff
Diff declared schema against inferred from graph
Usage: weft analyze diff [OPTIONS] <SCHEMA> <GRAPH>
Arguments:
<SCHEMA> Declared schema YAML
<GRAPH> Knowledge graph JSON
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze enrich
Enrich markdown files with YAML frontmatter
Usage: weft analyze enrich [OPTIONS] [PATH]
Arguments:
[PATH] Path to document directory [default: .]
Options:
--force Overwrite existing frontmatter
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze extract
Extract a knowledge graph from a codebase
Usage: weft analyze extract [OPTIONS] [PATH]
Arguments:
[PATH] Path to source code [default: .]
Options:
-o, --output <OUTPUT> Output path for graph JSON [default: graphify-out/graph.json]
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--slices <SLICES> Also generate navigator slices
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze infer
Infer a topology schema from a knowledge graph
Usage: weft analyze infer [OPTIONS] <GRAPH>
Arguments:
<GRAPH> Path to graph JSON
Options:
-o, --output <OUTPUT> Output path for schema YAML [default: inferred.topology.yaml]
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze links
Analyze vault link graph (orphans, clusters, density)
Usage: weft analyze links [OPTIONS] [PATH]
Arguments:
[PATH] Path to document directory [default: .]
Options:
-f, --format <FORMAT> Output format: table or json [default: table]
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze slice
Generate drill-down slices for the navigator
Usage: weft analyze slice [OPTIONS] <GRAPH>
Arguments:
<GRAPH> Path to graph JSON
Options:
-o, --output <OUTPUT> Output directory [default: slices]
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze suggest
Suggest new connections between documents
Usage: weft analyze suggest [OPTIONS] [PATH]
Arguments:
[PATH] Path to document directory [default: .]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft analyze vowl
Export graph as VOWL JSON for the navigator widget
Usage: weft analyze vowl [OPTIONS] <GRAPH>
Arguments:
<GRAPH> Path to graph JSON
Options:
-o, --output <OUTPUT> Output path [default: vowl-graph.json]
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft assess
Run SOP assessment workflow (analyze codebase, report findings)
Usage: weft assess [OPTIONS] [COMMAND]
Commands:
run Run an assessment (default if no subcommand given)
status Show status of the last assessment
init Initialize assessment configuration in .weftos/
link Link two projects for cross-project coordination
peers Show linked peers and cross-project status
compare Compare assessment results across linked projects
hooks Install git hooks for automatic assessment on commit
review Review assessment trends and generate SOP improvement recommendations
mesh-status Show assessment mesh peer state (WEFT-117)
Options:
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-s, --scope <SCOPE>
Assessment scope (when running without a subcommand)
Possible values:
- full: Full rescan of all files matching configured patterns
- commit: Only files changed in the last git commit
- ci: All files changed in the current PR/push (CI mode)
- dependency: Only dependency manifests (Cargo.toml, package.json, etc.)
[default: full]
-f, --format <FORMAT>
Output format
Possible values:
- table: Human-readable summary table
- json: Machine-readable JSON
- github-annotations: GitHub Actions annotation format
[default: table]
-d, --dir <DIR>
Project directory to assess (defaults to current directory)
-h, --help
Print help (see a summary with '-h')weft assess compare
Compare assessment results across linked projects
Usage: weft assess compare [OPTIONS] <PEER>
Arguments:
<PEER> Peer name to compare against
Options:
-d, --dir <DIR> Project directory
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft assess hooks
Install git hooks for automatic assessment on commit
Usage: weft assess hooks [OPTIONS]
Options:
--hook-type <HOOK_TYPE> Hook type: "post-commit" or "pre-push" [default: post-commit]
-v, --verbose Enable verbose (debug-level) logging
-d, --dir <DIR> Project directory
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--uninstall Remove installed hooks
-h, --help Print helpweft assess init
Initialize assessment configuration in .weftos/
Usage: weft assess init [OPTIONS]
Options:
-d, --dir <DIR> Project directory
-v, --verbose Enable verbose (debug-level) logging
--force Overwrite existing config
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft assess link
Link two projects for cross-project coordination
Usage: weft assess link [OPTIONS] <NAME> <PATH>
Arguments:
<NAME> Name for the peer project
<PATH> Path to the peer project's .weftos/ directory
Options:
-d, --dir <DIR> Project directory (this project)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft assess mesh-status
Show assessment mesh peer state (WEFT-117).
Reports whether mesh assessment coordination is enabled and the last-known gossip state of each peer. Requires a running daemon with mesh enabled; falls back to a local "disabled" summary.
Usage: weft assess mesh-status [OPTIONS]
Options:
--json
Output as JSON
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft assess peers
Show linked peers and cross-project status
Usage: weft assess peers [OPTIONS]
Options:
-d, --dir <DIR> Project directory
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft assess review
Review assessment trends and generate SOP improvement recommendations
Usage: weft assess review [OPTIONS]
Options:
-n, --history <HISTORY> Number of past assessments to analyze [default: 5]
-v, --verbose Enable verbose (debug-level) logging
-d, --dir <DIR> Project directory
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft assess run
Run an assessment (default if no subcommand given)
Usage: weft assess run [OPTIONS]
Options:
-s, --scope <SCOPE>
Assessment scope
Possible values:
- full: Full rescan of all files matching configured patterns
- commit: Only files changed in the last git commit
- ci: All files changed in the current PR/push (CI mode)
- dependency: Only dependency manifests (Cargo.toml, package.json, etc.)
[default: full]
-v, --verbose
Enable verbose (debug-level) logging
-f, --format <FORMAT>
Output format
Possible values:
- table: Human-readable summary table
- json: Machine-readable JSON
- github-annotations: GitHub Actions annotation format
[default: table]
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
-d, --dir <DIR>
Project directory to assess
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--pr-number <PR_NUMBER>
PR number for github-pr format
-h, --help
Print help (see a summary with '-h')weft assess status
Show status of the last assessment
Usage: weft assess status [OPTIONS]
Options:
-d, --dir <DIR> Project directory
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft channels
Inspect channel configuration
Usage: weft channels [OPTIONS] <COMMAND>
Commands:
status Show channel status table
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft channels status
Show channel status table
Usage: weft channels status [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft completions
Generate shell completions
Usage: weft completions [OPTIONS] <SHELL>
Arguments:
<SHELL> Shell to generate for (bash, zsh, fish, powershell)
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft config
Show resolved configuration
Usage: weft config [OPTIONS] <COMMAND>
Commands:
show Show the full resolved configuration
section Show a specific configuration section
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft config section
Show a specific configuration section
Usage: weft config section [OPTIONS] <NAME>
Arguments:
<NAME> Section name (e.g., "agents", "gateway", "channels")
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft config show
Show the full resolved configuration
Usage: weft config show [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft cos
Chief-of-staff agent host: conversation API and push-to-talk (ADR-118)
Usage: weft cos [OPTIONS] <COMMAND>
Commands:
serve Start the agent and its loopback conversation API (127.0.0.1:18300)
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft cos serve
Start the agent and its loopback conversation API (127.0.0.1:18300)
Usage: weft cos serve [OPTIONS]
Options:
--config <CONFIG> Host config (default ~/.config/weftos/cos.json when present)
-v, --verbose Enable verbose (debug-level) logging
--bind <BIND> Override the loopback bind address
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--mic Push-to-talk from the terminal: Enter starts and stops a capture
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--no-stdin Do not read the terminal; serve the API only
--start-model Start the local model server first when it is down (detached), wait for it, and stop it again when this process exits
-h, --help Print helpweft cron
Manage scheduled (cron) jobs
Usage: weft cron [OPTIONS] <COMMAND>
Commands:
list List all cron jobs
add Add a new cron job
remove Remove a cron job by ID
enable Enable a cron job
disable Disable a cron job
run Manually trigger a cron job
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft cron add
Add a new cron job
Usage: weft cron add [OPTIONS] --name <NAME> --schedule <SCHEDULE> --prompt <PROMPT>
Options:
--name <NAME> Human-readable job name
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--schedule <SCHEDULE> Cron expression (e.g. "0 9 * * Mon-Fri")
--prompt <PROMPT> Agent prompt to execute when the job fires
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-h, --help Print helpweft cron disable
Disable a cron job
Usage: weft cron disable [OPTIONS] <JOB_ID>
Arguments:
<JOB_ID> Job ID to disable
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft cron enable
Enable a cron job
Usage: weft cron enable [OPTIONS] <JOB_ID>
Arguments:
<JOB_ID> Job ID to enable
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft cron list
List all cron jobs
Usage: weft cron list [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft cron remove
Remove a cron job by ID
Usage: weft cron remove [OPTIONS] <JOB_ID>
Arguments:
<JOB_ID> Job ID to remove
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft cron run
Manually trigger a cron job
Usage: weft cron run [OPTIONS] <JOB_ID>
Arguments:
<JOB_ID> Job ID to run
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft delegate
Inspect task-delegation routing decisions
Usage: weft delegate [OPTIONS] <COMMAND>
Commands:
debug Show which target a free-text task would route to
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft delegate debug
Show which target a free-text task would route to.
Exercises the configured [`DelegationEngine`] (rules + complexity heuristic) and prints the resolved target, complexity score, matched rule, and availability inputs.
Usage: weft delegate debug [OPTIONS] <TASK>
Arguments:
<TASK>
Free-text task description to evaluate
Options:
-c, --config <CONFIG>
Config file path (overrides auto-discovery)
-v, --verbose
Enable verbose (debug-level) logging
--json
Emit machine-readable JSON instead of human text
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--claude-available <CLAUDE_AVAILABLE>
Override Claude availability for the decision (`true` / `false`). Default: true when an Anthropic API key is present in env or providers config, else false
[possible values: true, false]
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft doctor
Environment and multi-agent readiness checks
Usage: weft doctor [OPTIONS] [COMPONENT]...
Arguments:
[COMPONENT]... Limit to these components (also accepted as `--component`) [possible values: install, daemon, runtime, config, mcp, agents]
Options:
--component <COMPONENT> Component(s) to check: install, daemon, runtime, config, mcp, agents [possible values: install, daemon, runtime, config, mcp, agents]
-v, --verbose Enable verbose (debug-level) logging
-c, --config <CONFIG> Config file path (overrides auto-discovery)
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--strict Treat warnings as failures (non-zero exit)
--multi-agent Only run multi-agent related checks (same as `--component agents`)
--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 helpweft gateway
Start the gateway (channels + agent loop)
Usage: weft gateway [OPTIONS]
Options:
-c, --config <CONFIG>
Config file path (overrides auto-discovery)
-v, --verbose
Enable verbose (debug-level) logging
--intelligent-routing
Enable intelligent routing (requires vector-memory feature)
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--dangerously-plain-http
Serve the API over plain HTTP on a non-loopback address.
A bearer token grants the full API, so a non-loopback bind is refused unless TLS is terminated in front of the gateway and this is set (or `gateway.dangerously_plain_http`).
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--static-dir <STATIC_DIR>
Serve the built cog-manager web console from this directory under `/console/` (overrides `gateway.staticDir`)
-h, --help
Print help (see a summary with '-h')weft mcp
Manage MCP server connections (add / list / remove)
Usage: weft mcp [OPTIONS] <COMMAND>
Commands:
add Add or replace an MCP server in config
list List configured MCP servers
remove Remove an MCP server from config
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft mcp add
Add or replace an MCP server in config
Usage: weft mcp add [OPTIONS] <NAME> [-- <REST>...]
Arguments:
<NAME>
Unique server name (key under tools.mcp_servers)
[REST]...
Trailing command + args after `--` (claude-style): `weft mcp add name -- npx -y @pkg`
Options:
--command <COMMAND>
Stdio command to spawn (e.g. `npx`, `uvx`, `claude`)
-v, --verbose
Enable verbose (debug-level) logging
--arg <ARGS>
Command arguments (repeatable; may start with `-`)
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--url <URL>
Streamable HTTP endpoint URL
--env <KEY=VALUE>
Extra environment variables (`KEY=VALUE`, repeatable)
--internal-only [<INTERNAL_ONLY>]
If true, tools are not registered in the ToolRegistry (default: true).
Pass `--internal-only=false` to register tools for LLM use.
[default: true]
[possible values: true, false]
-c, --config <CONFIG>
Config file path (overrides auto-discovery)
-h, --help
Print help (see a summary with '-h')weft mcp list
List configured MCP servers
Usage: weft mcp list [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft mcp remove
Remove an MCP server from config
Usage: weft mcp remove [OPTIONS] <NAME>
Arguments:
<NAME> Server name to remove
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft mcp-server
Run as an MCP tool server over stdio
Usage: weft mcp-server [OPTIONS]
Options:
-c, --config <CONFIG>
Config file path (overrides auto-discovery)
-v, --verbose
Enable verbose (debug-level) logging
--profile <PROFILE>
Serve profile: `default` | `control` | `workspace` | `media` | `full` (comma-compose, e.g. `control,media`). Default = `default` (`control` ∪ `workspace`) — not full dump. See ADR-076
[default: default]
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--reexport-mcp
Re-export inbound/proxied external MCP tools onto this server. Requires `--profile full` (ADR-076 §8). Off by default even for `full` — prevents recursion / tool floods through peer clients
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--attach
Attach control tools to a live kernel/weave daemon (ADR-076 C3).
Dispatches `status` / `agent_list` / `agent_spawn` / `agent_stop` via weave RPC. Fails at startup if no daemon is running. Standalone (this flag omitted) remains the offline/dev default.
--listen <HOST:PORT>
Listen for remote MCP over HTTP/SSE (ADR-075 G4). Format: `host:port` (e.g. `127.0.0.1:8742`). When set, stdio is not used.
Auth is required by default (`--token` / `--token-env` / `WEFT_MCP_TOKEN`). Non-loopback bind requires `--dangerously-bind-public`.
--token <TOKEN>
Bearer capability token for `--listen` auth (WEFT-696 / WEFT-697). Prefer `--token-env` so the secret does not appear in process listings
--token-env <ENV_VAR>
Read bearer token from this environment variable (default search: `WEFT_MCP_TOKEN` when `--listen` is set and `--token` is omitted)
--allow-unauthenticated
Allow unauthenticated MCP (loopback only). Never permits open public bind
--dangerously-bind-public
Explicit opt-in to bind a non-loopback address (`0.0.0.0`, LAN IP, …). Still requires auth; open public bind is refused
--enterprise
Enterprise reduced scopes: force no `agent_spawn` and a restricted tool pattern set on every session token (WEFT-697)
--issue-token
Issue a one-shot capability token to stdout and exit (JSON: `{ "token", "scopes", "client_label" }`). Useful for minting remote Grok headers without running the server. Does not print secrets of other sessions
--client-label <CLIENT_LABEL>
Client label to stamp on `--issue-token` (`grok` | `claude` | `unknown`)
[default: unknown]
-h, --help
Print help (see a summary with '-h')weft memory
Read and search agent memory
Usage: weft memory [OPTIONS] <COMMAND>
Commands:
show Display long-term memory (MEMORY.md)
history Display session history (HISTORY.md)
search Search memory and history
reindex Rebuild the vector memory index from MEMORY.md (WEFT-84)
export Export memory to a file
import Import memory from a file
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft memory export
Export memory to a file
Usage: weft memory export [OPTIONS] --agent <AGENT> --output <OUTPUT>
Options:
--agent <AGENT> Agent ID to export memory for
-v, --verbose Enable verbose (debug-level) logging
-o, --output <OUTPUT> Output file path
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--format <FORMAT> Export format: "json" or "rvf" (default: "json") [default: json]
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-h, --help Print helpweft memory history
Display session history (HISTORY.md)
Usage: weft memory history [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft memory import
Import memory from a file
Usage: weft memory import [OPTIONS] --agent <AGENT> --input <INPUT>
Options:
--agent <AGENT> Agent ID to import memory into
-v, --verbose Enable verbose (debug-level) logging
-i, --input <INPUT> Input file path
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--skip-verify Skip WITNESS chain validation
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-h, --help Print helpweft memory reindex
Rebuild the vector memory index from MEMORY.md (WEFT-84).
Always reindexes, even when the existing `memory.rvf` is newer than MEMORY.md. Bootstrap also rebuilds automatically when MEMORY.md is newer (mtime check).
Usage: weft memory reindex [OPTIONS]
Options:
-c, --config <CONFIG>
Config file path (overrides auto-discovery)
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft memory search
Search memory and history
Usage: weft memory search [OPTIONS] <QUERY>
Arguments:
<QUERY> Search query
Options:
--limit <LIMIT> Maximum number of results [default: 10]
-v, --verbose Enable verbose (debug-level) logging
-c, --config <CONFIG> Config file path (overrides auto-discovery)
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft memory show
Display long-term memory (MEMORY.md)
Usage: weft memory show [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft onboard
Initialize clawft config and workspace
Usage: weft onboard [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
-y, --yes Skip interactive prompts and use defaults
--dir <DIR> Override the config directory (default: ~/.clawft)
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft plugins
Plugin development tools (create, validate, package)
Usage: weft plugins [OPTIONS] <COMMAND>
Commands:
create Scaffold a new WeftOS plugin crate
templates List available plugin templates
validate Validate a plugin crate structure
inspect Show aggregate fuel, memory, and invocation metrics for a plugin
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft plugins create
Scaffold a new WeftOS plugin crate
Usage: weft plugins create [OPTIONS] <NAME>
Arguments:
<NAME> Plugin name (e.g. "my-analyzer")
Options:
--plugin-type <PLUGIN_TYPE> Plugin type: "analyzer", "channel", "tool", or "generic" [default: analyzer]
-v, --verbose Enable verbose (debug-level) logging
-d, --dir <DIR> Output directory (defaults to current directory)
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft plugins inspect
Show aggregate fuel, memory, and invocation metrics for a plugin.
Reads the per-plugin snapshot under `~/.clawft/plugins/metrics/` (written by the WASM host after each invocation) and prints the pinned WEFT-68 metric shape. When no snapshot exists, prints a zeroed shape so consumers can still depend on the field set.
Usage: weft plugins inspect [OPTIONS] <NAME>
Arguments:
<NAME>
Plugin name or id (e.g. `my-analyzer` or `weftos.plugin.my-analyzer`)
Options:
--json
Emit raw JSON instead of a table
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft plugins templates
List available plugin templates
Usage: weft plugins templates [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft plugins validate
Validate a plugin crate structure
Usage: weft plugins validate [OPTIONS] <PATH>
Arguments:
<PATH> Path to plugin crate root
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft project
Manage projects (init, fork, list, show, seed)
Usage: weft project [OPTIONS] <COMMAND>
Commands:
init Give the current tree a project identity and register it
list List registered projects
show Show one project (default: the one containing the current directory)
seed Import ~/.clawft/workspaces.json into the project index
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft project init
Give the current tree a project identity and register it
Usage: weft project init [OPTIONS]
Options:
--name <NAME> Project name (defaults to the directory name)
-v, --verbose Enable verbose (debug-level) logging
--fork This tree is a copy of another project: mint a new identity for it
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--force With --fork: also re-identify a tree that is the registered home of its id (archives that manifest)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--adopt <ULID> Register this tree as a working copy (ADR-108 workspace) of the existing project ULID, whose primary lives on another machine. Writes no key or chain and never serves a kernel here; hides `.weftos/` with the repository's `.git/info/exclude`
--repo <DIR> With --adopt: another repository directory of this project outside the root (for example a sibling `../docs`), reported with it. Repeatable; adds to the list already registered
-h, --help Print helpweft project list
List registered projects
Usage: weft project list [OPTIONS]
Options:
--json Machine-readable output
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft project seed
Import ~/.clawft/workspaces.json into the project index
Usage: weft project seed [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft project show
Show one project (default: the one containing the current directory)
Usage: weft project show [OPTIONS] [TARGET]
Arguments:
[TARGET] Project ULID, name, or `.` for the current directory
Options:
--here Show the project containing the current directory
-v, --verbose Enable verbose (debug-level) logging
--json Machine-readable output
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft routing
Context-router decision trace and replay (WEFT-336)
Usage: weft routing [OPTIONS] <COMMAND>
Commands:
trace Dump recent routing decisions from substrate (or a file dump)
replay Replay a recorded decision path (dry-run from log by default)
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft routing replay
Replay a recorded decision path (dry-run from log by default)
Usage: weft routing replay [OPTIONS] <DECISION_ID>
Arguments:
<DECISION_ID> Decision id (ULID / `rd-…`) under the routing log prefix
Options:
--json Emit machine-readable JSON instead of human text
-v, --verbose Enable verbose (debug-level) logging
--from-file <PATH> Read from a JSON array / JSONL dump instead of substrate
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--live Re-route through the current offline router ([`NullRouter`]) and compare against the logged selected route. Without this flag the command dry-runs the recorded path only
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft routing trace
Dump recent routing decisions from substrate (or a file dump)
Usage: weft routing trace [OPTIONS]
Options:
-C, --conversation <ID> Filter to a single conversation / chat id
-v, --verbose Enable verbose (debug-level) logging
-n, --limit <LIMIT> Maximum number of decisions to show (newest first). Default 20 [default: 20]
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--json Emit machine-readable JSON instead of human text
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--from-file <PATH> Read decisions from a JSON array or JSONL file instead of the daemon substrate (offline / test path)
-h, --help Print helpweft security
Security scanning, auditing, and hardening
Usage: weft security [OPTIONS] <COMMAND>
Commands:
scan Scan a file or directory for security issues
checks List all available audit checks
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft security checks
List all available audit checks
Usage: weft security checks [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft security scan
Scan a file or directory for security issues
Usage: weft security scan [OPTIONS] <PATH>
Arguments:
<PATH> File or directory to scan
Options:
--format <FORMAT> Output format: text, json [default: text]
-v, --verbose Enable verbose (debug-level) logging
--min-severity <MIN_SEVERITY> Minimum severity to report (info, low, medium, high, critical) [default: low]
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft sessions
Manage agent sessions
Usage: weft sessions [OPTIONS] <COMMAND>
Commands:
list List all sessions
inspect Inspect a specific session
delete Delete a specific session
gc Garbage-collect legacy underscore-encoded session files after migration
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft sessions delete
Delete a specific session
Usage: weft sessions delete [OPTIONS] <SESSION_ID>
Arguments:
<SESSION_ID> Session key to delete
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft sessions gc
Garbage-collect legacy underscore-encoded session files after migration
Usage: weft sessions gc [OPTIONS]
Options:
--dry-run Report what would be removed without deleting
-v, --verbose Enable verbose (debug-level) logging
-c, --config <CONFIG> Config file path (overrides auto-discovery)
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft sessions inspect
Inspect a specific session
Usage: weft sessions inspect [OPTIONS] <SESSION_ID>
Arguments:
<SESSION_ID> Session key to inspect
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft sessions list
List all sessions
Usage: weft sessions list [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills
Manage skills (list, show, install)
Usage: weft skills [OPTIONS] <COMMAND>
Commands:
list List all skills with source annotation
show Show details of a specific skill
install Install a skill from a local path
remove Remove a user-installed skill
pending List skills staged with a `.pending` marker (autogen, awaiting review)
approve Approve a `.pending` staged skill -- move it into the canonical user skills directory
reject Reject a `.pending` staged skill -- remove the staged directory
autogen Manage autonomous skill creation (pattern detection → pending skills)
refresh Manually reload the skill registry from disk (headless / CI)
search Search ClawHub for skills
publish Publish a skill to ClawHub
remote-install Install a skill from ClawHub by name
keygen Generate a signing key pair for skill publishing
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills approve
Approve a `.pending` staged skill -- move it into the canonical user skills directory
Usage: weft skills approve [OPTIONS] <NAME>
Arguments:
<NAME> Skill name (directory name) under `~/.clawft/skills/<name>/`
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills autogen
Manage autonomous skill creation (pattern detection → pending skills).
Examples: weft skills autogen enable weft skills autogen disable weft skills autogen status
Usage: weft skills autogen [OPTIONS] <COMMAND>
Commands:
enable Enable autonomous skill creation (`skills.autogen.enabled = true`)
disable Disable autonomous skill creation (`skills.autogen.enabled = false`)
status Show enabled state, threshold, and max_pending from user config
Options:
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft skills autogen disable
Disable autonomous skill creation (`skills.autogen.enabled = false`)
Usage: weft skills autogen disable [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills autogen enable
Enable autonomous skill creation (`skills.autogen.enabled = true`).
Pattern detection runs during agent turns and stages candidates under `~/.clawft/skills/` with a `.pending` marker for human approval.
Usage: weft skills autogen enable [OPTIONS]
Options:
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft skills autogen status
Show enabled state, threshold, and max_pending from user config
Usage: weft skills autogen status [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills install
Install a skill from a local path
Usage: weft skills install [OPTIONS] <PATH>
Arguments:
<PATH>
Path to a skill directory (containing SKILL.md or skill.json)
Options:
-v, --verbose
Enable verbose (debug-level) logging
--yes
Skip the interactive shell-access approval prompt (CI use).
If the skill manifest declares `shell: true` or any tool with `category: shell`, install will normally block on stdin asking for approval. `--yes` accepts implicitly. Default is rejected when stdin is non-interactive and `--yes` is not set.
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft skills keygen
Generate a signing key pair for skill publishing
Usage: weft skills keygen [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills list
List all skills with source annotation
Usage: weft skills list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills pending
List skills staged with a `.pending` marker (autogen, awaiting review)
Usage: weft skills pending [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills publish
Publish a skill to ClawHub
Usage: weft skills publish [OPTIONS] <PATH>
Arguments:
<PATH> Path to skill directory
Options:
--allow-unsigned Allow unsigned skills (local dev only)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills refresh
Manually reload the skill registry from disk (headless / CI).
Use when the notify file watcher is disabled (containers, CI, or deliberate opt-out). Re-discovers workspace and user skills and rebuilds the in-process registry.
On hosts where the skill watcher is already running, this is a no-op (the watcher hot-reloads on filesystem changes).
Examples: weft skills refresh
Usage: weft skills refresh [OPTIONS]
Options:
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft skills reject
Reject a `.pending` staged skill -- remove the staged directory
Usage: weft skills reject [OPTIONS] <NAME>
Arguments:
<NAME> Skill name (directory name) under `~/.clawft/skills/<name>/`
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills remote-install
Install a skill from ClawHub by name
Usage: weft skills remote-install [OPTIONS] <NAME>
Arguments:
<NAME> Skill name or ID on ClawHub
Options:
--allow-unsigned Allow unsigned skills
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills remove
Remove a user-installed skill
Usage: weft skills remove [OPTIONS] <NAME>
Arguments:
<NAME> Skill name to remove from ~/.clawft/skills/
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills search
Search ClawHub for skills
Usage: weft skills search [OPTIONS] <QUERY>
Arguments:
<QUERY> Search query
Options:
--limit <LIMIT> Maximum results [default: 10]
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft skills show
Show details of a specific skill
Usage: weft skills show [OPTIONS] <NAME>
Arguments:
<NAME> Skill name to inspect
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft status
Show configuration status
Usage: weft status [OPTIONS]
Options:
--detailed Show detailed configuration (channels, tools, providers)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft swarm
Multi-agent swarm demo (AgentBus + SwarmCoordinator)
Usage: weft swarm [OPTIONS] <COMMAND>
Commands:
demo Run the built-in coordinator → workers map/collect demo
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft swarm demo
Run the built-in coordinator → workers map/collect demo
Usage: weft swarm demo [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--workers <WORKERS> Number of echo workers to spawn (default 3) [default: 3]
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--workspace <WORKSPACE> Optional workspace root for AgentRuntime isolation (defaults to a temp dir under the system temp folder)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft token
Issue, revoke and list daemon bearer tokens (ADR-102)
Usage: weft token [OPTIONS] <COMMAND>
Commands:
issue Issue a token (shown once). Default lifetime 15 minutes, maximum 24 hours
revoke Revoke a token by id
list List live tokens (ids only; secrets are never stored)
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft token issue
Issue a token (shown once). Default lifetime 15 minutes, maximum 24 hours
Usage: weft token issue [OPTIONS]
Options:
--ttl <TTL> Lifetime, e.g. `90s`, `15m`, `2h` (a bare number is seconds) [default: 15m]
-v, --verbose Enable verbose (debug-level) logging
--label <LABEL> Label recorded with the token [default: playground]
--project <PROJECT> Scope the token to a project (ULID). The daemon treats it as the request's project and refuses a request that names another (`project_scope_mismatch`). It is a claim guard, not a capability limit: the token still carries owner scope, unless combined with `--read-only`, which makes it read-only AND confined to the project
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--read-only Mint a read-only token: it opens only the gateway's GET read routes (`/api/fleet/snapshot`, `/api/health`, ...) and every other route answers 403. Use it for a console. With `--project <ulid>` the token is also restricted to that project (the gateway lists only it, 403s every other project and filters the fleet snapshot to it)
--config <CONFIG> Config file override (used to find the gateway address)
-h, --help Print helpweft token list
List live tokens (ids only; secrets are never stored)
Usage: weft token list [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft token revoke
Revoke a token by id.
The daemon refuses the token at once. A running gateway caches a good validation for up to 30 seconds, so the token can still work there for that long (revoking through the gateway's own `/api/auth/revoke` takes effect immediately). Open WebSocket connections are not closed.
Usage: weft token revoke [OPTIONS] <ID>
Arguments:
<ID>
Token id (first 16 hex characters of its hash, from `weft token list`)
Options:
-v, --verbose
Enable verbose (debug-level) logging
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft tools
Manage tools (list, show, search, deny/allow)
Usage: weft tools [OPTIONS] <COMMAND>
Commands:
list List all registered tools with source annotation
show Show details and parameter schema for a specific tool
mcp List configured MCP servers and their tool counts
search Search tools by name or description
deny Add a glob pattern to the tool denylist
allow Remove a pattern from the tool denylist
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft tools allow
Remove a pattern from the tool denylist
Usage: weft tools allow [OPTIONS] <PATTERN>
Arguments:
<PATTERN> Exact pattern to remove from the denylist
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft tools deny
Add a glob pattern to the tool denylist
Usage: weft tools deny [OPTIONS] <PATTERN>
Arguments:
<PATTERN> Glob pattern (e.g. "exec_*", "claude-flow__browser_*")
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft tools list
List all registered tools with source annotation
Usage: weft tools list [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft tools mcp
List configured MCP servers and their tool counts
Usage: weft tools mcp [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft tools search
Search tools by name or description
Usage: weft tools search [OPTIONS] <QUERY>
Arguments:
<QUERY> Search query (case-insensitive substring match)
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft tools show
Show details and parameter schema for a specific tool
Usage: weft tools show [OPTIONS] <NAME>
Arguments:
<NAME> Tool name to inspect
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft ui
Start the web dashboard (gateway + API + browser)
Usage: weft ui [OPTIONS]
Options:
-c, --config <CONFIG> Config file path (overrides auto-discovery)
-v, --verbose Enable verbose (debug-level) logging
-p, --port <PORT> Port for the UI API (overrides config.gateway.api_port)
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--no-open Don't open the browser automatically
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
--ui-dir <UI_DIR> Directory containing the built UI (for static serving)
-h, --help Print helpweft update
Update weft and weaver binaries to latest release
Usage: weft update [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace
Manage workspaces
Usage: weft workspace [OPTIONS] <COMMAND>
Commands:
create Create a new workspace
list List all registered workspaces
load Load (activate) a workspace by name or path
status Show status of the current workspace
delete Delete a workspace (registry + on-disk markers by default)
config Manage workspace configuration
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace config
Manage workspace configuration
Usage: weft workspace config [OPTIONS] <COMMAND>
Commands:
set Set a configuration key
get Get the value of a configuration key
reset Reset workspace configuration to empty
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace config get
Get the value of a configuration key
Usage: weft workspace config get [OPTIONS] <KEY>
Arguments:
<KEY> Dot-separated config key
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace config reset
Reset workspace configuration to empty
Usage: weft workspace config reset [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace config set
Set a configuration key
Usage: weft workspace config set [OPTIONS] <KEY> <VALUE>
Arguments:
<KEY> Dot-separated config key (e.g. "agents.defaults.model")
<VALUE> Value to set
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace create
Create a new workspace
Usage: weft workspace create [OPTIONS] <NAME>
Arguments:
<NAME> Workspace name
Options:
--dir <DIR> Parent directory for the workspace (defaults to current directory)
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace delete
Delete a workspace (registry + on-disk markers by default)
Usage: weft workspace delete [OPTIONS] <NAME>
Arguments:
<NAME>
Workspace name to delete
Options:
-v, --verbose
Enable verbose (debug-level) logging
-y, --yes
Skip confirmation prompt
--keep-data
Keep workspace files on disk (registry-only delete).
Default behavior (FR-W06) removes `.clawft/` and `CLAWFT.md`.
--project <ULID>
Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR>
Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help
Print help (see a summary with '-h')weft workspace list
List all registered workspaces
Usage: weft workspace list [OPTIONS]
Options:
--all Show all entries including those with missing directories
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace load
Load (activate) a workspace by name or path
Usage: weft workspace load [OPTIONS] <NAME_OR_PATH>
Arguments:
<NAME_OR_PATH> Workspace name or filesystem path
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print helpweft workspace status
Show status of the current workspace
Usage: weft workspace status [OPTIONS]
Options:
-v, --verbose Enable verbose (debug-level) logging
--project <ULID> Use the kernel serving this project (ULID; see `weft project list`)
--runtime <DIR> Use the kernel whose runtime directory is DIR (overrides WEFTOS_RUNTIME_DIR)
-h, --help Print help