t3code README

The project's README from github.com/pingdotgg/t3code. As one markdown file: 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, and Google Antigravity. 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, 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.

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.

t3code (pingdotgg/t3code)

Searching Database…

28.2K ·GitHub
What is this?T3 Code is an 'agent harness control surface': mobile apps for iOS and Android, a web app, and an Electron desktop app for controlling AI coding agents running on your own machine.
Is this a desktop app, a web app, or a phone app?All three — an Electron desktop app for Windows, macOS and Linux, native iOS and Android apps, and a web UI. They are all frontends to a T3 Code server running on the machine where your agents live.
How do I get it running?Fastest way: run npx t3@latest in a terminal (needs Node.js 22.16+, 23.11+, or 24.10+) — it starts the backend plus a local web app. Otherwise install the desktop app from GitHub Releases, winget, Homebrew, or the AUR.
Which coding agents can it control, and do I need them ready first?It works with your existing subscriptions on Claude Code, Codex, Cursor, Grok Build, OpenCode, and Google Antigravity — and yes, at least one provider must already be installed and authenticated on your machine before T3 Code is useful.
Is it stable enough to rely on day to day?Not yet — the team says the project is very early and to expect bugs. They are also mostly not accepting contributions right now: small fixes may land, big features will not.
Is T3 Code a paid product, or open source?Free and open source under MIT. The README answers 'what are you selling me?' with 'nothing', and the team wants you to be able to fork and build the editor you want if they ever go the wrong direction.
Why build this instead of using the Codex desktop app or Cursor?The authors tried existing solutions like the Codex desktop app, Conductor, Claude Desktop and Cursor Glass, but none met their bar. They wanted something performant, remote-ready, and truly open — open enough that you can fork it and build the editor you want.
Can I run several accounts of the same agent?Yes — the docs include a multiple-accounts guide covering Codex and Claude specifically, alongside permission modes, source control integrations, and keyboard shortcuts.
Does it keep working if I close the terminal?Yes — there is a documented way to run T3 Code as a background service, so the server that reaches your agents stays up without a terminal window open.
What are similar projects?hapi, vicoa, happy, paseo, orca, zeron, munder-difflin, visual-explainer
Creator
pingdotgg
Size
507.1 MB
Stars
28.2K
Age
8mo
Commits · 90 Days