How neuralnomadsai/codenomad works
CodeNomad is a desktop and browser workspace for OpenCode V2. The main workflow is to open a project, connect to the shared OpenCode service, manage sessions, and work with conversation history and Git changes in the UI. The repository also documents remote access, files, previews, SideCars, plugins, speech, and desktop browser automation. The graph combines README-documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details are not assumed.
Main entry points: App.tsx Workspace App · http-server.ts HTTP Server · sessions.ts Session Store · api-client.ts HTTP API Client
Components 26
Workspace UI
- Workspace App
packages/ui/src/App.tsx - Prompt Composer
packages/ui/src/components/prompt-input.tsx - Conversation View
packages/ui/src/components/session/session-view.tsx - Workspace Panels
packages/ui/src/components/instance/shell/right-panel - HTTP API Client
packages/ui/src/lib/api-client.ts - Storage Cache
packages/ui/src/lib/storage.ts - UI Logging
packages/ui/src/lib/logger.ts
Sessions and Git
- Session Store
packages/ui/src/stores/sessions.ts - Session API
packages/ui/src/stores/session-api.ts - Session State
packages/ui/src/stores/session-state.ts - History Navigation
packages/server/src/opencode/session-pruning - Git Worktrees
packages/ui/src/stores/worktrees.ts
Server Services
- HTTP Server
packages/server/src/server/http-server.ts - Workspace Manager
packages/server/src/workspaces/manager.ts - OpenCode Service
packages/server/src/workspaces/opencode-service.ts - Event Bus
packages/server/src/events/bus.ts - Instance Storage
packages/server/src/storage/instance-store.ts - File Access
packages/server/src/server/routes/filesystem.ts - Shared Contracts
packages/server/src/api-types.ts
Desktop Runtime
- Desktop Host
packages/electron-app/electron/main/main.ts
Tools and Access
- Browser Preview
packages/electron-app/electron/main/browser-controller.ts - Remote Access
packages/server/src/auth/manager.ts - SideCars
packages/server/src/sidecars/manager.ts - Plugin Controls
packages/server/src/server/routes/plugin-controls.ts - Speech
packages/server/src/speech/service.ts
Other components
- Developer
Connections 27
- Developer → Workspace App: opens workspace
README.md - Workspace App → Prompt Composer: composes prompts
README.md - Workspace App → Session Store: browses sessions
README.md - Session Store → Session API: loads sessions
packages/ui/src/stores/sessions.ts - Session Store → Git Worktrees: reloads worktrees
packages/ui/src/stores/sessions.ts - Session Store → Session State: uses state
packages/ui/src/stores/sessions.ts - Session Store → Conversation View: shows conversation
README.md - Session API → HTTP API Client: requests data
- Conversation View → History Navigation: navigates history
README.md - Workspace App → Workspace Panels: shows Git changes
README.md - Git Worktrees → Workspace Manager: manages worktrees
- HTTP API Client → HTTP Server: sends requests
packages/ui/src/lib/api-client.ts - HTTP Server → Workspace Manager: routes workspace operations
- Workspace Manager → OpenCode Service: connects service
README.md - HTTP Server → File Access: serves file access
- HTTP Server → Instance Storage: reads and writes
- Storage Cache → HTTP API Client: loads and patches
packages/ui/src/lib/storage.ts - Storage Cache → Event Bus: updates cache
packages/ui/src/lib/storage.ts - HTTP Server → Event Bus: publishes events
- HTTP Server → Shared Contracts: uses contracts
- Developer → Desktop Host: runs desktop app
README.md - Desktop Host → Browser Preview: hosts previews
README.md - Developer → Remote Access: authenticates remotely
README.md - Workspace App → SideCars: opens web tools
README.md - Workspace App → Plugin Controls: manages activation
README.md - Prompt Composer → Speech: uses voice input
README.md - Workspace App → UI Logging: logs UI activity
packages/ui/src/App.tsx