Quick Start
Get up and running in under 5 minutes with the desktop app or CLI launcher.
Installation
All installation methods — npm, curl, GitHub Releases, AUR.
Desktop App
Learn the kanban board, task execution, batch operations, and model selection.
API Reference
Complete REST API documentation for tasks, teams, projects, and execution.
What Ships
OpenLinear is distributed as a monorepo with several components:Desktop App
Tauri desktop app with a Next.js webview — the primary way to use OpenLinear. Includes the sidecar API for local execution.
CLI Launcher
The
openlinear npm package — launches the desktop app and handles GitHub authentication from the terminal.npm Library
TypeScript utilities for execution metadata validation, payload sanitization, and feature flag management.
Landing Site
Next.js marketing and documentation surface, deployed on Vercel.
How It Works
Create a Task
Describe what you want built in plain language on the kanban board. Add labels, set priority, assign to a project.
Connect a Repository
Link a GitHub repository or point to a local folder. OpenLinear clones it and creates a working branch.
Execute
Click execute. An AI agent (powered by OpenCode) reads your task, writes the code, and commits changes — all locally on your machine.
Agent Support
| Agent | Status |
|---|---|
| OpenCode | Integrated |
| Claude Code | Planned |
| Codex | Planned |
| Aider | Planned |
Tech Stack
| Layer | Technology |
|---|---|
| Desktop shell | Tauri 2.x (Rust) |
| Desktop UI | Next.js 16, React 19 |
| UI components | Radix UI + shadcn/ui |
| Styling | Tailwind CSS |
| Local API | Express 5 (sidecar) |
| Database | PostgreSQL via Prisma |
| Auth | JWT + GitHub OAuth |
| AI execution | OpenCode SDK |
| Validation | Zod |
| Real-time | Server-Sent Events |
| Build | Turbo + pnpm workspaces |