clawft

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

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 version

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help
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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help
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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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')
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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help
weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help
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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help
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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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 help
weft 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 help
weft 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 help
weft 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 help

weft 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 help

weft 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 help

weft 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 help

weft 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

On this page

Commandsweftweft agentweft agentsweft agents listweft agents showweft agents useweft analyzeweft analyze detectweft analyze diffweft analyze enrichweft analyze extractweft analyze inferweft analyze linksweft analyze sliceweft analyze suggestweft analyze vowlweft assessweft assess compareweft assess hooksweft assess initweft assess linkweft assess mesh-statusweft assess peersweft assess reviewweft assess runweft assess statusweft channelsweft channels statusweft completionsweft configweft config sectionweft config showweft cosweft cos serveweft cronweft cron addweft cron disableweft cron enableweft cron listweft cron removeweft cron runweft delegateweft delegate debugweft doctorweft gatewayweft mcpweft mcp addweft mcp listweft mcp removeweft mcp-serverweft memoryweft memory exportweft memory historyweft memory importweft memory reindexweft memory searchweft memory showweft onboardweft pluginsweft plugins createweft plugins inspectweft plugins templatesweft plugins validateweft projectweft project initweft project listweft project seedweft project showweft routingweft routing replayweft routing traceweft securityweft security checksweft security scanweft sessionsweft sessions deleteweft sessions gcweft sessions inspectweft sessions listweft skillsweft skills approveweft skills autogenweft skills autogen disableweft skills autogen enableweft skills autogen statusweft skills installweft skills keygenweft skills listweft skills pendingweft skills publishweft skills refreshweft skills rejectweft skills remote-installweft skills removeweft skills searchweft skills showweft statusweft swarmweft swarm demoweft tokenweft token issueweft token listweft token revokeweft toolsweft tools allowweft tools denyweft tools listweft tools mcpweft tools searchweft tools showweft uiweft updateweft workspaceweft workspace configweft workspace config getweft workspace config resetweft workspace config setweft workspace createweft workspace deleteweft workspace listweft workspace loadweft workspace status