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

AymanAhsan released CodeRelay, an open-source desktop tool that lets one developer's coding agent hand off tasks to a teammate's agent, with each task carrying an API contract pinned to a Git commit. CodeRelay requires teammates to declare the repository paths they own, so a request from Alice's agent for work in Bob's area arrives as a contract Bob reviews and accepts into his own agent thread; the finished task returns a summary, branch, and commit to Alice. The tool requires a supported agent provider such as Codex or Claude Code, Node.js 24, Git, and Vite+ (vp), and its installers for macOS, Linux, and Windows are unsigned builds from the main branch.

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.