How phreshos/system works
PhreshOS is a self-hosted system runtime and browser desktop for web-based Programs. The owner signs in through the Desktop; the System maintains authoritative Program and Process state, runs Program endpoints, and mediates their communication and access to system capabilities. The Desktop reflects that state through windows, shell, and appearance controls. The README documents the product-level workflow and capabilities; source excerpts and the SOURCE INDEX support selected internal links, while unsampled subsystems are shown without speculative wiring.
Main entry points: auth-manager/auth-manager.ts Session authorization · process-manager.ts Process management · auth-manager/auth-manager.ts Desktop session state · program-manager.ts Program management
Components 24
System runtime
- System entry
source/server/main.ts - HTTP gateway
source/server/view/gateway/gateway.ts - Server application
source/server/core/application.ts - Connection links
source/server/core/link-manager/link-manager.ts
Programs and processes
- Program management
source/server/core/link-manager/auth-manager/program-manager/program-manager.ts - Program definition
source/server/core/link-manager/auth-manager/program-manager/program.ts - Process management
source/server/core/link-manager/auth-manager/process-manager/process-manager.ts - Process lifecycle
source/server/core/link-manager/auth-manager/process-manager/process.ts - Endpoint runtime
source/server/core/server-runtime.ts
Identity and capabilities
- Authentication
source/server/core/authentication/authentication.ts - Session authorization
source/server/core/link-manager/auth-manager/auth-manager.ts - Permission control
source/server/core/permission-manager.ts
Browser desktop
- Desktop application
source/client/core/application.ts - Desktop connection
source/client/core/link-manager/link-manager.ts - Desktop session state
source/client/core/link-manager/auth-manager/auth-manager.ts - Program hosting
source/client/view/components/desktop-host/host.ts - Desktop shell and windows
source/client/view/structure/desktop/desktop.tsx - Window management
source/client/view/components/window-manager/window-manager.ts - Appearance settings
source/server/core/appearance-manager.ts
Shared services
- Storage and uploads
source/server/core/upload-manager.ts - Program communication
source/server/core/protocol/proxy.ts - System logs
source/server/core/logs.ts
Other components
- Owner
- Browser
Connections 26
- Owner → Browser: uses
README.md - Browser → HTTP gateway: opens desktop
README.md - System entry → HTTP gateway: serves
source/server/main.ts - HTTP gateway → Desktop application: serves desktop
README.md - Desktop application → Desktop connection: connects through
source/client/core/application.ts - Desktop connection → Connection links: reaches system
README.md - Owner → Authentication: signs in
README.md - Connection links → Session authorization: routes authenticated links
source/server/core/link-manager/link-manager.ts - Session authorization → Authentication: authenticates connections
source/server/core/link-manager/auth-manager/auth-manager.ts - Session authorization → Program management: initializes
source/server/core/link-manager/auth-manager/auth-manager.ts - Session authorization → Process management: initializes
source/server/core/link-manager/auth-manager/auth-manager.ts - Session authorization → Permission control: delegates permission checks
source/server/core/link-manager/auth-manager/auth-manager.ts - Program management → Program definition: loads definitions
source/server/core/link-manager/auth-manager/program-manager/program-manager.ts - Process management → Process lifecycle: manages
source/server/core/link-manager/auth-manager/process-manager/process-manager.ts - Process lifecycle → Endpoint runtime: starts endpoint
source/server/core/link-manager/auth-manager/process-manager/process.ts - Process management → Program management: resolves Program
source/server/core/link-manager/auth-manager/process-manager/process-manager.ts - Process management → Program communication: mediates endpoint communication
- Session authorization → Storage and uploads: serves storage access
source/server/core/link-manager/auth-manager/auth-manager.ts - Desktop connection → Desktop session state: creates session state
source/client/core/link-manager/link-manager.ts - Desktop session state → Program management: reflects Program state
source/client/core/link-manager/auth-manager/auth-manager.ts - Desktop session state → Process management: reflects Process state
source/client/core/link-manager/auth-manager/auth-manager.ts - Program hosting → Desktop session state: hosts client endpoints
- Desktop session state → Window management: provides Process windows
source/client/view/components/window-manager/window-manager.ts - Desktop shell and windows → Window management: manages visible windows
source/client/view/components/window-manager/window-manager.ts - Desktop shell and windows → Appearance settings: shows appearance
- Session authorization → System logs: forwards log records
source/server/core/link-manager/auth-manager/auth-manager.ts