Pragma — Run teams of coding agents in parallel.

Run Claude Code, Codex, OpenCode, Cursor and more each in their own worktree.
Agents, terminals, diffs, and pull requests in one workspace.

Download for macOS Download for Windows Download for Linux Download Pragma Go on the App Store Get Pragma Go on Obtainium

Website  ·  Documentation  ·  Download  ·  Plugins  ·  Contributing  ·  Discord  ·  YouTube

Latest release Total downloads Downloads of the latest release

Claude Code plugin 10 agent plugins Agent Skills

CI status License: AGPL-3.0-only Platforms: macOS, Linux, Windows Built with Tauri v2 Rust Bun

--- ## Table of Contents - [Why Pragma?](#why-pragma) - [Quick Start](#quick-start) - [Features](#features) - [Supported Agents](#supported-agents) - [Download](#download) - [Documentation](#documentation) - [Build From Source](#build-from-source) - [Repository Map](#repository-map) - [Contributing](#contributing) - [License](#license) ## Why Pragma? You can start five agents in a normal terminal window but it becomes hard to see which agent is doing what. Worse if you are running multipile agents in the same project their changes may collide. Pragma is an open-source agentic development environment for people running many agents in parallel. Projects, worktrees, terminals, files, diffs, pull requests, and agent status live in one workspace — while every coding agent keeps running through its own native TUI, exactly as its authors shipped it. There are many tools like Pragma so here is a comparison: | Capability | Pragma | Emdash | Orca | Superset | | ------------------------------------------------------------------------------------------- | ---------------------------------------- | ---------- | ----------------------------------- | ----------------------------- | | **Native shell**
Rust host + the OS webview, not a bundled browser | **Tauri + Rust** | Electron | Electron | Electron | | **Agents as plugins**
Each integration a versioned package with official branding | **✅** | 🟡 | 🟡 | 🟡 | | **Public plugin API**
Third-party sidebar tabs, cards, web views, and commands | **✅** | ❌ | ❌ | ❌ | | **Programmable automations**
Your TypeScript on host events, not just a schedule | **✅** | 🟡 | 🟡 | 🟡 | | **Interactive scratchpads**
Agents write MDX with live React you can edit and comment on | **✅** | ❌ | ❌ | ❌ | | **Agent board**
Prompt to review to pull request as tracked cards | **✅** | ❌ | ❌ | ✅ | | **Fanout + comparison view**
One prompt into N attempts, compared side by side | **✅** | ❌ | ✅ | 🟡 | | **Editing suite**
Code, markdown WYSIWYG, PDF, image, video, and audio | **✅** | 🟡 | 🟡 | 🟡 | | **Built-in AI, your key**
Inline ⌘K edits, one-click PR drafting, ask from the palette | **✅** | ❌ | 🟡 | ❌ | | **Mobile and web client**
What ships, and how you reach it off your LAN | **iOS, Android, Web**
your own tunnel | ❌ | iOS, Android
needs Tailscale/VPS | iOS only, Pro
hosted relay | | **Persistent host server**
Sessions, tunnels, headless launches survive quitting | **✅** | 🟡 | 🟡 | 🟡 | | **Remote projects**
SSH hosts as first-class remote projects | **SSH** | SSH | SSH + WSL | ❌ | | **User themes**
Editable colour tokens per project, not a fixed preset list | **✅** | 🟡 | 🟡 | 🟡 | | **License**
What you may do with the source | **AGPL-3.0** | Apache-2.0 | MIT | Elastic 2.0 | ✅ yes  ·  🟡 partial  ·  ❌ no Checked against the `generalaction/emdash`, `stablyai/orca`, and `superset-sh/superset` repositories as of 2026-08-29. These projects ship fast — if something here is out of date, open an issue and we will correct it. On the mobile row: Pragma's tunnel is a command you supply and control (ngrok, cloudflared, a Tailscale funnel — whatever you already run), not a vendor relay you depend on. Orca has no tunnel of its own; remote access means installing Tailscale yourself or running Orca's full server on a VPS. Superset's reaches your machine through Superset's own hosted relay, and the iOS app is Pro-plan only. ## Quick Start 1. [Download Pragma](#download) for macOS, Windows, or Linux and install it. 2. Add a project — any git checkout — from the bottom of the sidebar. 3. Create a worktree, pick an agent, and type a prompt. The [quick start guide](https://pragma-app.sh/docs/user-guide/quick-start) walks through the full loop from first prompt to merged pull request. ## Features ### 🌿 Parallel by default Launch Claude Code, Codex, OpenCode, Cursor, and friends in separate branches and worktrees. No collisions, no stashing, no "wait, which agent touched this file?" ### 🔀 Fanout — one prompt, many attempts Send a single prompt to several isolated attempts, compare their terminals, diffs, and scratchpads side by side, then keep the strongest result and throw the rest away. ### 🔌 Persistent sessions Terminals and scrollback live on the host, not in the window. Close the app, drop the network, move to another machine — the agent keeps working and the scrollback is still there. ### 🔍 One review surface Inspect diffs, stage files, commit, push branches, and manage GitHub pull requests beside the agent that wrote the code. ### 🛰️ Local-first, and anywhere Run on your machine, over SSH, or inside WSL. Desktop app on macOS, Linux, and Windows, with companion access from iOS, Android, and the browser. ### 🧩 Extensible Plugins add UI, commands, agents, and themes. Automations run scheduled and event-driven host tasks. The CLI and the typed `@pragma-sh/sdk` drive all of it from scripts. [**▶ Watch the feature tour →**](https://pragma-app.sh) ## Supported Agents Every agent runs through its own native CLI. Pragma adds a plugin so it reports status and shows up in the launcher. Missing yours? Agent plugins are ordinary TypeScript packages — see the [plugin guide](https://pragma-app.sh/docs/plugins). ## Download Signed installers for every platform are attached to each [GitHub Release](https://github.com/pragma-sh/pragma/releases/latest). The links below always fetch the newest one. | Platform | Download | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | macOS | [Apple silicon (.dmg)](https://pragma-app.sh/download/darwin-aarch64) · [Intel (.dmg)](https://pragma-app.sh/download/darwin-x86_64) | | Windows | [x64 installer (.exe)](https://pragma-app.sh/download/windows-x86_64) · [ARM64 installer (.exe)](https://pragma-app.sh/download/windows-aarch64) | | Linux | x64: [.deb](https://pragma-app.sh/download/linux-x86_64-deb) · [.rpm](https://pragma-app.sh/download/linux-x86_64-rpm) — ARM64: [.deb](https://pragma-app.sh/download/linux-aarch64-deb) · [.rpm](https://pragma-app.sh/download/linux-aarch64-rpm) | Pragma updates itself in place once installed. Release notes and older builds are on the [releases page](https://github.com/pragma-sh/pragma/releases). ### Pragma Go (mobile) Pragma Go pairs with your desktop so you can launch agents, watch sessions, and answer their questions from your phone — see the [mobile guide](https://pragma-app.sh/docs/user-guide/mobile). - **Android** — install and auto-update the APK with [Obtainium](#android-with-obtainium). - **iOS** — [download Pragma Go on the App Store](https://apps.apple.com/us/app/pragma-sh-go/id6804842149). - **Web** — served by your desktop; turn on **Enable web access** under Settings → Pragma Go. #### Android with Obtainium [Obtainium](https://github.com/ImranR98/Obtainium) installs Android apps straight from their GitHub releases and keeps them updated. 1. Install Obtainium from its [releases page](https://github.com/ImranR98/Obtainium/releases/latest) or F-Droid. 2. Tap **Add app** and enter `https://github.com/pragma-sh/pragma` as the source URL. 3. This repository also publishes desktop and plugin releases, so set: - **Filter release titles by regular expression** → `^pragma-go` - **Filter APKs by regular expression** → `\.apk$` - **Fallback to older releases** → on - **Version detection** → **Use release date as version string** 4. Tap **Add**, then **Install**. Obtainium notifies you whenever a new Pragma Go release is published. The [Android install guide](https://pragma-app.sh/docs/user-guide/mobile#android-with-obtainium) explains each option and why it is needed. ## Documentation | Resource | What it covers | | ----------------------------------------------------------- | ------------------------------------------------------ | | [Website](https://pragma-app.sh) | Product overview and feature tour | | [Documentation](https://pragma-app.sh/docs) | Main documentation hub | | [User guide](https://pragma-app.sh/docs/user-guide) | Projects, worktrees, agents, review, and settings | | [CLI reference](https://pragma-app.sh/docs/cli) | Control Pragma and report agent status from a terminal | | [TypeScript SDK](https://pragma-app.sh/docs/sdk) | Build typed integrations with `@pragma-sh/sdk` | | [Plugin development](https://pragma-app.sh/docs/plugins) | Add UI, commands, agents, themes, and integrations | | [Plugin gallery](https://pragma-app.sh/plugins) | Browse available Pragma plugins | | [Automations](https://pragma-app.sh/docs/automations) | Run scheduled and event-driven host tasks | | [Architecture wiki](https://pragma-app.sh/docs/wiki) | Desktop, server, gateway, and protocol layers | | [Issue tracker](https://github.com/pragma-sh/pragma/issues) | Report bugs and request features | | [Discord](https://discord.gg/cGzZE2wSG) | Chat with the team and other Pragma users | | [YouTube](https://www.youtube.com/@pragma-sh) | Demos, walkthroughs, and release videos | ## Build From Source Prerequisites: - [Bun](https://bun.sh/) 1.4.4 or newer - Stable [Rust toolchain](https://www.rust-lang.org/tools/install) with clippy and rustfmt - [Tauri system prerequisites](https://v2.tauri.app/start/prerequisites/) for your platform ```bash git clone https://github.com/pragma-sh/pragma.git cd pragma bun install bun run dev ``` See [CONTRIBUTING.md](./CONTRIBUTING.md) for mobile, web, and docs dev workflows. ## Contributing Read **[CONTRIBUTING.md](./CONTRIBUTING.md)** first — it covers the contribution policy, prerequisites, running the desktop app and Pragma Go, the project tour, style guidelines, commit style, and how to open a pull request. **Policy in short: we only accept small features.** Bug fixes and other small, focused changes are the most likely to be merged; large features and sweeping refactors will almost certainly be declined. Open an issue before building anything non-trivial. Before opening a pull request: ```bash bun run check bun run test bun run rust:test ``` Use [Conventional Commits](https://www.conventionalcommits.org/) and include focused tests with behavior changes. `AGENTS.md` (and the per-package `AGENTS.md` files) hold the deeper architecture and platform rules for human and AI contributors alike. Bugs and ideas start in the [issue tracker](https://github.com/pragma-sh/pragma/issues). ## License [GNU Affero General Public License v3.0](./LICENSE). **If Pragma saves you a tab, [give it a star](https://github.com/pragma-sh/pragma/stargazers). ⭐** Built with Tauri, Rust, React, and Bun.