About this fork

This fork and the FirstMate fork ship together as one bundle: use both.

A fork of pingdotgg/t3code, built to host the FirstMate fork and its crew.

For FirstMate:

• Crew sidebar: FirstMate and its workers as a tree, with short status labels.
• No worker composer: a worker thread has no message box, only Stop while it runs and the box back while it asks you something.
• Approvals over MCP: FirstMate answers a worker's permission prompts.
• Waits end on a question: FirstMate hears a question or approval the moment it appears.
• Per-thread settings: each launched worker gets its own environment and instructions.
• Idle agents: idle release is a setting, and agents can be kept for good.
• Mark read: FirstMate clears a worker's Done card without opening the app.
• Long sign-in: FirstMate's sign-in lasts 10 years instead of 30 days, so it never needs renewing.
• Bridge: FirstMate's objectives, then each call it needs from you, in the right panel's Bridge tab.
• Rules in the Bridge: every standing rule for FirstMate, approved or with its recommendation; one click agrees.
• Clean session close: a closed Claude session waits for its CLI to exit, so FirstMate's next one keeps its lock.

Also:

• Its own app: T3 Code (Fork) runs beside the official one.
• Telemetry off: nothing is sent unless you opt in.
• Board: a tab to sketch on screenshots and attach them to the chat.
• Twelve months of usage: longer periods, drawn as stacked bars.
• Muted usage rows: click a provider on the Usage page to mute it.
• Usage in the sidebar: one bar per account shows what is left this week.
• Archived usage: counts machines that no longer run T3.
• Upstream release note: the sidebar says when upstream ships a release.
• App-bundled CLIs: a CLI inside a macOS app is left for that app to update.
• ~ in provider paths: works for every provider.
• Stopped turns: their approvals close instead of staying pending.
• Two-line cards: a lone PR badge no longer adds a third line.
• Thread details hidden: new threads open without the details card; a setting shows it.
• Window grows for the panel: opening the right panel widens the desktop window, so the chat keeps its width.
• Message origin: each user message records which client sent it.

Details and pictures: fork/README.md.

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, Google Antigravity, and fx. If they're set up on your computer, T3 Code can control them.

"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, Antigravity, and fx. 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.
• fx: install fx and run fx login on the machine running the T3 Code server (setup guide)

Command line

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

On Windows, in PowerShell:

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

Then run t3 to start the server and open the local web app. t3 service install keeps it running in the background, t3 update moves to a newer release, and t3 --help has the full reference.

To try it once without installing, run npx t3@latest. It offers to install the t3 command for you.

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

Windows (scoop)

scoop install extras/t3code

macOS (Homebrew)

brew install --cask t3-code

Debian, Ubuntu (.deb)

Download the .deb from GitHub Releases, then:

sudo apt install ./T3-Code-*.deb

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.

Nix (nixpkgs)

nix profile add github:NixOS/nixpkgs/nixos-unstable#t3code

The package is maintained in nixpkgs and includes the desktop app (t3code-desktop) and the t3 command. See Nix installation for NixOS configuration and updates.

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.

• FAQ
• Install and first run
• Permission modes
• Keyboard shortcuts
• Project settings
• Appearance preferences
• Remote access from a phone or another machine
• Connect Claude Code, Codex, ChatGPT and other agents over MCP
• 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.