Cosella Docs

Build on Cosella.

Engineering docs for the sales copilot platform — setup, architecture decisions, and the packages that power dashboard, admin, and desktop.

Get set up → or press Ctrl + K to search

Get set up

→

Install the toolchain and run every app locally in under five minutes.

Learn the architecture

→

How the monorepo is organized and why each package exists.

Contribute

→

Branch strategy, commit conventions, and the PR flow.

Recent decisions

• ADR 0006: Realtime Engine — OpenAI Realtime for Launch

  Accepted

  Why the live copilot ships on OpenAI Realtime WebRTC, what happens to audio-capture and audio-engine, and the upgrade path.

• ADR-0002: Frontend Observability & Error Handling

  Accepted

  How Cosella catches, contains, and reports frontend errors across every surface.

• ADR 0003: Desktop App Scope

  Accepted

  Defines the Cosella Desktop app as an overlay + settings window, not a dashboard.

Reference

• Packages — UI Components · Design Tokens
• Architecture — Overview · ADR-0001