How mentra-community/mentraos works
MentraOS is a cross-compatible smart-glasses platform: users pair glasses with a phone, run miniapps in the phone-side Mentra Runtime, and use shared device and hardware capabilities. The repository also contains cloud services for identity, workspaces, app registry, reports, and administration, plus SDK/client packages for building integrations. The README explicitly describes miniapps running in the Runtime and multiple apps sharing a glasses connection; many cloud and mobile internals are represented by tree paths but were not sampled, so their links are marked unverified rather than treated as inspected call paths.
Main entry points: runtime-services.ts Mentra Runtime · app.ts Cloud API · engine.ts Mobile host · report.service.ts Reports and logs
Components 21
Phone Runtime
- Mobile host
mobile/modules/engine/src/engine.ts - Mentra Runtime
cloud-v2/packages/runtime/src/services/runtime-services.ts - Cloud client service
mobile/modules/engine/src/services/CloudClientService.ts - Device protocol
cloud-v2/packages/protocol/src/messages.ts - Runtime blob storage
cloud-v2/packages/runtime/src/services/storage/storage.service.ts
Miniapp Workloads
- Captions miniapp
miniapps/captions/src/background/controllers/CaptionsController.ts - Navigation miniapp
miniapps/navigation/src/background/NavigationController.ts - Recorder miniapp
miniapps/recorder/src/background/controllers/RecorderController.ts - Teleprompter miniapp
miniapps/teleprompter/src/background/controllers/TeleprompterController.ts
Cloud Platform
- Cloud API
cloud-v2/packages/core/src/api/app.ts - Identity and OIDC
cloud-v2/packages/core/src/services/oidc/provider.ts - Workspace services
cloud-v2/packages/core/src/services/workspaces/workspace.service.ts - Miniapp registry
cloud-v2/packages/core/src/services/registry/registry.service.ts - Reports and logs
cloud-v2/packages/core/src/services/report.service.ts - Core blob storage
cloud-v2/packages/core/src/services/storage/storage.service.ts
SDK and Operations
- Cloud client SDK
cloud-v2/packages/cloud-client/src/client.ts - Miniapp SDK
mobile/modules/miniapp/src/modules/navigation.ts - Admin console
cloud-v2/websites/admin/src/App.tsx - Console MCP
cloud-v2/packages/console-mcp/src/server.ts
Other components
- Glasses user
- Smart glasses
Connections 20
- Glasses user → Mobile host: uses
- Mobile host → Mentra Runtime: hosts apps
- Mentra Runtime → Smart glasses: shares connection
- Mentra Runtime → Captions miniapp: runs miniapp
- Mentra Runtime → Navigation miniapp: runs miniapp
- Mentra Runtime → Recorder miniapp: runs miniapp
- Mentra Runtime → Teleprompter miniapp: runs miniapp
- Mobile host → Cloud client service: initializes
mobile/modules/engine/src/engine.ts - Mentra Runtime → Device protocol: uses messages
- Mobile host → Cloud API: connects to cloud
- Cloud client SDK → Cloud API: calls API
- Cloud API → Identity and OIDC: delegates identity
- Cloud API → Workspace services: serves workspace operations
- Cloud API → Miniapp registry: serves registry operations
- Cloud API → Reports and logs: serves report operations
- Reports and logs → Core blob storage: stores artifacts
- Mentra Runtime → Runtime blob storage: stores runtime blobs
- Miniapp SDK → Mentra Runtime: accesses runtime
- Admin console → Cloud API: administers services
- Console MCP → Cloud API: accesses console data