How yugienugraha/ruang works
Ruang is a read-only mission-control web app for local Hermes agents and optional OpenCode. The main workflow is to open the office dashboard, which presents crew and work state, then inspect agents, tasks, schedules, usage, activity, memory, folders, or logs. Server-side collectors read local CLI and file data; the browser presents it through pages and a 2D/3D office. Access and profile locks protect private views. The source index identifies the principal modules, but most server routing and collector call paths were not excerpted, so those links are limited to documented relationships.
Main entry points: App.tsx App shell · Office.tsx Office dashboard · index.ts HTTP server · Office3D.tsx 3D office view
Components 26
Web experience
- App shell
src/App.tsx - Office dashboard
src/pages/Office.tsx - Agents page
src/pages/Agents.tsx - Task board
src/pages/TaskBoard.tsx - Cron calendar
src/pages/Calendar.tsx - Activity page
src/pages/Activity.tsx - Usage views
src/pages/TokenUsage.tsx - Memory browser
src/pages/Memory.tsx - Folder browser
src/pages/Folders.tsx - Logs page
src/pages/Logs.tsx
Office visualization
- 3D office view
src/pages/Office3D.tsx - Office layout
src/office3d-layout.ts - Scene environment
src/scene3d/environment.tsx - Scene props
src/scene3d/props.tsx - Procedural textures
src/scene3d/textures.ts
Read-only collection
- HTTP server
server/index.ts - Mission data
server/mission-control.ts - Folder reads
server/folders.ts - Memory reads
server/memory.ts
Privacy controls
- Access codes
server/access.ts - Profile locks
server/profile-lock.ts - Privacy policy
server/privacy.ts - Access UI
src/access.ts - Profile lock UI
src/ProfileLock.tsx
Other components
- Operator
- Hermes CLI
Connections 31
- Operator → App shell: opens
README.md - App shell → Office dashboard: renders
src/App.tsx - App shell → Agents page: renders
src/App.tsx - App shell → Task board: renders
src/App.tsx - App shell → Cron calendar: renders
src/App.tsx - App shell → Activity page: renders
src/App.tsx - App shell → Memory browser: renders
src/App.tsx - App shell → Folder browser: renders
src/App.tsx - App shell → Logs page: renders
src/App.tsx - Office dashboard → Task board: embeds
src/pages/Office.tsx - Office dashboard → Cron calendar: embeds
src/pages/Office.tsx - Office dashboard → Usage views: embeds
src/pages/Office.tsx - Office dashboard → Memory browser: opens
src/pages/Office.tsx - Office dashboard → Folder browser: opens
src/pages/Office.tsx - Office dashboard → 3D office view: shows
src/pages/Office.tsx - 3D office view → Office layout: uses
src/pages/Office3D.tsx - 3D office view → Scene environment: renders
src/pages/Office3D.tsx - Scene environment → Scene props: renders
src/scene3d/environment.tsx - Scene environment → Procedural textures: uses
src/scene3d/environment.tsx - Scene props → Procedural textures: uses
src/scene3d/props.tsx - HTTP server → Mission data: serves reads
server/index.ts - HTTP server → Folder reads: serves reads
server/index.ts - HTTP server → Memory reads: serves reads
server/index.ts - Mission data → Hermes CLI: reads CLI
README.md - Folder reads → Hermes CLI: reads files
- Memory reads → Hermes CLI: reads files
- HTTP server → Access codes: provides access
server/index.ts - HTTP server → Profile locks: provides locks
server/index.ts - Privacy policy → Memory reads: protects
server/privacy.ts - Access UI → Access codes: requests access
src/access.ts - Profile lock UI → Profile locks: controls locks