How xdankit/nexus-console works
Nexus Console is a local macOS/Tauri app for managing Homebrew and developer-machine workflows. The principal path is service discovery, reconciliation with the user's managed list and intent, then service controls that invoke native Homebrew operations; live status also feeds sessions and the menu-bar count. Other documented modules cover packages, ports, health checks, Claude chat archiving, and an interactive terminal. Edges use README claims and shown registration/call sites; unsampled module internals are represented at their source paths without assuming detailed wiring.
Main entry points: services.rs Brew commands · ServicesPage.tsx Services interface · useServices.ts Service discovery · useServiceControls.ts Service controls
Components 23
App and navigation
- App shell
src/app/App.tsx - Module selection
src/shared/modules/useEnabledModules.ts - App state
src/shared/state/serviceIntentSlice.ts - Settings
src/features/settings/pages/SettingsPage/SettingsPage.tsx
Homebrew management
- Services interface
src/features/services/pages/ServicesPage/ServicesPage.tsx - Service discovery
src/shared/brew/useServices.ts - Service reconciliation
src/shared/brew/reconcile.ts - Service controls
src/features/services/useServiceControls.ts - Package manager
src/features/packages/pages/PackagesPage/PackagesPage.tsx - Service sessions
src/features/sessions/pages/SessionsPage/SessionsPage.tsx
Developer tools
- Port monitor
src/features/ports/pages/PortsPage/PortsPage.tsx - Health checks
src/features/doctor/pages/DoctorPage/DoctorPage.tsx - Claude chat archive
src/features/archiver/pages/ArchiverPage/ArchiverPage.tsx - Integrated terminal
src/features/terminal/components/TerminalDrawer/TerminalDrawer.tsx
Tauri native core
- Brew commands
src-tauri/src/commands/services.rs - Homebrew runner
src-tauri/src/brew.rs - PTY management
src-tauri/src/pty.rs - Doctor probes
src-tauri/src/doctor/mod.rs - Session tracking
src-tauri/src/session.rs - Machine context
src-tauri/src/context.rs - Menu bar
src-tauri/src/tray.rs
Other components
- User
- Homebrew CLI
Connections 24
- User → App shell: uses
- App shell → Module selection: gates modules
src/app/App.tsx - User → Services interface: manages services
- Services interface → Service discovery: shows live data
- Service discovery → Brew commands: queries services
- Brew commands → Homebrew runner: runs Homebrew
src-tauri/src/commands/services.rs - Homebrew runner → Homebrew CLI: invokes CLI
- Service discovery → Service reconciliation: supplies live list
src/shared/brew/useReconciledServices.ts - Service reconciliation → App state: reads managed intent
- Services interface → Service controls: offers actions
- Service controls → App state: records intent
src/features/services/useServiceControls.ts - Service controls → Brew commands: starts or stops
- User → Package manager: manages packages
- User → Service sessions: reviews uptime
- User → Port monitor: inspects ports
- User → Health checks: runs health checks
- User → Claude chat archive: archives chats
- User → Integrated terminal: opens shell
- Integrated terminal → PTY management: uses PTY
- Health checks → Doctor probes: requests scans
- Brew commands → Session tracking: records service intent
src-tauri/src/commands/services.rs - User → Settings: configures modules
- Machine context → Brew commands: provides brew path
src-tauri/src/commands/services.rs - Brew commands → Menu bar: updates service count