A desktop app for head-to-head coding agent battles, with single-agent mode and free inference. Pick the winning agent and continue from its work.
Free to use. Inference included.
<sub>v0.4.0-beta.23 Β· Release notes</sub>
1. One prompt. You describe a coding task once.
2. Two models, drawn at random. Both get the same prompt, tools and system prompt, and each works in its own copy of your repo. Sides are random, so A and B carry no meaning.
3. Compare the results. Read the Difference summary, open Files changed for the code, and try each version with Preview.
4. Vote. Keep one result or call a tie, before either model is named.
5. Both models named. You see which model wrote each result, and the one you kept is applied to your repo.
agent-duel-demo.mp4 #
The shipped product is the Electron desktop app. packages/app can run in a
browser during development and automated QA, but there is no hosted browser
product.
See leaderboard for model performance
Execution stays on your machine:
Electron UI -> local daemon -> local Arena runtime -> local repositories and agents
|
|-> Agent Duel cloud -> OpenRouter (official download)
`-> OpenRouter (your key in a BYOK build)
The UI WebSocket terminates at the local daemon. The packaged desktop application contains the daemon, renderer, and compiled Arena runtime.
The official download uses Agent Duel's cloud service for sign-in, model assignments, and model calls. The cloud service is closed source and maintained outside this repository.
Arena history is canonical on the desktop: SQLite records live under
$PASEO_HOME/arena/arena.sqlite and artifact bytes under
$PASEO_HOME/arena/artifacts/sha256/.
Read docs/architecture.md for the complete system design and docs/arena.md for the battle.
Local development requires no sign-in. Battles run on your own OpenRouter key, and votes are not uploaded.
- macOS or Linux
- Node.js 22 with npm
- Bun 1.3.14
- An OpenRouter API key
Install both package graphs, then start the desktop stack in bring-your-own-key mode from the repository root:
npm install
cd arena-backend && bun install && cd ..
npm run dev:desktop -- --byok
The launcher prepares an isolated checkout-local environment and starts the
local daemon, the Electron-flavoured Expo server, and Electron. It reports
[dev] healthy: when the stack is ready. Paste your OpenRouter key in Settings;
battles run on that key.
- If a dependency is missing, run
npm installat the root andbun installinarena-backend. - If a port is busy, leave the daemon, Expo, and debugger ports unset where supported so the launcher can choose free ports.
- Inspect
.dev/paseo-home/daemon.logfor daemon failures.
See docs/development.md for worktrees, multiple instances, Playwright/Chrome testing, logs, and focused validation commands. To package the desktop app with hosted sign-in or your own OpenRouter key, see the desktop build instructions.
arena-backend/packages/opencodeβ local Arena engine compiled into desktop.arena-backend/packages/arena-serviceβ battle routes (model draw, model proxy, comparison) shared with the hosted service.packages/desktopβ Electron shell, daemon supervision, and packaging.packages/appβ shared renderer; browser execution is a development/QA surface.packages/serverβ local daemon, WebSocket API, and agent lifecycle.packages/protocolandpackages/clientβ local wire protocol and client SDK.packages/cliβ local daemon CLI bundled with desktop.packages/relayβ inherited optional remote-access transport.
npm run dev:desktop -- --byok # Complete local desktop stack on your OpenRouter key
npm run dev # Local daemon only
npm run dev:app # Browser-based development/QA renderer
npm run build:server # Build daemon and shared packages
npm run typecheck
npm run lint
npm run format
See CONTRIBUTING.md. Questions and help: SUPPORT.md. Security: SECURITY.md. Everyone taking part follows the Code of Conduct.
Agent Duel is a fork of Paseo, which provides the desktop app, local daemon, and agent integrations. Its bundled battle engine is built on a vendored fork of OpenCode.
Agent Duel adds blinded coding-agent battles, side-by-side comparison, and voting that carries the selected result into your chat and repository.
- The combined application is AGPL-3.0-or-later. See LICENSE .
- New original contributions are Apache-2.0. See LICENSE-APACHE and thecontribution licensing policy .
- Inherited OpenCode material in
arena-backend/retains its MIT license and notices. Seearena-backend/LICENSE . - Existing and third-party material retains its applicable licenses.
We plan to move the application to Apache-2.0 after rebasing onto Apache-licensed Paseo and clearing any remaining AGPL-only material.
NOTICE has the full licensing and attribution details. The hosted Agent Duel service is not part of this repository.