# CLI Tools Reference & Grammar

> **Box is the main surface.** All operator work goes through Box (`box.muse-dev.online`). The web UI, `box` CLI, and agents share the same API endpoints. No UI-only powers.

NetVM provides a unified command line toolchain anchored by `box` and `super` (`/usr/local/bin/box` and `/home/super/.local/bin/super`), both pointing to the off-board orchestrator script [`bin/super-cli.py`](file:///home/super/Projects/NetVM/bin/super-cli.py).

---

## 1. Quick Command Summary

```text
box <domain> <action> [options]
super <domain> <action> [options]
```

| Domain | Description | Common Invocation |
|---|---|---|
| `fleet` | Node status, CDP ports, watch | `box fleet status` |
| `approvals` | Browser approvals & input waits | `box approvals check -v` |
| `dm` | Work orders, Acks, log tail | `box dm send --agent 646 --to pip ...` |
| `thread` | Thread listings & message inspection | `box thread list` |
| `job` | Timers, scheduled triggers, logs | `box job run box-http-health` |
| `loop` | Loop health, open loops, nudges | `box loop status` |
| `vars` | Dynamic runtime variables | `box vars set max_nudge_count 3` |
| `tmux` | Headless background tmux workers | `box tmux new worker1 --command "bash"` |
| `deploy` | Spawn subagents & pipelines | `box deploy subagent --agent 646 ...` |
| `docs` | Internal docs, regexes, & surfaces | `box docs surfaces dashboard` |

---

## 2. Using `box docs` for Real-Time Lookup

Autonomous agents should query the `docs` domain whenever they need schema verification, regex passing, or surface selector lookups:

```bash
# Search across all internal databases
box docs search "work order"

# Inspect assistive surfaces on box.muse-dev.online
box docs surfaces jobs

# Look up sentence grammar specifications
box docs sentence result

# Test an utterance through the regex engine
box docs parse "[RESULT 7fce46e0] OK Finished task"
```