refactor(tui): rebrand Gator to Term/NemoClaw (#134)

Closes #130

Rename the TUI from "Gator" to use generic naming:
- CLI subcommand: `nemoclaw gator` → `nemoclaw term`
- TUI title bar: "Gator" → "NemoClaw"
- Docs/skills: "Gator" → "the TUI" or "NemoClaw TUI"
- File renames: gator.toml → term.toml, gator.md → tui.md
- Remove dead link to nonexistent plans/gator-tui.md

Co-authored-by: John Myers <johntmyers@users.noreply.github.com>

Author: johntmyers

.agents/skills/nemoclaw-cli/SKILL.md

@@ -564,4 +564,4 @@ $ nemoclaw sandbox sync --help
 |-------|------------|
 | `generate-sandbox-policy` | Creating or modifying policy YAML content (network rules, L7 inspection, access presets, endpoint configuration) |
 | `debug-navigator-cluster` | Diagnosing cluster startup or health failures |
-| `tui-development` | Developing features for the Gator TUI (`nemoclaw gator`) |
+| `tui-development` | Developing features for the NemoClaw TUI (`nemoclaw term`) |

.agents/skills/nemoclaw-cli/cli-reference.md

@@ -64,7 +64,7 @@ nemoclaw
 │   ├── update <name> [opts]
 │   ├── delete <name>...
 │   └── list [opts]
-├── gator
+├── term
 ├── completions <shell>
 └── ssh-proxy [opts]
 ```
@@ -339,9 +339,9 @@ List inference routes.
 
 ## Other Commands
 
-### `nemoclaw gator`
+### `nemoclaw term`
 
-Launch the Gator interactive TUI.
+Launch the NemoClaw interactive TUI.
 
 ### `nemoclaw completions <shell>`
 

.agents/skills/tui-development/SKILL.md

@@ -1,17 +1,17 @@
 ---
 name: tui-development
-description: Guide for developing the "Gator" TUI — a ratatui-based terminal UI for the NemoClaw platform. Covers architecture, navigation, data fetching, theming, UX conventions, and development workflow. Trigger keywords - gator, TUI, terminal UI, ratatui, navigator-tui, tui development, gator feature, gator bug.
+description: Guide for developing the NemoClaw TUI — a ratatui-based terminal UI for the NemoClaw platform. Covers architecture, navigation, data fetching, theming, UX conventions, and development workflow. Trigger keywords - term, TUI, terminal UI, ratatui, navigator-tui, tui development, tui feature, tui bug.
 ---
 
-# Gator TUI Development Guide
+# NemoClaw TUI Development Guide
 
-Comprehensive reference for any agent working on the Gator TUI.
+Comprehensive reference for any agent working on the NemoClaw TUI.
 
 ## 1. Overview
 
-Gator is a ratatui-based terminal UI for the NemoClaw platform. It provides a keyboard-driven interface for managing clusters, sandboxes, and logs — the same operations available via the `nemoclaw` CLI, but with a live, interactive dashboard.
+The NemoClaw TUI is a ratatui-based terminal UI for the NemoClaw platform. It provides a keyboard-driven interface for managing clusters, sandboxes, and logs — the same operations available via the `nemoclaw` CLI, but with a live, interactive dashboard.
 
-- **Launched via:** `nemoclaw gator` or `mise run gator`
+- **Launched via:** `nemoclaw term` or `mise run term`
 - **Crate:** `crates/navigator-tui/`
 - **Key dependencies:**
   - `ratatui` (workspace version) — uses `frame.size()` (not `frame.area()`)
@@ -39,7 +39,7 @@ Cluster (discovered via navigator_bootstrap::list_clusters())
 The **title bar** always reflects this hierarchy, reading left-to-right from general to specific:
 
 ```
- Gator │ Current Cluster: <name> (<status>) │ <screen/context>
+ NemoClaw │ Current Cluster: <name> (<status>) │ <screen/context>
 ```
 
 ## 3. Navigation & Screen Architecture
@@ -104,8 +104,8 @@ Every frame renders four vertical regions:
 
 ### Title bar examples
 
-- Dashboard: ` Gator │ Current Cluster: nemoclaw (Healthy) │ Dashboard`
-- Sandbox detail: ` Gator │ Current Cluster: nemoclaw (Healthy) │ Sandbox: my-sandbox`
+- Dashboard: ` NemoClaw │ Current Cluster: nemoclaw (Healthy) │ Dashboard`
+- Sandbox detail: ` NemoClaw │ Current Cluster: nemoclaw (Healthy) │ Sandbox: my-sandbox`
 
 ### Adding a new screen
 
@@ -193,7 +193,7 @@ All colors and styles are defined in `crates/navigator-tui/src/theme.rs`.
 | `MUTED` | White + DIM modifier | Secondary info, separators (`│`), unfocused items |
 | `HEADING` | White + BOLD | Panel titles, sandbox/cluster names when active |
 | `ACCENT` | NVIDIA_GREEN foreground | Selected row marker (`▌`), sandbox source labels |
-| `ACCENT_BOLD` | NVIDIA_GREEN + BOLD | "Gator" brand text, command prompt `:` |
+| `ACCENT_BOLD` | NVIDIA_GREEN + BOLD | "NemoClaw" brand text, command prompt `:` |
 | `SELECTED` | BOLD modifier only | Selected row text emphasis |
 | `BORDER` | EVERGLADE foreground | Unfocused panel borders |
 | `BORDER_FOCUSED` | NVIDIA_GREEN foreground | Focused panel borders |
@@ -225,9 +225,9 @@ The `confirm_delete` flag in `App` gates destructive key handling — while true
 
 ### CLI parity
 
-Gator actions should parallel `nemoclaw` CLI commands so users have familiar mental models:
+TUI actions should parallel `nemoclaw` CLI commands so users have familiar mental models:
 
-| CLI Command | Gator Equivalent |
+| CLI Command | TUI Equivalent |
 | --- | --- |
 | `nemoclaw sandbox list` | Sandbox table on Dashboard |
 | `nemoclaw sandbox delete <name>` | `[d]` on sandbox detail, then `[y]` to confirm |
@@ -405,11 +405,11 @@ The connect timeout for cluster switching is 10 seconds with HTTP/2 keepalive at
 # Build the crate
 cargo build -p navigator-tui
 
-# Run gator against the active cluster
-mise run gator
+# Run the TUI against the active cluster
+mise run term
 
 # Run with cargo-watch for hot-reload during development
-mise run gator:dev
+mise run term:dev
 
 # Format
 cargo fmt -p navigator-tui

architecture/sandbox-connect.md

@@ -170,20 +170,20 @@ on the host are forwarded to `127.0.0.1:<port>` inside the sandbox.
   when no trailing command is provided.
 - `nemoclaw sandbox delete` auto-stops any active forwards for the deleted sandbox.
 
-#### TUI (Gator)
+#### TUI
 
 The TUI (`crates/navigator-tui/`) supports port forwarding through the create sandbox modal. Users
 specify comma-separated ports in the **Ports** field. After sandbox creation:
 
-1. Gator polls for `Ready` state (up to 30 attempts at 2-second intervals).
+1. The TUI polls for `Ready` state (up to 30 attempts at 2-second intervals).
 2. Creates an SSH session via `CreateSshSession` gRPC.
 3. Spawns background SSH tunnels (`ssh -N -f -L <port>:127.0.0.1:<port>`) for each port.
 4. Sends a `ForwardResult` event back to the main loop with the outcome.
 
 Active forwards are displayed in the sandbox table's NOTES column (e.g., `fwd:8080,3000`) and in
 the sandbox detail view's Forwards row.
 
-When deleting a sandbox, Gator calls `stop_forwards_for_sandbox()` before sending the delete
+When deleting a sandbox, the TUI calls `stop_forwards_for_sandbox()` before sending the delete
 request. PID tracking uses the same `~/.config/nemoclaw/forwards/` directory as the CLI.
 
 #### Shared forward module

architecture/system-architecture.md

@@ -7,7 +7,7 @@ graph TB
     %% ============================================================
     subgraph UserMachine["User's Machine"]
         CLI["NemoClaw CLI<br/>(nemoclaw)"]
-        TUI["Gator TUI<br/>(nemoclaw gator)"]
+        TUI["NemoClaw TUI<br/>(nemoclaw term)"]
         SDK["Python SDK<br/>(nemoclaw)"]
         LocalConfig["~/.config/nemoclaw/<br/>clusters, mTLS certs,<br/>active_cluster"]
     end
@@ -177,7 +177,7 @@ graph TB
 
 | Color | Category | Examples |
 |-------|----------|---------|
-| Blue | User-side components | NemoClaw CLI, Gator TUI, Python SDK |
+| Blue | User-side components | NemoClaw CLI, NemoClaw TUI, Python SDK |
 | Orange | Gateway / Control plane | navigator-server, watch bus, log bus |
 | Green | Sandbox supervisor | SSH server, HTTP CONNECT proxy, OPA engine, inference router |
 | Purple | Agent process & isolation | AI agent, Landlock, Seccomp, network namespace |

architecture/gator.md architecture/tui.mdarchitecture/gator.md renamed to architecture/tui.md

@@ -1,16 +1,16 @@
-# Gator: NemoClaw TUI
+# NemoClaw TUI
 
-Gator is a terminal user interface for NemoClaw, inspired by [k9s](https://k9scli.io/). Instead of typing individual CLI commands to check cluster health, list sandboxes, and manage resources, Gator gives you a real-time, keyboard-driven dashboard — everything updates automatically and you navigate with a few keystrokes.
+The NemoClaw TUI is a terminal user interface for NemoClaw, inspired by [k9s](https://k9scli.io/). Instead of typing individual CLI commands to check cluster health, list sandboxes, and manage resources, the TUI gives you a real-time, keyboard-driven dashboard — everything updates automatically and you navigate with a few keystrokes.
 
-## Launching Gator
+## Launching the TUI
 
-Gator is a subcommand of the NemoClaw CLI, so it inherits all your existing configuration — cluster selection, TLS settings, and verbosity flags all work the same way.
+The TUI is a subcommand of the NemoClaw CLI, so it inherits all your existing configuration — cluster selection, TLS settings, and verbosity flags all work the same way.
 
 ```bash
-nemoclaw gator                   # launch against the active cluster
-nav gator                         # dev alias (builds from source)
-nav gator --cluster prod          # target a specific cluster
-NEMOCLAW_CLUSTER=prod nav gator  # same thing, via environment variable
+nemoclaw term                   # launch against the active cluster
+nav term                         # dev alias (builds from source)
+nav term --cluster prod          # target a specific cluster
+NEMOCLAW_CLUSTER=prod nav term  # same thing, via environment variable
 ```
 
 Cluster resolution follows the same priority as the rest of the CLI:
@@ -23,11 +23,11 @@ No separate configuration files or authentication are needed.
 
 ## Screen Layout
 
-Gator divides the terminal into four horizontal regions:
+The TUI divides the terminal into four horizontal regions:
 
 ```
 ┌─────────────────────────────────────────────────────────────────┐
-│  gator ─ my-cluster ─ Dashboard  ● Healthy                     │  ← title bar
+│  NemoClaw ─ my-cluster ─ Dashboard  ● Healthy                   │  ← title bar
 ├─────────────────────────────────────────────────────────────────┤
 │                                                                 │
 │  (view content — Dashboard or Sandboxes)                        │  ← main area
@@ -39,7 +39,7 @@ Gator divides the terminal into four horizontal regions:
 └─────────────────────────────────────────────────────────────────┘
 ```
 
-- **Title bar** — shows the Gator logo, cluster name, current view, and live cluster health status.
+- **Title bar** — shows the NemoClaw logo, cluster name, current view, and live cluster health status.
 - **Main area** — the active view (Dashboard or Sandboxes).
 - **Navigation bar** — lists available views with their shortcut keys, plus Help and Quit.
 - **Command bar** — appears when you press `:` to type a command (like vim).
@@ -84,7 +84,7 @@ When there are no sandboxes, the view displays: *"No sandboxes found."*
 
 ## Keyboard Controls
 
-Gator has two input modes: **Normal** (default) and **Command** (activated by pressing `:`).
+The TUI has two input modes: **Normal** (default) and **Command** (activated by pressing `:`).
 
 ### Normal Mode
 
@@ -95,7 +95,7 @@ Gator has two input modes: **Normal** (default) and **Command** (activated by pr
 | `j` or `↓` | Move selection down |
 | `k` or `↑` | Move selection up |
 | `:` | Enter command mode |
-| `q` | Quit Gator |
+| `q` | Quit |
 | `Ctrl+C` | Force quit |
 
 ### Command Mode
@@ -104,19 +104,19 @@ Press `:` to open the command bar at the bottom of the screen. Type a command an
 
 | Command | Action |
 |---------|--------|
-| `quit` or `q` | Quit Gator |
+| `quit` or `q` | Quit |
 | `dashboard` or `1` | Switch to Dashboard view |
 | `sandboxes` or `2` | Switch to Sandboxes view |
 
 Press `Esc` to cancel and return to Normal mode. `Backspace` deletes characters as you type.
 
 ## Data Refresh
 
-Gator automatically polls the cluster every **2 seconds**. Both cluster health and the sandbox list update on each tick, so the display stays current without manual refreshing. This uses the same gRPC calls as the CLI — no additional server-side setup is required.
+The TUI automatically polls the cluster every **2 seconds**. Both cluster health and the sandbox list update on each tick, so the display stays current without manual refreshing. This uses the same gRPC calls as the CLI — no additional server-side setup is required.
 
 ## Theme
 
-Gator uses a dark terminal theme based on the NVIDIA brand palette:
+The TUI uses a dark terminal theme based on the NVIDIA brand palette:
 
 - **Background**: Black — the standard terminal background.
 - **Text**: White for primary content, dimmed white for labels and secondary information.
@@ -128,30 +128,28 @@ The title bar uses white text on an Everglade background to visually anchor the
 
 ## Port Forwarding
 
-Gator supports creating sandboxes with port forwarding directly from the create modal. When creating a sandbox, you can specify ports to forward in the **Ports** field (comma-separated, e.g., `8080,3000`). After the sandbox reaches `Ready` state, Gator automatically spawns background SSH tunnels (`ssh -N -f -L <port>:127.0.0.1:<port>`) for each specified port.
+The TUI supports creating sandboxes with port forwarding directly from the create modal. When creating a sandbox, you can specify ports to forward in the **Ports** field (comma-separated, e.g., `8080,3000`). After the sandbox reaches `Ready` state, the TUI automatically spawns background SSH tunnels (`ssh -N -f -L <port>:127.0.0.1:<port>`) for each specified port.
 
 Forwarded ports are displayed in the **NOTES** column of the sandbox table as `fwd:8080,3000` and in the **Forwards** row of the sandbox detail view.
 
 Port forwarding lifecycle:
-- **On create**: Gator polls for sandbox readiness (up to 30 attempts at 2-second intervals), then spawns SSH tunnels.
+- **On create**: The TUI polls for sandbox readiness (up to 30 attempts at 2-second intervals), then spawns SSH tunnels.
 - **On delete**: Any active forwards for the sandbox are automatically stopped before deletion.
 - **PID tracking**: Forward PIDs are stored in `~/.config/nemoclaw/forwards/<name>-<port>.pid`, shared with the CLI.
 
 The forwarding implementation lives in `navigator-core::forward`, shared between the CLI and TUI.
 
 ## What is Not Yet Available
 
-Gator is in its initial phase. The following features are planned but not yet implemented:
+The TUI is in its initial phase. The following features are planned but not yet implemented:
 
 - **Inference and provider views** — browsing inference routes and provider configurations.
 - **Help overlay** — the `?` key is shown in the nav bar but does not open a help screen yet.
 - **Command bar autocomplete** — the command bar accepts text but does not offer suggestions.
 - **Filtering and search** — no `/` search within views yet.
 
-See the [Gator design plan](plans/gator-tui.md) for the full roadmap, including mockups and future phases.
-
 ## Crate Structure
 
-The TUI lives in `crates/navigator-tui/`, a separate workspace crate. The CLI crate (`crates/navigator-cli/`) depends on it and launches it via the `Gator` command variant in the `Commands` enum. This keeps TUI-specific dependencies (ratatui, crossterm) out of the CLI when not in use.
+The TUI lives in `crates/navigator-tui/`, a separate workspace crate. The CLI crate (`crates/navigator-cli/`) depends on it and launches it via the `Term` command variant in the `Commands` enum. This keeps TUI-specific dependencies (ratatui, crossterm) out of the CLI when not in use.
 
 The `navigator-tui` crate depends on `navigator-core` for protobuf types, the gRPC client, and shared utilities (e.g., `navigator_core::forward` for port forwarding PID management) — it communicates with the gateway over the same gRPC channel the CLI uses.

crates/navigator-cli/src/main.rs

@@ -142,8 +142,8 @@ enum Commands {
         command: ProviderCommands,
     },
 
-    /// Launch the Gator interactive TUI.
-    Gator,
+    /// Launch the NemoClaw interactive TUI.
+    Term,
 
     /// Generate shell completions.
     #[command(after_long_help = COMPLETIONS_HELP)]
@@ -1285,7 +1285,7 @@ async fn main() -> Result<()> {
                 }
             }
         }
-        Some(Commands::Gator) => {
+        Some(Commands::Term) => {
             let ctx = resolve_cluster(&cli.cluster)?;
             let tls = tls.with_cluster_name(&ctx.name);
             let channel = navigator_cli::tls::build_channel(&ctx.endpoint, &tls).await?;

crates/navigator-tui/Cargo.toml

@@ -3,7 +3,7 @@
 
 [package]
 name = "navigator-tui"
-description = "Gator – NemoClaw interactive TUI"
+description = "NemoClaw interactive TUI"
 version.workspace = true
 edition.workspace = true
 rust-version.workspace = true

crates/navigator-tui/src/lib.rs

@@ -25,7 +25,7 @@ use tonic::transport::{Certificate, Channel, ClientTlsConfig, Endpoint, Identity
 use app::{App, ClusterEntry, Focus, LogLine, Screen};
 use event::{Event, EventHandler};
 
-/// Launch the Gator TUI.
+/// Launch the NemoClaw TUI.
 ///
 /// `channel` must be a connected gRPC channel to the NemoClaw gateway.
 pub async fn run(channel: Channel, cluster_name: &str, endpoint: &str) -> Result<()> {

crates/navigator-tui/src/ui/mod.rs

@@ -98,7 +98,7 @@ fn draw_title_bar(frame: &mut Frame<'_>, app: &App, area: Rect) {
     };
 
     let mut parts: Vec<Span<'_>> = vec![
-        Span::styled(" Gator", styles::ACCENT_BOLD),
+        Span::styled(" NemoClaw", styles::ACCENT_BOLD),
         Span::styled(" | ", styles::MUTED),
         Span::styled("Current Cluster: ", styles::TEXT),
         Span::styled(&app.cluster_name, styles::HEADING),