@belweave/trifecta
v0.0.38-alpha.1
Published
Trifecta server — orchestrate AI coding agents (Codex, Claude Code, OpenCode, Gemini, Cursor, and more) behind one interface, paired with the Trifecta desktop, web, iOS, and Android clients.
Maintainers
Readme
@belweave/trifecta
The Trifecta server — a Node.js process that orchestrates AI coding agents behind a single WebSocket interface, serves the Trifecta web UI, and pairs with the companion desktop, iOS, and Android clients over the same protocol.
It wraps nine coding agents (Codex, Claude Code, OpenCode, Gemini, Antigravity, Cursor, Hermes, Devin, and any ACP-compatible agent) so every client speaks to them the same way.
Run without installing
npx @belweave/trifecta
# or
bunx @belweave/trifectaThis starts the server and opens the web UI. Run npx @belweave/trifecta --help to see all flags and subcommands (start, serve, auth, project).
[!IMPORTANT] Trifecta drives agents you already have installed. Set up and authenticate at least one agent before pairing a client.
| Agent | Connection | Install / sign in |
| ---------------- | ---------------- | ----------------------------------------------------------------------------------------- |
| Codex | JSON-RPC (stdio) | Codex CLI · codex login |
| Claude Code | JSON-RPC (stdio) | Claude Code · claude auth login |
| OpenCode | JSON-RPC (stdio) | OpenCode · opencode auth login |
| Gemini | Headless CLI | Gemini CLI · npm i -g @google/gemini-cli |
| Antigravity | Python SDK / CLI | Google Antigravity · google-antigravity SDK or the agy CLI |
| Cursor | ACP (stdio) | Cursor · bundled cursor-agent (Early Access) |
| Hermes | ACP (stdio) | Hermes Agent · hermes setup |
| Devin | ACP (stdio) | Devin · devin acp |
| ACP Registry | ACP (stdio) | Any ACP-compatible agent (configurable command + args) |
Requirements
- Node.js ≥ 22.16 (also runs on 23.11+ and 24.10+), or Bun ≥ 1.3.
- On install, the native
node-ptydependency is built for your platform.
Prefer a desktop app?
Grab a signed build from GitHub Releases, or:
brew install --cask belweave-code # macOS
winget install Belweave.T3Code # Windows
yay -S belweave-bin # Arch Linux (AUR)Documentation
Full docs, architecture, self-hosting, and remote-access guides live in the monorepo README.
License
MIT © Belweave
We're very early — expect bugs. Need help? Join the Discord.
