🧭 NeXuS Compass — NeXuS-Command-Center (NCC) design session¶
Stamped 2026-07-20 (session 2, PM) · Anon shutting down — pick up here
A long fireside DESIGN session (no code built — Anon safeworded "bababooie" early to stop building and just talk). We designed the NeXuS-Command-Center end to end from Anon's cues + ~30 live screenshots. Everything is captured in the Lab founding doc; this compass is the fast index. Nothing was stamped/built — repo still not created.
🎯 The vision in one line¶
The NCC is the Janus portal into NeXuS — you cross a threshold to enter, and inside you stand in a HUD (NeXuSCockPit) that morphs to your mission, with KITT at your side and a seat at the Round Table — all composed on the Dank frame.
Full doc (v0.3, Forge-stamped, versioned): ~/Projects/nexus-lab/artifacts/nexus-command-center_founding-vision.md — in the Lab Fossil repo ~/museum/nexus-lab.fossil (commits v0.1 ee24e3b9c6 · v0.2 1e7786b78c · v0.3 966e175f6e). READ THIS FIRST next session.
🏛️ Architecture (settled this session)¶
- Names: NCC = portal/umbrella · NeXuSCockPit = the HUD (ours) · Dank (DankMaterialShell, QML/Quickshell/labwc) = the frame (upstream, ~80% of HUD already built).
- Governing principle: integrated yet modular — "modular at the parts, integrated at the seams." Uniformity is in the seams, not the source (→ never pick one language).
- Three planes: Control (message bus + dock + keymap) · Data (Vault) · AI (nexus-ai-router :8810). Plus the persistent Dank layer where the dock lives (on ALL desktops) = home of ring/reactor/omnibar/KITT.
- Membership card (how any app joins, do these 4 & nothing more): dock/keymap · message bus · vault · AI Router. Rounding up pieces = issuing membership cards.
- Navigation = CONDUCT not absorb: already have 9 desktops (labwc) + tmux (windows/panes) + Alt-Tab + app tabs. NCC conducts them via one grammar; replaces nothing. Studio is just a browser window → no web-in-QML embedding; HUD floats over the window (seam at compositor+bus). Lighter on Gen6.
- Language: polyglot by layer (QML·JSX·TS·Go·Python·sh). WASM = the equalizer for polyglot logic, proven live: ProTech TERMINAL = CheerpX Debian/WASM (bash+python3+ffmpeg in a tab), ffmpeg.wasm, lazy-loaded engines. WASM = logic capsule + sovereign sandbox (Ghost Gate for code); NOT the shell, NOT the unifier.
- Theming: dynamic wallpaper→Dank palette (default, "held together" at pixel level) + named static skins (TRON, MATRIX, etc.). Same skin pattern across every HUD seen.
📦 Ecosystem inventory (each a modular loadout)¶
| Loadout | Path | Lang | Notes |
|---|---|---|---|
| Studio (produce) | ~/Projects/nexus-protech-studio (git) |
React/JSX | 8 tabs; the tabbed multiplexer; standalone today |
| AI-Foundry + Vault (process) | ~/claude/advanced-ai-studio-framework |
React/TS | vault = cryptoService.ts+FileLibrary+FileAccessModal(permit-gate) |
| Character (create/read) | ~/Projects/adv-go-char-gen (+nexus-charcard v0.1.0) |
Go sixel TUI | own AES-256-GCM vault; Router-ready via CUSTOM_API_URL; bare foot (no tmux) |
| older char API | ~/claude/char-gen-cli |
Go | has api_server.go |
| AI Router (AI plane) | ~/Projects/nexus-ai-router |
Python :8810 | Ollama-first, SOCKS5 cloud, content-free logs, provenance; chat-only, needs multimodal |
| Security/Defense HUD | ~/Projects/ai-hud/log-analyzer-01 |
React/Gemini | log+PCAP ingest, port status, DEFCON, AI console → where darknet + Ghost Gate surface |
| others | NeXuS-png2-editor · hydra(=NOT-this donor) · nexus-medusa.sh |
Py/Py/sh |
🔐 Vault model (Anon's correction — important)¶
Per-module private vaults (not everything is meant to be shared — least-sharing = sovereignty) + a shared Vault-as-a-service (common opt-in space). Share feature: OnionShare + magic-wormhole external; secure internal method TBD. adv-go-char-gen crypto = the reference impl; the "one vault" idea is the shared space, NOT a replacement for per-module ones.
▶️ NEXT / PICK UP HERE¶
- Anon wants to LAUNCH the apps to get a real feel before building. (Studio:
cd ~/Projects/nexus-protech-studio && npm run dev; char-gen: build the Go binary, run in bare foot; router:python main.py; log-analyzer: npm.) - Weave in the darknet + Ghost Gate stacks — surface via the log-analyzer loadout; enforce at Router (SOCKS5) + Vault (FileAccessModal permits).
- When ready to build: stamp the repo — Fossil
~/museum/nexus-command-center.fossil, NeXuSCockPit overlay on Dank; studio stays git →fossil git importor convert. HUD-first. - Decide the shared-Vault-as-a-service contract (Go + TS clients,
nexus-charcardpayload) + the message-bus wire format.
📌 OPEN QUESTIONS¶
- Shared vault service contract · internal secure-share method · Router multimodal routes + proxy-down guard · message-bus protocol · repo scope (overlay vs fork) · threshold layering (TOTP+PERMITTL+master→child) · old
command-center/=donor confirm.
🧹 STATE¶
- NO code built, NO repo stamped, NOTHING touched in the app repos — pure design + read-only recon. Only writes: the Lab founding doc (v0.1→v0.3) + this compass + memory + a report.
- Lab (
~/museum/nexus-lab.fossil) works end-to-end (dogfooded — vision doc committed + FTS-searchable). - Session export:
~/claude/2026-07-20-protech-studio-char-gen-HUD-setup.txt.