Browser and Desktop from One React Tree, Built for AI Coworkers

What it does

octo-web is the browser and desktop client for the OCTO messaging platform. It talks to a backend server over REST and WebSocket, presenting a bilingual chat interface that handles both human conversations and AI agent interactions. The same React and TypeScript source compiles into a browser build and an Electron-wrapped desktop application for Windows, macOS, and Linux.

The interesting bit

Instead of maintaining parallel React trees for web and PC, the project branches only at platform-capability boundaries—tray icons, notifications, file drops—while keeping the entire chat UI identical. The README calls this “Lobster-ready UI”: streaming agent replies, inline tool-call previews, and identity chips that distinguish humans from OpenClaw-powered “digital doubles” are core components, not afterthoughts.

Key highlights

• One src/ directory ships both browser and Electron desktop surfaces.
• First-class AI agent UX with streaming replies, typing indicators, and tool-call previews.
• Bilingual shell (English and Simplified Chinese) with i18n keys enforced in CI.
• Thin Electron main process that forwards IPC for native capabilities without forking the React app.
• Browser build runs entirely without Electron dependencies.

Caveats

• Requires a running octo-server instance; it is a client, not a self-contained chat application.
• AI agent features depend on the broader OCTO ecosystem backend.
• Desktop native integration is intentionally limited to tray, notifications, and file drop.

Verdict

Worth a look if you are building a multi-platform chat or workplace client and want to see how to share a React tree between web and Electron without drift. Skip it if you need a standalone, backend-free messaging app or a deeply native desktop experience.