T3 Code — Install & Run on Mac, Windows & Linux (t3.codes)

What it is

A control plane for coding agents

T3 Code is a single interface that drives the coding agents already installed on your machine. Instead of one terminal tab per tool, you get one surface that can run Claude Code, Codex, Cursor, Grok Build, OpenCode, Google Antigravity, and fx — side by side, in the same workspace.

The site is t3.codes; the code lives at github.com/pingdotgg/t3code. It is open source under the MIT license, made by Theo and the ping.gg team, and it ships as a desktop app (Electron), a web app you run locally, and mobile apps for iOS and Android.

What you actually get

Bring your own subscription. T3 Code does not resell tokens or put a quota on top of you — it drives the CLIs you already authenticate with, so you pay only your existing Claude / Codex / Cursor plans.
Multi-agent threads. Run more than one agent in a single thread — e.g. a Claude thread with a Codex subagent — and compare their work.
Switch models mid-thread. Change the model partway through a conversation without starting over.
Branch-per-thread git. Each agent thread writes to its own branch. One button commits, pushes, and opens a GitHub PR with a generated title, body, and changelog. Inline diff review, plus draft, stacked, and amended PRs.
Reach it from anywhere. iOS and Android apps, and the ability to connect to a remote machine, so the agent runs on your workstation while you steer from the couch or the road.
Forkable. MIT-licensed — change the UI, add an agent, or self-host.

Honest caveat: the project README says T3 Code is very early — expect bugs. Treat it as a fast-moving tool, not a settled one, and check t3.codes for the current commands before you rely on them.

Step 0

Before you install: connect a provider

T3 Code is the cockpit, not the engine. It needs at least one agent CLI installed and signed in first. On a Claude-first setup that means installing Claude Code and authenticating:

# install Claude Code, then sign in
claude auth login

Any of these providers work — set up whichever you already pay for:

Provider	Set up
Claude	Install Claude Code, then `claude auth login`
Codex	Install the Codex CLI, then `codex login`
Cursor	Install the Cursor CLI, then `agent login`
Grok Build	Install the Grok Build CLI, then `grok login`
OpenCode	Install OpenCode, then `opencode auth login`
Antigravity	No CLI — enable in Settings, Install Antigravity, Sign in with Google
fx	Install fx, then `fx login` on the machine running the T3 Code server

PATH note: the provider CLI has to be on the PATH of whatever machine runs the T3 Code server. If T3 Code can't find it, set its Binary path in provider settings.

Install

By platform — Mac, terminal, Windows, Linux

There are two ways to install: the command-line tool (t3, which runs the server and opens the local web app) or the desktop app. Pick whichever suits the box.

macOS Mac

Command line — one script, binary lands in ~/.local/bin:

curl -fsSL https://t3.codes/install.sh | sh

Or the desktop app via Homebrew:

brew install --cask t3-code

Intel Macs: there is no t3 CLI binary for Intel Macs — use the desktop app on those. Apple-Silicon Macs get both.

Terminal / Linux The shell way

Same one-line installer as the Mac — works on Linux too:

curl -fsSL https://t3.codes/install.sh | sh

Prefer a packaged desktop build?

# Debian / Ubuntu — download the .deb from GitHub Releases, then:
sudo apt install ./T3-Code-*.deb

# Arch (AUR)
yay -S t3code-bin          # stable
yay -S t3code-nightly-bin  # nightly

# Nix — includes the desktop app and the t3 command
nix profile add github:NixOS/nixpkgs/nixos-unstable#t3code

The installer drops t3 into ~/.local/bin; make sure that is on your PATH so the command resolves.

Windows PowerShell

Command line — run this in PowerShell:

irm https://t3.codes/install.ps1 | iex

Or the desktop app through a package manager:

winget install T3Tools.T3Code
# or
scoop install extras/t3code

Windows limit: the background service (t3 service install) is not supported on Windows — it's Linux and macOS only. On Windows you start T3 Code by running it when you need it.

No install Just try it

If you have Node.js, run it straight from npm — it even offers to install the t3 command for you:

npx t3@latest

You can also grab any desktop build directly from GitHub Releases.

Run it

Starting and keeping it running

Once the t3 command is installed, the whole surface is a few words:

t3                  # start the server and open the local web app
t3 service install  # keep T3 Code running in the background (Linux/macOS)
t3 update           # move to a newer release
t3 --help           # the full command reference

Plain t3 boots the local server and opens the web app in your browser; the development server listens on http://localhost:4001. From there you add your providers, open a workspace, and start threads.

From the couch

Driving it from your phone

This is where T3 Code earns its keep for a lot of people: install the iOS or Android app, connect to the machine running the server, and you can steer a long Claude Code run from your phone — the agent still does its work on your real workstation.

If running agents from any device is what you're after more broadly, see our companion guide, Using Claude on Any Device — it covers Claude's own native paths (Remote Control, Claude Code on the web, Dispatch) alongside tools like this one.

The best agent tool is the one you can reach when the idea strikes — desk, terminal, or phone.