T3 Code

T3 Code is an "agent harness control surface". It enables control of the agents on your machine with a best-in-class mobile app (iOS, Android), web app and Electron-based desktop app.

Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, OpenCode, and Google Antigravity. If they're set up on your computer, T3 Code can control them.

About this fork

This fork adds native cross-provider dispatch: a Claude or Codex thread can delegate work to another configured Claude or Codex instance, using that instance's own subscription or API-key configuration. OpenRouter-backed instances can participate through those same supported harnesses. Children use T3 Code's existing thread lifecycle and appear under Agents → Direct Spawns, with live status, token counts, tool counts, and reasoning effort.

Dispatch runs inside T3 Code through the existing Claude Agent SDK and Codex app-server integrations. It requires no CLI proxy or separate dispatch service. The fork also retains the upstream snapshot's remote environments and machine load balancing.

Start with cross-provider agents for setup, OpenRouter, and a dispatch diagram. To build this fork with official T3 Connect enabled, follow the source-build steps below. The upstream downloads and npx t3@latest instructions on this page install upstream T3 Code, not this fork.

Build this fork with T3 Connect

Use Node 24.13.1 or later within Node 24 and install vp as described below. From a fresh checkout of this fork:

cp .env.example .env
vp i
T3CODE_DESKTOP_SKIP_BUILD=false vp run dist:desktop:dmg:arm64

The existing .env.example supplies the official public Clerk publishable key, JWT template, CLI OAuth client ID, and relay URL. The local .env is ignored by Git. If you already have one, merge those four values rather than replacing unrelated settings. Process variables override .env.local, which overrides .env.

Set this configuration before compilation. Without it, a source build hides T3 Connect and its sign-in entry. Rebuild after adding it; repackaging old output with --skip-build will keep Connect disabled. No private Clerk key or relay deployment credentials are needed.

The command produces the macOS arm64 installer under release/. For other desktop targets, use the native build options. See T3 Connect setup for the full configuration reference.

"Wait, what are you selling me?"

Nothing. We built T3 Code because we wanted the best possible development experience with agents. We were inspired by existing solutions like the Codex desktop app, Conductor, Claude Desktop and Cursor Glass, but none met our bar.

We wanted something performant, remote-ready, and truly open. If we ever go the wrong direction, we want you to have everything you need to fork and build the editor that you want.

Installation

Warning

T3 Code currently supports Codex, Claude, Cursor, Grok Build, OpenCode, and Antigravity. Install and authenticate at least one provider before use:

• Codex: install Codex CLI and run codex login
• Claude: install Claude Code and run claude auth login
• Cursor: install Cursor CLI and run agent login
• Grok Build: install Grok Build CLI and run grok login
• OpenCode: install OpenCode and run opencode auth login
• Antigravity: enable it in Settings, then use Install Antigravity and Sign in with Google. No CLI is required.

Try it out (install-free)

The easiest way to test T3 Code is to run the server in your terminal (requires Node.js 22.16+, 23.11+, or 24.10+):

npx t3@latest

This will launch T3 Code's backend on your machine as well as the local web app to control your agents.

Tip: Use npx t3@latest --help for the full CLI reference.

Desktop app

Install the latest version of the desktop app from GitHub Releases, or from your favorite package registry:

Windows (winget)

winget install T3Tools.T3Code

macOS (Homebrew)

brew install --cask t3-code

Arch Linux (AUR)

Stable:

yay -S t3code-bin

Nightly:

yay -S t3code-nightly-bin

The AUR packaging is maintained in this repository under packaging/aur.

Some notes

We are very very early in this project. Expect bugs.

We are (mostly) not accepting contributions yet. Small fixes may be considered. Big features will not be.

Documentation

Full docs live in docs/. There's no docs site yet.

• Install and first run
• Permission modes
• Keyboard shortcuts
• Project settings
• Remote access from a phone or another machine
• Keeping app and server in sync
• Source control integrations
• Multiple accounts: Codex · Claude
• Run T3 Code as a background service

Building from source? Start at docs/internals/overview.md.

If you REALLY want to contribute still.... read this first

Install vp

T3 Code uses Vite+ so you'll need to install the global vp command-line tool.

macOS / Linux

curl -fsSL https://vite.plus | bash

Windows

irm https://vite.plus/ps1 | iex

Checkout their getting started guide for more information: https://viteplus.dev/guide/

Install dependencies

vp i

Read CONTRIBUTING.md before reporting a bug or opening a PR.

Have a feature request? Start an Ideas discussion.

Need support? Join the Discord.