Hand off work between your teammates' coding agents, with contracts pinned to Git commits.
Website · Download · Quick start · Team hub guide
<sub>Bob owns the frontend and Alice owns the backend. Bob's agent pushes an API contract and sends Alice a task. She accepts it into her own agent thread, and her agent returns the branch and commit. Watch the full video.</sub>
Agents on the same team step on each other's work: they edit the same files, duplicate tasks, or build against different assumptions about an API.
CodeRelay gives teammates a way to hand work between their agents. Each teammate declares the repository areas they own. When Alice's agent needs a change in Bob's area, it sends a task with a contract pinned to a Git commit. Bob reviews and accepts it into his own agent thread. Both agents work from the agreed contract, and the completed task carries a summary, branch, and commit back to Alice.
Install and authenticate a supported agent provider, such as Codex or Claude Code, before starting agent work.
These install the latest desktop app built from main. Builds are unsigned.
On macOS or Linux:
curl -fsSL https://site-olive-two-79.vercel.app/install.sh | bash
On macOS this installs CodeRelay into /Applications. On Linux it installs the AppImage with a coderelay command and an app-menu entry; AppImages need FUSE 2 (libfuse2t64 on recent Ubuntu).
On Windows, in PowerShell:
irm https://site-olive-two-79.vercel.app/install.ps1 | iex
To download an installer yourself, see the latest build.
For the local Alice and Bob demo on macOS or Linux, with Node.js 24 and Git installed, this downloads CodeRelay into ~/CodeRelay, installs Vite+ ( vp) if needed, and installs dependencies:
curl -fsSL https://site-olive-two-79.vercel.app/install.sh | bash -s -- --source
Then start the demo with cd ~/CodeRelay && vp run dev:team. Set CODERELAY_DIR to install somewhere else.
Requires Node.js 24, Git, and Vite+ (vp).
On macOS or Linux:
curl -fsSL https://vite.plus | bash
On Windows, in PowerShell:
irm https://vite.plus/ps1 | iex
git clone https://github.com/AymanAhsan/CodeRelay.git
cd CodeRelay
vp i
vp run dev:team
The launcher starts a local Team hub and separate Alice and Bob sessions, with both teammates already joined. Open each session's labeled pairing URL from the terminal. Docker is not required for this demo.
- Set each teammate's owned paths under Your areas in the Team hub panel.
- Ask Alice's agent for work that needs a change in Bob's area. Have it push a contract and suggest a task for Bob.
- In Bob's session, review the contract and accept the task to start his agent thread.
- When Bob's agent finishes and marks the task done, review its summary, branch, and commit in Alice's session, then fetch and integrate the work.
Both local sessions share the selected project's files. To try a different repository with an origin remote, run vp run dev:team --project-dir ../your-repo instead. Press Ctrl+C in the launcher terminal to stop the demo.
See the local demo guide for options, the Team hub guide for contract review and trusted automatic tasks, or self-host a hub to connect real teammates. For a single session, run vp run dev; see the development guide.
A hub is required for real teammates to see each other and hand off tasks. Follow Self-host a team hub to run one and share its address.
CodeRelay is built on T3 Code, which provides the agent GUI and web, desktop, and mobile foundations. This independently maintained repository adds the Team hub workflow for handing work between teammates' agents. The application currently retains upstream names and package identifiers; run CodeRelay from this checkout.
The original MIT license and Copyright (c) 2026 T3 Tools Inc. notice are preserved in LICENSE. See NOTICE.md for attribution.