triumvirate

# Triumvirate

[![Rust CI](https://github.com/michaeljboscia/triumvirate/actions/workflows/rust.yml/badge.svg)](https://github.com/michaeljboscia/triumvirate/actions)
[![Version](https://img.shields.io/github/v/release/michaeljboscia/triumvirate)](https://github.com/michaeljboscia/triumvirate/releases)
[![License: FSL-1.1-ALv2](https://img.shields.io/badge/License-FSL--1.1--ALv2-blue.svg)](LICENSE)

**Three AI models. One daemon. A methodology for building software with all of them at once.**

Gemini, Gemini, and Codex — each with different strengths — working on the same codebase, coordinated by a single Rust daemon, visible in real-time from inside your editor.

## Quick Start

```bash
git clone https://github.com/michaeljboscia/triumvirate
cd triumvirate/daemon
cargo build --release && cargo run --release
```

That's it. One binary. No Docker. No NATS. No cloud services. Register it in Claude Code:

```bash
# Add to ~/.gemini.json under mcpServers:
"triumvirate": { "command": "/path/to/triumvirate", "args": ["mcp"] }
```

Then from any Gemini session: `spawn a Gemini session called 'research'`

> **Requirements:** Rust 1.82+ and at least one agent CLI ([Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Codex CLI](https://github.com/openai/codex)). Works with 1, 2, or all 3.

---

## The Problem

You're using Gemini to write code. You want Gemini to research something. You want Codex to implement a plan in parallel. So you open three terminal windows, copy-paste context between them, lose track of which one is doing what, and eventually something goes sideways because nobody can see what anyone else is doing.

Triumvirate replaces the terminal windows.

---

## What It Does Today

**The daemon** — a Rust MCP server that spawns and manages persistent agent sessions:

```
You:     "spawn a Gemini session called 'research'"
Gemini:  → spawn_session(agent: "gemini", session_name: "research")