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 0008: Builder Frontend — Ella Chat Stream, Build Runtime, Spec Renderer

  Accepted

  How the dashboard builds features with Ella: the AI SDK UI message stream over an authed no-timeout fetch, the shared build runtime, and a renderer that draws a Build Spec from CQL results.

• ADR 0007: Call Plan Handoff — Deep Link, Plan-in-Prompt, Plan-Match

  Accepted

  How the rep's call plan travels from the Intelligence profile into the live call: the cosella:// deep link contract, the server-rendered plan block, and regex-only live matching of planned objections.

• 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.

Reference

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