How jpferreria/styx works
Styx OS is a browser-native Unix-like desktop and kernel runtime. A user enters commands in the terminal; the shell routes pipelines and scripts to kernel services, which provide process execution, POSIX facilities, and virtual filesystems. The desktop and file finder form a parallel interactive branch, while an optional local LLM server exposes kernel command execution to external clients. The README documents capabilities not present in sampled excerpts; those connections are cited to it, and unsampled implementation details are represented by their exact source paths.
Main entry points: kernel/index.ts TypeScript Kernel · pipeline.ts Command Pipeline · shell/index.ts Terminal Shell · main.ts Desktop UI
Components 22
Desktop UI
- Desktop UI
packages/shell-ui/src/main.ts - Window Manager
packages/shell-ui/src/shell/wm.ts
Shell Runtime
- Terminal Shell
packages/shell-ui/src/shell/index.ts - Command Pipeline
packages/shell-ui/src/shell/pipeline.ts - Script Interpreter
packages/shell-ui/src/shell/script.ts
Kernel Services
- TypeScript Kernel
packages/shell-ui/src/kernel/index.ts - WASI Execution
packages/shell-ui/src/kernel/execve.ts - Wasm Programs
packages/shell-ui/src/kernel/binaries.ts - Process Services
packages/shell-ui/src/kernel/procfs.ts - IPC and Signals
packages/shell-ui/src/kernel/signal.ts - Security Controls
packages/shell-ui/src/kernel/acl.ts - Network Sockets
packages/shell-ui/src/kernel/socket.ts - Terminal Sessions
packages/shell-ui/src/kernel/tmux.ts - Wasm Linker
packages/shell-ui/src/kernel/shlib.ts
Storage
- Virtual Filesystem
packages/shell-ui/src/kernel/index.ts - EXT4 Block Storage
packages/shell-ui/src/kernel/ext4.ts - Proc and Sys Filesystems
packages/shell-ui/src/kernel/procfs.ts
External Integrations
- LLM Agent Server
packages/shell-ui/src/kernel/llm-server.ts - Code Sandbox
packages/shell-ui/src/kernel/sandbox.ts
Other components
- User
- Browser OPFS
- AI API Clients
Connections 23
- User → Desktop UI: opens desktop
- Desktop UI → Terminal Shell: starts shell
packages/shell-ui/src/main.ts - Desktop UI → Window Manager: initializes
packages/shell-ui/src/main.ts - User → Terminal Shell: enters commands
- Terminal Shell → Command Pipeline: dispatches commands
packages/shell-ui/src/shell/index.ts - Command Pipeline → Script Interpreter: runs scripts
packages/shell-ui/src/shell/pipeline.ts - Terminal Shell → TypeScript Kernel: uses kernel
packages/shell-ui/src/shell/index.ts - Command Pipeline → TypeScript Kernel: invokes syscalls
packages/shell-ui/src/shell/pipeline.ts - TypeScript Kernel → WASI Execution: executes Wasm
packages/shell-ui/src/kernel/index.ts - TypeScript Kernel → Wasm Programs: installs programs
packages/shell-ui/src/kernel/index.ts - Command Pipeline → Process Services: reads process data
packages/shell-ui/src/shell/pipeline.ts - TypeScript Kernel → IPC and Signals: provides IPC
packages/shell-ui/src/kernel/index.ts - TypeScript Kernel → Security Controls: enforces controls
- TypeScript Kernel → Network Sockets: provides sockets
packages/shell-ui/src/kernel/index.ts - TypeScript Kernel → Terminal Sessions: provides sessions
- WASI Execution → Wasm Linker: loads libraries
- TypeScript Kernel → Virtual Filesystem: serves file operations
packages/shell-ui/src/kernel/index.ts - TypeScript Kernel → EXT4 Block Storage: mounts block storage
- TypeScript Kernel → Proc and Sys Filesystems: exposes system files
packages/shell-ui/src/kernel/index.ts - EXT4 Block Storage → Browser OPFS: persists blocks
- AI API Clients → LLM Agent Server: sends API requests
- LLM Agent Server → Code Sandbox: dispatches tool calls
- LLM Agent Server → TypeScript Kernel: runs commands
packages/shell-ui/src/kernel/llm-server.ts