How i-am-tonywu/codex-web works
Codex Web exposes a Windows-hosted Codex workspace through a browser. The principal flow is a remote or local user opening the web UI, selecting or creating a task, and interacting with the host’s Codex client; the UI also surfaces project files, review, skills, automations, and terminal tools. The tray monitors the desktop client and starts the local web service. The README documents the optional Cloudflare remote-access setup. Some server internals are unsampled, so uncertain runtime links are omitted or marked unverified.
Main entry points: codexGateway.ts Codex gateway · httpServer.ts Web server · App.vue Workspace UI · TrayApp.cs Tray controller
Components 24
Windows host
- Tray controller
tray/TrayApp.cs - Codex monitor
tray/Monitor.cs - Web runtime
tray/Runtime.cs - Tray security
tray/SecuritySettings.cs - Cloudflare settings
tray/CloudflareSite.cs - Web server
web/src/server/httpServer.ts
Browser workspace
- Workspace UI
web/src/App.vue - Desktop layout
web/src/components/layout/DesktopLayout.vue - Task navigation
web/src/components/sidebar/SidebarThreadTree.vue - Task conversation
web/src/components/content/ThreadConversation.vue - Task composer
web/src/components/content/ThreadComposer.vue - Workspace state
web/src/composables/useDesktopState.ts
Codex integration
- Codex gateway
web/src/api/codexGateway.ts - RPC transport
web/src/api/codexRpcClient.ts - Response normalization
web/src/api/normalizers/v2.ts - Codex data types
web/src/types/codex.ts - Codex app bridge
web/src/server/codexAppServerBridge.ts
Workspace features
- Git review
web/src/components/content/ReviewPane.vue - Review operations
web/src/server/reviewGit.ts - Skills and extensions
web/src/server/skillsRoutes.ts - Terminal sessions
web/src/server/terminalManager.ts - Account management
web/src/server/accountRoutes.ts
Remote access
- Cloudflare Access
Other components
- Browser user
Connections 24
- Browser user → Workspace UI: opens workspace
README.md - Tray controller → Codex monitor: checks client
tray/TrayApp.cs - Tray controller → Web runtime: starts service
tray/TrayApp.cs - Tray controller → Tray security: configures access
README.md - Tray security → Cloudflare settings: stores site settings
tray/SecuritySettings.cs - Web runtime → Web server: hosts web service
README.md - Workspace UI → Desktop layout: renders
web/src/App.vue - Workspace UI → Task composer: renders
web/src/App.vue - Workspace UI → Task navigation: renders
web/src/App.vue - Workspace UI → Codex gateway: requests workspace data
web/src/App.vue - Task navigation → Codex gateway: loads task data
web/src/components/sidebar/SidebarThreadTree.vue - Workspace state → Codex gateway: loads and updates tasks
web/src/composables/useDesktopState.ts - Codex gateway → RPC transport: dispatches RPC
web/src/api/codexGateway.ts - Codex gateway → Response normalization: normalizes responses
web/src/api/codexGateway.ts - Response normalization → Codex data types: uses data shapes
web/src/api/normalizers/v2.ts - Codex gateway → Codex data types: uses data shapes
web/src/api/codexGateway.ts - RPC transport → Codex app bridge: sends RPC
- Git review → Codex gateway: requests review actions
web/src/components/content/ReviewPane.vue - Web server → Review operations: routes review requests
- Web server → Skills and extensions: routes skill requests
- Web server → Terminal sessions: routes terminal requests
- Web server → Account management: routes account requests
- Browser user → Cloudflare Access: authenticates remotely
README.md - Cloudflare Access → Web server: tunnels to host
README.md