Overlay

Overlay is an open-source workspace where humans and AI agents share context and get work done together. Keep knowledge in one place, delegate repeatable work to agents, review what they produce, and take action through connected tools.

🔗 Try Overlay

Why Overlay

Most AI products stop at a single answer. Overlay is built around the next step: a person and one or more agents working in the same context. A human can set direction, provide files and memory, ask an agent to research or execute a task, inspect the result, and decide what happens next.

The workspace is the shared layer between people and agents. Conversations, notes, files, projects, connected apps, and automations can be combined without moving work between separate tools. Overlay is designed to stay provider-neutral as models and agent runtimes change.

Documentation

• Developer & self-hosting docs — local setup, runtime config, deployment, API reference.
• Quickstart — get the web app running locally.
• API Reference — generated from src/shared/schemas/api-boundary.ts.
• Security policy — reporting, launch controls, and secret handling.

Powered By

• Next.js 15 — React framework with App Router
• Tailwind CSS — Styling
• Vercel AI SDK — AI streaming, tool calling, and multi-provider support
• Convex — Backend functions, data, and realtime sync
• WorkOS — Enterprise authentication and SSO
• Stripe — Billing and subscriptions
• Composio — External app integrations
• TipTap — Rich text editing
• Vercel Sandbox — Default managed code execution sandbox
• Daytona — Optional alternative sandbox provider
• Browser Use — Browser automation
• OpenRouter — Unified model API
• Shadcn/UI — UI components

Repository Layout

.
├── convex/                  # Backend schema, queries, mutations, actions, HTTP routes
├── src/app/                 # Next.js pages, layouts, and API route handlers
├── src/features/            # Web feature containers and feature-local helpers
├── src/components/          # Shared UI primitives, layout, and providers
├── src/server/              # Server-only auth, billing, storage, AI, and route services
├── src/shared/              # Isomorphic contracts and client-safe helpers
├── packages/                # Cross-surface packages and typed API clients
├── scripts/                 # Sanity scripts and one-off checks
├── docs/                    # Product, setup, testing, marketing, and implementation docs
├── AGENTS.md                # Local agent workspace notes
├── LICENSE                  # AGPL-3.0 license text
└── SECURITY.md              # Security policy and reporting guidance

Local Development

Prerequisites

• Node.js 22+
• npm
• Convex account (dev + prod deployments)
• WorkOS credentials (for auth)
• Stripe test credentials (for billing)

Quick Start

# Install dependencies
npm install
Configure environment
cp .env.example .env.local
Edit .env.local with your credentials
Run development server
npm run dev

For complete environment setup, see docs/start/quickstart.mdx and docs/configure/environment.mdx.

Convex Workflow

Convex deployments are environment-specific. Use npm run convex:push:dev only from the dedicated staging worktree. Use npm run convex:push:prod only from a clean canonical main worktree after its matching web deployment is live. Feature worktrees must not deploy Convex.

Available Commands

| Command | Purpose | |---------|---------| | npm run dev | Run the Next.js development server | | npm run build | Create a production build | | npm run convex:push:prod | Push Convex changes to production | | npm run convex:push:dev | Push Convex changes to dev |

Security

• Session cookies are encrypted and signed
• Transfer tokens are short-lived and hashed
• Provider keys isolated behind PROVIDER_KEYS_SECRET
• Sensitive logs redacted in chat and billing flows
• See SECURITY.md for full security guidance

Project status

Overlay is under active development. The hosted product and the open-source repository may change as the collaboration model, provider integrations, and self-hosting support mature. Treat deployment, billing, and provider configuration as environment-specific and verify them before running a production instance.

Contributing

• Do not commit real secrets or customer data
• Keep public docs on placeholders
• Treat NEXT_PUBLIC_* values as public
• Prefer backend logic in convex/ with web handlers in src/app/api/
• Open issues and pull requests are welcome. LayerNorm requires the contributor terms in CLA.md before accepting an outside contribution.

License

All first-party material stored directly in this repository is licensed under AGPL-3.0-only. Paid commercial licenses are available separately from LayerNorm Inc. Third-party material and separate submodules retain their own licenses.

• Overlay branding is governed by the trademark policy.

Overlay — A shared workspace for humans and agents.