How siteboon/claudecodeui works
CloudCLI is a responsive desktop/mobile interface for coding-agent CLIs, usable locally or remotely. Users authenticate, select a project and provider, then manage or resume sessions and interact with an agent through chat; the server exposes APIs and coordinates provider runtimes. The product also includes project files, Git, browser-use, plugins, TaskMaster, voice, and notifications, with an optional Electron companion. The graph preserves these documented capabilities; unsampled subsystem links are omitted rather than inferred.
Main entry points: index.ts HTTP Server · App.tsx Application Shell · main.js Desktop App · ChatInterface.tsx Agent Chat
Components 31
Desktop Companion
- Desktop App
electron/main.js - Desktop Windows
electron/desktopWindow.js - Local Server
electron/localServer.js - Server Installer
electron/serverInstaller.js - View Host
electron/viewHost.js - Desktop Notifications
electron/desktopNotifications.js
Web Client
- Application Shell
src/App.tsx - Authentication
src/modules/auth - Workspace UI
src/modules/project-workspace - Agent Chat
src/modules/chat/ChatInterface.tsx - Message State
src/modules/chat/hooks/useChatMessages.ts - Session Store
src/modules/chat/hooks/useSessionStore.ts - API Client
src/shared/api.ts - User Preferences
src/shared/userSettings.ts - Theme Context
src/shared/context/ThemeContext.tsx - Localization
src/modules/i18n/config.ts
Agent Server
- HTTP Server
server/index.ts - Application Database
server/modules/database - Provider API
server/modules/providers/provider.routes.ts - Model Catalog
server/modules/providers/services/provider-models.service.ts - Session Service
server/modules/providers/services/sessions.service.ts - Session Watcher
server/modules/providers/services/sessions-watcher.service.ts - Agent CLIs
server/modules/providers/list
Project Workspace
- File Explorer
server/modules/file-tree/file-tree.routes.ts - Git Explorer
server/modules/git/git.routes.ts - Browser Use
server/modules/browser-use/browser-use.service.ts
Product Extensions
- Plugin System
server/modules/plugins - TaskMaster
server/modules/taskmaster - Voice
server/modules/voice - Notifications
server/modules/notifications
Other components
- User
Connections 31
- User → Application Shell: uses
- User → Desktop App: opens
- Desktop App → Desktop Windows: creates
electron/main.js - Desktop App → Local Server: manages
electron/main.js - Local Server → Server Installer: uses
electron/localServer.js - Desktop Windows → View Host: uses
electron/desktopWindow.js - Desktop App → Desktop Notifications: configures
electron/main.js - Application Shell → Authentication: provides
src/App.tsx - Application Shell → Workspace UI: routes to
src/App.tsx - Application Shell → Theme Context: provides
src/App.tsx - Application Shell → Localization: provides
src/App.tsx - User → Agent Chat: chats with
- Agent Chat → Message State: manages
- Agent Chat → Session Store: uses
- Agent Chat → API Client: requests
- Workspace UI → User Preferences: reads
- API Client → HTTP Server: calls API
- HTTP Server → Application Database: initializes
server/index.ts - HTTP Server → Provider API: mounts routes
server/index.ts - Provider API → Model Catalog: serves models
- Provider API → Session Service: serves sessions
- HTTP Server → Session Watcher: initializes
server/index.ts - Session Watcher → Agent CLIs: observes
- User → File Explorer: explores files
- User → Git Explorer: manages changes
- User → Browser Use: uses browser
- User → Plugin System: extends
- User → TaskMaster: plans tasks
- User → Voice: uses voice
- HTTP Server → Plugin System: starts servers
server/index.ts - HTTP Server → Notifications: configures push
server/index.ts