Mininglamp-OSS/octo-web

Web & desktop (Electron) client for the OCTO open workplace — one React + TypeScript codebase shipping browser and PC surfaces, with first-class AI agent UX.

What it solves

OCTO Web provides a unified user interface for the OCTO messaging platform, allowing humans to collaborate with AI agents (referred to as "Lobsters"). It eliminates the need for separate codebases for web and desktop applications by using a single React codebase that targets both the browser and a PC client via Electron.

How it works

Built with TypeScript and React, the client communicates with an octo-server backend using REST and WebSockets. The architecture is split into route-level views, a shared UI kit, a client-side state store, and an API layer. For the PC version, a thin Electron shell wraps the React application to provide native OS capabilities like notifications and file drops.

Who it’s for

Users and developers who want a cross-platform workplace environment where AI agents handle execution and thinking tasks while humans provide direction and taste.

Highlights

  • Cross-platform delivery: A single codebase ships as both a web app and a desktop application.
  • Agent-optimized UI: Includes specialized surfaces for AI interactions, such as streaming replies, tool-call previews, and agent identity chips.
  • Bilingual support: Native English and Simplified Chinese localization built-in.
  • Local-first philosophy: Designed to support a workflow where data and agents can run on the user's own hardware.

Related

  • Project
  • Project
  • Project
  • Project
  • Project