Prometeu Prometeu
Run Claude Code, Codex, Cursor CLI and Antigravity agents in parallel — each in its own git worktree, with built-in diff review.

Latest release MIT license Total downloads macOS / Linux / Windows

Prometeu UI demo with simulated agents: Claude Code and Codex work side by side in separate worktrees; open a conversation, send a follow-up and return to the desk.

Download for macOS (.dmg) · Linux (.AppImage) · Windows (.exe)
macOS Apple Silicon · Linux x86_64 · Windows x64: experimental, Codex through WSL
⭐ Star the repo if it saves you time

## Why not just use the CLI? - Run parallel agents without juggling terminals. - Create isolated worktrees automatically for separate tasks, so agents do not edit the same checkout. - Review changes visually before committing and merging. - Use Claude Code, Codex, Cursor CLI and Antigravity in one app on macOS and Linux. - Free and open source under the MIT license. Bring your own provider account; model usage is billed by your provider. ## Features - **Cursor CLI:** external CLI login, interactive approvals and account quotas. See [Cursor setup](#cursor-cli). - **Parallel workspaces:** isolated worktrees, multiple repositories and a desk for conversations side by side. Delegated work groups into one level of sub-workspaces, each with one conversation and its provider icon. - **Visual Git review:** unified or split diffs, review notes, staging, commits, history and conflict resolution. - **Built-in tools:** editor, terminal, browser preview, MCP servers, plugins, skills and reusable actions. - **Terminal sessions:** shells of their own in the sidebar, started in your home or any folder without a project or workspace, kept across restarts (macOS and Linux). - **Tasks:** Filter Linear and GitHub issues and pull requests, then start a workspace. PR status and notifications keep follow-up visible. - **Persistent conversations:** resume stopped agents and inspect local token and cost history. - **Usage (macOS and Linux):** filter local consumption by period and workspace, inspect token composition and session details in Settings / Analytics. Provider-reported costs and missing measurements stay explicit. - **Optional collaboration:** share encrypted conversations and continue from companion devices while execution stays on the owner's Mac. - **English and Portuguese UI**, with dictation on macOS. See the [provider matrix](docs/quality/provider-matrix.md) for agent differences, platform limits and test coverage. The demo above uses the real interface with simulated agent data; it is not a live provider benchmark. ## Install ### macOS — Apple Silicon Download [Prometeu_aarch64.dmg](https://github.com/prometeucorp/prometeu/releases/latest/download/Prometeu_aarch64.dmg), open it and drag Prometeu to Applications. In-app updates are available. ### Linux — x86_64 Download [Prometeu_x86_64.AppImage](https://github.com/prometeucorp/prometeu/releases/latest/download/Prometeu_x86_64.AppImage) to a directory writable by your user, then run: ```sh chmod +x Prometeu_x86_64.AppImage ./Prometeu_x86_64.AppImage ``` The AppImage adds a launcher to your application menu and supports in-app updates. See the [Linux guide](docs/operations/linux.md) for runtime requirements, source packages, ARM64 builds and platform differences. ### Windows — x64, experimental Install WSL with a default Linux distribution, Git and an authenticated Codex CLI inside that distribution. Download and run [Prometeu_x64-setup.exe](https://github.com/prometeucorp/prometeu/releases/latest/download/Prometeu_x64-setup.exe), then open Prometeu from the Start menu. Windows currently supports **Codex only**. The installer is unsigned; updates require installing the next version manually. Managed login and Cloud synchronization are unavailable. Conversations and files stay in WSL after updating or uninstalling. See [Windows coverage](docs/contracts/windows-application.md). ### Cursor CLI Cursor CLI is supported on macOS and Linux since v0.35.0. Install a Cursor CLI with ACP support, make `cursor-agent` available in your shell, sign in with `agent login`, attach its account in Settings and select it in the launcher. Streaming, tools, resume, stop, questions, plan approvals and hub MCP are supported. Account quotas use the existing CLI login; hub plugins, skills and per-turn token/cost meters are unavailable. See the [Cursor contract](docs/contracts/cursor.md). ## Quick start 1. **Connect an agent.** Install and authenticate Claude Code, Codex, Cursor CLI or Antigravity CLI (agy 1.2.7 or newer). Make `claude`, `codex`, `cursor-agent` or `agy` available in your shell. Cursor and Antigravity use their CLI login. Windows uses Codex in WSL. 2. **Add your project.** Open Prometeu and add a local Git repository or folder. No Prometeu account is required for local work. 3. **Run your first task.** Create a workspace, choose a model, keep the new-worktree option enabled for isolation, and send a task. Open another workspace for a parallel task, then review changes in the Git view before committing. Agents execute tools without per-tool approval by default, with your local user's file and process access. Worktrees separate changes; they are not sandboxes. Folders without Git open in place. Use projects and tools you trust. ## Privacy **Usage analytics are opt-in and off by default since v0.34.0, including upgrades.** Change **Settings → General → Privacy → Share usage data** at any time. Opted-in macOS and Linux builds send content-free feature events to PostHog with a random installation ID. Prompts, transcripts, file paths, project names and agent output are excluded. See the [analytics contract](docs/contracts/product-analytics.md). Local usage history stays on your computer and can be exported or deleted. App state and app-managed transcripts live under `~/.prometeu`; Claude Code owns its transcripts. Your chosen model provider receives the content needed to run your tasks, under that provider's terms. Cloud accounts and sharing are optional. Shared conversations use end-to-end encryption; the relay sees routing metadata. Keys use trust on first contact with automatic adoption of changed keys, and there is no forward secrecy. See [security limits](docs/decisions/0022-end-to-end-encryption.md) and [local data storage](docs/contracts/persistence.md). Report vulnerabilities privately through [SECURITY.md](SECURITY.md). ## Contributing Start with [good first issues](https://github.com/prometeucorp/prometeu/issues?q=is%3Aissue%20is%3Aopen%20label%3A%22good%20first%20issue%22) and [CONTRIBUTING.md](CONTRIBUTING.md). For local setup and checks, see the [development guide](docs/operations/development.md). [Documentation](docs/README.md) · [Architecture](ARCHITECTURE.md) · [Report a bug](https://github.com/prometeucorp/prometeu/issues/new/choose) · [Changelog](CHANGELOG.md) Greptile: The War on Bugs ## License [MIT](LICENSE).