Summary

OCTO Web offers a unified React/TypeScript codebase for both web and desktop (Electron) clients of the OCTO open workplace. It targets users and developers seeking a collaborative platform with integrated AI agent capabilities, providing consistent UX and advanced AI interaction features across platforms. The key benefit is code reusability and streamlined dual-surface application development.

How It Works

A single React/TypeScript codebase compiles to browser and Electron builds, eliminating UX divergence. It communicates with octo-server via REST/WebSockets. The Electron shell is minimal, forwarding native OS capabilities via IPC. The UI prioritizes AI agent interactions, featuring streaming replies, typing indicators, and inline tool-call previews.

Quick Start & Requirements

Install via pnpm install after cloning. Run the web build with pnpm dev. Requires a running octo-server (defaulting to http://localhost:8080), configurable via .env.local. Build browser bundles with pnpm build, Electron apps with pnpm pc:dev or pnpm pc:package. Tests run with pnpm test.

Highlighted Details

• Unified Codebase: Single React/TypeScript source for browser and Electron apps.
• AI Agent UX: Dedicated UI for streaming replies, typing indicators, tool-call previews.
• Bilingual Support: Built-in English/Simplified Chinese localization.
• Local-First: Aligns with principle of local execution where feasible.

Maintenance & Community

Contribution guidelines are in CONTRIBUTING.md, with CODE_OF_CONDUCT.md and SECURITY.md provided. Maintained by OCTO Contributors (Mininglamp-OSS). No community channel links were specified.

Licensing & Compatibility

Licensed under Apache License 2.0, generally permissive for commercial use and integration.

Limitations & Caveats

Requires a running octo-server backend. Mobile client support is handled by separate repositories (octo-android, octo-ios). Focus on AI agent UX indicates active development in this area.