How eshwar-gajula/echa-shell works
ECHA is a Windows desktop shell whose main workflow is to open a React HUD, collect live system and hardware data, and let users operate workspaces, files, applications, terminal commands, and power controls through Tauri/Rust. The graph includes the documented scanner, ConPTY, hardware, and telemetry capabilities alongside sampled UI and backend layers. Some feature implementations were not sampled; those branches rely on README documentation, and no unverified internal call chains are asserted.
Main entry points: DashboardLayout.tsx Dashboard layout · Terminal.tsx Terminal interface · Header.tsx System header · tauriCommands.ts Tauri command bridge
Components 31
Desktop HUD
- App bootstrap
src/App.tsx - Dashboard layout
src/components/Workspaces/DashboardLayout.tsx - System header
src/components/Header.tsx - Telemetry panel
src/components/HUD/LeftPanel.tsx - Hardware controls
src/components/HUD/SystemControls.tsx - Navigation panel
src/components/HUD/RightPanel.tsx
Workspace & Terminal
- Workspace view
src/components/Workspaces/WorkspaceContainer.tsx - Workspace switcher
src/components/HUD/WorkspaceSwitcher.tsx - Workspace profiles
src/context/WorkspaceContext.tsx - Workspace access hook
src/hooks/useWorkspaces.ts - Terminal interface
src/components/Terminal/Terminal.tsx - CLI command parser
src/utils/echaCli.ts - Audio feedback
src/utils/audioSynth.ts
Tauri Services
- Telemetry subscription
src/hooks/useTelemetry.ts - Telemetry service
src-tauri/src/telemetry.rs - Hardware diagnostics
src-tauri/src/commands/system.rs - Tauri command bridge
src/utils/tauriCommands.ts - Hardware command bridge
src/utils/tauriSystemCommands.ts - Power & shell controls
src-tauri/src/commands/power.rs - ConPTY engine
src-tauri/src/commands/pty.rs - Global keyboard hook
src-tauri/src/hooks.rs - Hardware data types
src/types/system.ts - Telemetry data types
src/types/telemetry.ts
File & App Discovery
- App library
src/components/Scanner/AppLibrary.tsx - File inspector
src/components/HUD/FilesTab.tsx - App scanner
src-tauri/src/scanner/registry.rs - App categorization
src-tauri/src/scanner/categorize.rs - Scanner commands
src-tauri/src/commands/scanner.rs - File navigation
src-tauri/src/commands/fs.rs
Other components
- Desktop user
- Windows system
Connections 32
- Desktop user → App bootstrap: opens
README.md - App bootstrap → Dashboard layout: renders
src/App.tsx - Dashboard layout → System header: renders
src/components/Workspaces/DashboardLayout.tsx - Dashboard layout → Telemetry panel: renders
src/components/Workspaces/DashboardLayout.tsx - Dashboard layout → Navigation panel: renders
src/components/Workspaces/DashboardLayout.tsx - Dashboard layout → Workspace view: renders
src/components/Workspaces/DashboardLayout.tsx - Dashboard layout → Telemetry subscription: reads
src/components/Workspaces/DashboardLayout.tsx - System header → Hardware command bridge: requests
src/components/Header.tsx - System header → Tauri command bridge: requests
src/components/Header.tsx - Workspace view → Terminal interface: renders
src/components/Workspaces/WorkspaceContainer.tsx - Workspace view → Workspace access hook: uses
src/components/Workspaces/WorkspaceContainer.tsx - Workspace access hook → Workspace profiles: reads
src/hooks/useWorkspaces.ts - Workspace switcher → Workspace profiles: switches
- Workspace profiles → Audio feedback: plays cues
src/context/WorkspaceContext.tsx - Terminal interface → Workspace access hook: switches
src/components/Terminal/Terminal.tsx - Terminal interface → CLI command parser: dispatches
src/components/Terminal/Terminal.tsx - Terminal interface → Tauri command bridge: launches apps
src/components/Terminal/Terminal.tsx - Terminal interface → Audio feedback: plays cues
src/components/Terminal/Terminal.tsx - Telemetry service → Telemetry subscription: streams data
README.md - Telemetry panel → Telemetry data types: displays
src/components/HUD/LeftPanel.tsx - Hardware command bridge → Hardware diagnostics: invokes
- Tauri command bridge → Power & shell controls: invokes
- Tauri command bridge → ConPTY engine: invokes
- Hardware diagnostics → Windows system: controls hardware
README.md - Hardware controls → Hardware command bridge: requests
src/components/HUD/SystemControls.tsx - Hardware data types → System header: types data
src/components/Header.tsx - Navigation panel → App library: renders
src/components/HUD/RightPanel.tsx - Navigation panel → File inspector: renders
src/components/HUD/RightPanel.tsx - App library → Scanner commands: requests scans
- File inspector → File navigation: browses files
- Scanner commands → App scanner: dispatches
- App scanner → App categorization: categorizes
src-tauri/src/scanner/registry.rs