box/lookup_internal/cli_tools.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "CLI Tools Reference & Grammar",
  "version": "1.0.0",
  "binaries": {
    "super": {
      "path": "/home/super/.local/bin/super",
      "target": "/home/super/Projects/NetVM/bin/super-cli.py",
      "description": "Unified off-board orchestrator CLI for NetVM & Box."
    },
    "box": {
      "path": "/home/super/.local/bin/box",
      "target": "/home/super/Projects/NetVM/bin/super-cli.py",
      "description": "Agent-facing unified CLI (symlink to super-cli.py)."
    },
    "muse": {
      "path": "/home/super/.local/bin/muse",
      "target": "/home/super/Projects/NetVM/bin/muse",
      "description": "Direct headless gateway wrapper with isolated per-node WARP netns."
    }
  },
  "domains": {
    "fleet": {
      "summary": "Node health, CDP status, active tabs, watch, restart",
      "subcommands": [
        {"cmd": "box fleet status", "desc": "Tabular health status of all 4 browser nodes (CDP latency, tabs, proc)"},
        {"cmd": "box fleet watch", "desc": "Live refresh terminal dashboard of fleet nodes"},
        {"cmd": "box fleet restart <node>", "desc": "Safely bounce a specific browser netns node"},
        {"cmd": "box fleet cdp <node>", "desc": "Inspect open DevTools targets and webSocket URLs"}
      ]
    },
    "approvals": {
      "summary": "Inspect and handle agent browser & gateway approvals",
      "subcommands": [
        {"cmd": "box approvals check [-v]", "desc": "Check if any browser agent is waiting on approval dialogs"},
        {"cmd": "box approvals inspect <node>", "desc": "Inspect pending approval modal prompt and details"},
        {"cmd": "box approvals allow <node>", "desc": "Approve pending request on target node"},
        {"cmd": "box approvals deny <node>", "desc": "Reject pending request on target node"}
      ]
    },
    "dm": {
      "summary": "Inter-agent DMs, work orders ([WO]), acks, live log tail",
      "subcommands": [
        {"cmd": "box dm send --agent <self> --to <peer> --target <sidechat> \"<msg>\"", "desc": "Send signed DM"},
        {"cmd": "box dm wo --agent <self> --to <peer> --target <chat> --title \"<title>\" \"<body>\"", "desc": "Dispatch structured [WO:id]"},
        {"cmd": "box dm ack <id> --agent <self>", "desc": "Acknowledge received work order"},
        {"cmd": "box dm log [--limit N]", "desc": "Read stream of signed work orders and DMs"},
        {"cmd": "box dm tail", "desc": "Live stream incoming DMs"}
      ]
    },
    "thread": {
      "summary": "Inspect agent main chats, sidechats, and scrollbacks",
      "subcommands": [
        {"cmd": "box thread list [agent]", "desc": "List active sidechats and message threads"},
        {"cmd": "box thread view <agent> <thread_id> [--limit N]", "desc": "Read messages in a specific thread"}
      ]
    },
    "job": {
      "summary": "Manage scheduled jobs, systemd timers, triggers, logs",
      "subcommands": [
        {"cmd": "box job list", "desc": "List registered jobs and systemd user timers"},
        {"cmd": "box job run <name>", "desc": "Hot-trigger immediate execution of a job"},
        {"cmd": "box job status <name>", "desc": "Inspect job execution status and logs"}
      ]
    },
    "web": {
      "summary": "Probe VM web surfaces (box.muse-dev.online), auth, sync",
      "subcommands": [
        {"cmd": "box web health", "desc": "Check Google Cloud VM web surface HTTP status"},
        {"cmd": "box web test-auth", "desc": "Verify operator auth gating and session token"}
      ]
    },
    "loop": {
      "summary": "Intrinsic loop strategy, health, break taxonomy, and variables",
      "subcommands": [
        {"cmd": "box loop status", "desc": "List active open loops, deadlines, and nudge counts"},
        {"cmd": "box loop health", "desc": "Show fleet loop health ratio and closure rate"},
        {"cmd": "box loop nudge <id>", "desc": "Manually trigger a followup nudge on an open loop"},
        {"cmd": "box loop close <id>", "desc": "Close a loop with verdict"}
      ]
    },
    "vars": {
      "summary": "Inspect and adjust runtime control variables",
      "subcommands": [
        {"cmd": "box vars list", "desc": "List all dynamic runtime control variables"},
        {"cmd": "box vars get <name>", "desc": "Get current value of a variable"},
        {"cmd": "box vars set <name> <value>", "desc": "Update runtime variable value"},
        {"cmd": "box vars reset <name>", "desc": "Reset variable to canonical default"}
      ]
    },
    "tmux": {
      "summary": "Manage headless background tmux sessions on /tmp/tmux-muse.sock",
      "subcommands": [
        {"cmd": "box tmux list", "desc": "List active background agent sessions"},
        {"cmd": "box tmux new <session> --command \"<cmd>\"", "desc": "Spawn new logged session"},
        {"cmd": "box tmux send <session> \"<keys>\"", "desc": "Send keystrokes to session"},
        {"cmd": "box tmux capture <session> [--lines N]", "desc": "Capture session output"}
      ]
    },
    "deploy": {
      "summary": "Spawn sub-agent session and dispatch task",
      "subcommands": [
        {"cmd": "box deploy subagent --agent <self> --title \"<title>\" \"<prompt>\"", "desc": "Spawn autonomous subagent"}
      ]
    },
    "docs": {
      "summary": "Internal documentation, surfaces, sentence grammar, and regex lookup",
      "subcommands": [
        {"cmd": "box docs search <query>", "desc": "Search internal docs database"},
        {"cmd": "box docs surfaces [name]", "desc": "Lookup assistive surfaces for box.muse-dev.online"},
        {"cmd": "box docs sentence [name]", "desc": "Lookup agent sentence structures and protocols"},
        {"cmd": "box docs regex [name] [--test \"str\"]", "desc": "Lookup or test regex patterns"},
        {"cmd": "box docs parse \"<utterance>\"", "desc": "Parse agent utterance through regex engine"}
      ]
    }
  }
}