# Show HN: CodeRelay – Let your coding agent delegate work to a teammate's agen

> Source: <https://github.com/AymanAhsan/CodeRelay>
> Published: 2026-11-14 16:56:39+00:00

**Hand off work between your teammates' coding agents, with contracts pinned to Git commits.**

[Website](https://site-olive-two-79.vercel.app/) · [Download](https://github.com/AymanAhsan/CodeRelay/releases/tag/main-latest) · [Quick start](#quick-start) · [Team hub guide](https://github.com/AymanAhsan/CodeRelay/blob/main/docs/user/team-hub.md)

<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](https://github.com/AymanAhsan/CodeRelay/blob/main/docs/assets/team-handoff.webm).</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](https://github.com/AymanAhsan/CodeRelay/releases/tag/main-latest).

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.

1. Set each teammate's owned paths under **Your areas** in the Team hub panel.
2. 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.
3. In Bob's session, review the contract and accept the task to start his agent thread.
4. 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](https://github.com/AymanAhsan/CodeRelay/blob/main/docs/operations/team-hub.md#local-development-with-alice-and-bob) for options, the [Team hub guide](https://github.com/AymanAhsan/CodeRelay/blob/main/docs/user/team-hub.md) for contract review and trusted automatic tasks, or [self-host a hub](https://github.com/AymanAhsan/CodeRelay/blob/main/docs/operations/team-hub.md) to connect real teammates. For a single session, run `vp run dev`; see the [development guide](https://github.com/AymanAhsan/CodeRelay/blob/main/docs/operations/development.md).

A hub is required for real teammates to see each other and hand off tasks. Follow [Self-host a team hub](https://github.com/AymanAhsan/CodeRelay/blob/main/docs/operations/team-hub.md) to run one and share its address.

CodeRelay is built on [T3 Code](https://github.com/pingdotgg/t3code), 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](https://github.com/AymanAhsan/CodeRelay/blob/main/LICENSE). See [NOTICE.md](https://github.com/AymanAhsan/CodeRelay/blob/main/NOTICE.md) for attribution.