@devries-cameron20 / t3code-1 / commits / 26e769d6c4
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

docs: the README now shows the app and gets you installed fast (#35170)

Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>

Theo Browne committed Nov 12, 2026 at 03:03 UTC 26e769d6c4fd955429595828ac572efeca006168
4 files changed +83 -115
.github/readme/hero.webp
Binary files /dev/null and b/.github/readme/hero.webp differ
README.md
+67 -112
@@ -1,153 +1,108 @@
1 -# T3 Code
1 +<p align="center">
2 + <a href="https://t3.codes">
3 + <img src="./assets/prod/t3-black-web-icon-192x192.png" width="80" height="80" alt="T3 Code logo" />
4 + </a>
5 +</p>
6
3 -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](https://apps.apple.com/us/app/t3-code-remote-claude-more/id6787819824), [Android](https://play.google.com/store/apps/details?id=com.t3tools.t3code)), [web app](https://app.t3.codes) and [Electron-based desktop app](https://t3.codes).
7 +<h1 align="center">T3 Code</h1>
8
5 -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.
9 +<p align="center">The open-source control plane for coding agents.</p>
10
7 -## "Wait, what are you selling me?"
8 -
9 -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.
11 +<p align="center">
12 + <a href="https://t3.codes/download"><strong>Download</strong></a> ·
13 + <a href="https://apps.apple.com/us/app/t3-code-remote-claude-more/id6787819824">iOS</a> ·
14 + <a href="https://play.google.com/store/apps/details?id=com.t3tools.t3code">Android</a> ·
15 + <a href="https://app.t3.codes">Web</a> ·
16 + <a href="./docs/README.md">Docs</a> ·
17 + <a href="https://discord.gg/jn4EGJjrvv">Discord</a>
18 +</p>
19
11 -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.
20 +<p align="center">
21 + <a href="https://t3.codes">
22 + <img src="./.github/readme/hero.webp" width="100%" alt="T3 Code on desktop with a finished Claude thread, next to the phone app asking to approve a command from Codex" />
23 + </a>
24 +</p>
25
13 -## Installation
26 +T3 Code runs the coding agents on your machine and gives them one fast interface. Start a thread at your desk, then approve the next step from your phone.
27
15 -> [!WARNING]
16 -> T3 Code currently supports Codex, Claude, Cursor, Grok Build, OpenCode, Antigravity, and fx. Install and authenticate at least one provider before use:
17 ->
18 -> - Codex: install [Codex CLI](https://developers.openai.com/codex/cli) and run `codex login`
19 -> - Claude: install [Claude Code](https://claude.com/product/claude-code) and run `claude auth login`
20 -> - Cursor: install [Cursor CLI](https://cursor.com/cli) and run `agent login`
21 -> - Grok Build: install [Grok Build CLI](https://x.ai/cli) and run `grok login`
22 -> - OpenCode: install [OpenCode](https://opencode.ai) and run `opencode auth login`
23 -> - Antigravity: enable it in Settings, then use **Install Antigravity** and **Sign in with Google**. No CLI is required.
24 -> - fx: install [fx](https://fx.sh) and run `fx login` on the machine running the T3 Code server ([setup guide](./docs/user/providers-fx.md))
28 +It works with Claude Code, Codex, Cursor, OpenCode, Grok Build, Antigravity, Kiro, Pi, Muse Code, fx, and any [ACP](./docs/user/providers-acp.md) agent. If an agent is set up on your computer, T3 Code can control it.
29
26 -### Command line
30 +## What you get
31
28 -```bash
29 -curl -fsSL https://t3.codes/install.sh | sh
30 -```
32 +- **Your subscriptions.** T3 Code does not resell tokens. It drives the agents you are already signed in to.
33 +- **Every agent in one place.** Change models in the middle of a thread. Let Claude hand a task to Codex.
34 +- **Desktop, web, and phone.** One server, and every client shows the same threads. There are apps for iOS and Android.
35 +- **Remote ready.** Run agents on any machine. Connect over your local network, Tailscale, or [T3 Connect](./docs/user/remote-access.md).
36 +- **Git built in.** Each thread can work in its own worktree. Review the diff, then commit, push, and open a pull request with one button.
37 +- **Fast.** Performance is a feature here. We measure it, and we treat a dropped frame as a bug.
38 +- **Open.** MIT licensed. If you don't like something, fork it.
39
32 -On Windows, in PowerShell:
33 -
34 -```powershell
35 -irm https://t3.codes/install.ps1 | iex
36 -```
37 -
38 -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.
39 -
40 -To try it once without installing, run `npx t3@latest`. It offers to install the `t3` command for you.
40 +## Install
41
42 ### Desktop app
43
44 -Install the latest version of the desktop app from [GitHub Releases](https://github.com/pingdotgg/t3code/releases), or from your favorite package registry:
44 +[Download T3 Code](https://t3.codes/download) for macOS, Windows, or Linux. You can also use a package manager:
45
46 -#### Windows (`winget`)
46 +| Platform | Command |
47 +| -------------- | -------------------------------------------------------------------- |
48 +| macOS | `brew install --cask t3-code` |
49 +| Windows | `winget install T3Tools.T3Code` or `scoop install extras/t3code` |
50 +| Arch Linux | `yay -S t3code-bin` |
51 +| Nix | `nix profile add github:NixOS/nixpkgs/nixos-unstable#t3code` |
52 +| Debian, Ubuntu | `.deb` from [Releases](https://github.com/pingdotgg/t3code/releases) |
53
48 -```bash
49 -winget install T3Tools.T3Code
50 -```
51 -
52 -#### Windows (`scoop`)
53 -
54 -```bash
55 -scoop install extras/t3code
56 -```
57 -
58 -#### macOS (Homebrew)
59 -
60 -```bash
61 -brew install --cask t3-code
62 -```
63 -
64 -#### Debian, Ubuntu (`.deb`)
54 +### Command line
55
66 -Download the `.deb` from [GitHub Releases](https://github.com/pingdotgg/t3code/releases), then:
56 +This installs the `t3` command. Run `t3` to start the server and open the web app.
57
58 ```bash
69 -sudo apt install ./T3-Code-*.deb
59 +curl -fsSL https://t3.codes/install.sh | sh
60 ```
61
72 -#### Arch Linux (AUR)
73 -
74 -Stable:
62 +On Windows, in PowerShell:
63
76 -```bash
77 -yay -S t3code-bin
64 +```powershell
65 +irm https://t3.codes/install.ps1 | iex
66 ```
67
80 -Nightly:
68 +To try it once without an install, run `npx t3@latest`.
69
82 -```bash
83 -yay -S t3code-nightly-bin
84 -```
70 +### Phone
71
86 -The AUR packaging is maintained in this repository under [`packaging/aur`](./packaging/aur).
72 +Get the app from the [App Store](https://apps.apple.com/us/app/t3-code-remote-claude-more/id6787819824) or [Google Play](https://play.google.com/store/apps/details?id=com.t3tools.t3code). Then follow [remote access](./docs/user/remote-access.md) to connect it to your computer.
73
88 -#### Nix (nixpkgs)
74 +### Sign in to an agent
75
90 -```bash
91 -nix profile add github:NixOS/nixpkgs/nixos-unstable#t3code
92 -```
76 +T3 Code needs one agent that is installed and signed in. For example, install [Claude Code](https://claude.com/product/claude-code) and run `claude auth login`, or install [Codex CLI](https://developers.openai.com/codex/cli) and run `codex login`.
77
94 -The package is maintained in [nixpkgs](https://github.com/NixOS/nixpkgs/tree/nixos-unstable/pkgs/by-name/t3/t3code)
95 -and includes the desktop app (`t3code-desktop`) and the `t3` command.
96 -See [Nix installation](./docs/user/install.md#nix-nixpkgs) for NixOS configuration and updates.
78 +[Provider setup](./docs/user/install.md#providers) has the steps for each agent. [Install T3 Code](./docs/user/install.md) covers nightly builds, AppImage, WSL, and NixOS.
79
98 -## Some notes
80 +## "Wait, what are you selling me?"
81
100 -We are very very early in this project. Expect bugs.
82 +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.
83
102 -We are (mostly) not accepting contributions yet. Small fixes may be considered. Big features will not be.
84 +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 tool that you want.
85
86 ## Documentation
87
106 -Full docs live in [docs/](./docs). There's no docs site yet.
107 -
108 -- [FAQ](./docs/user/faq.md)
88 - [Install and first run](./docs/user/install.md)
110 -- [Permission modes](./docs/user/permission-modes.md)
111 -- [Keyboard shortcuts](./docs/user/keybindings.md)
112 -- [Project settings](./docs/user/project-settings.md)
113 -- [Appearance preferences](./docs/user/appearance.md)
89 - [Remote access from a phone or another machine](./docs/user/remote-access.md)
115 -- [Connect Claude Code, Codex, ChatGPT and other agents over MCP](./docs/user/outside-agents.md)
116 -- [Keeping app and server in sync](./docs/user/updating.md)
117 -- [Source control integrations](./docs/user/source-control.md)
118 -- Multiple accounts: [Codex](./docs/user/providers-codex.md) · [Claude](./docs/user/providers-claude.md)
119 -- [Run T3 Code as a background service](./docs/user/background-service.md)
120 -
121 -Building from source? Start at [docs/internals/overview.md](./docs/internals/overview.md).
122 -
123 -## If you REALLY want to contribute still.... read this first
124 -
125 -### Install `vp`
126 -
127 -T3 Code uses Vite+ so you'll need to install the global `vp` command-line tool.
128 -
129 -#### macOS / Linux
130 -
131 -```bash
132 -curl -fsSL https://vite.plus | bash
133 -```
134 -
135 -#### Windows
136 -
137 -```bash
138 -irm https://vite.plus/ps1 | iex
139 -```
90 +- [Permission modes](./docs/user/permission-modes.md)
91 +- [Source control](./docs/user/source-control.md)
92 +- [Connect outside agents over MCP](./docs/user/outside-agents.md)
93 +- [FAQ](./docs/user/faq.md)
94
141 -Checkout their getting started guide for more information: https://viteplus.dev/guide/
95 +[All docs](./docs/README.md) has the full list.
96
143 -### Install dependencies
97 +## Contributing
98
145 -```bash
146 -vp i
147 -```
99 +We have limited review capacity. Small, focused fixes are the most likely to be merged. Features need an approved discussion first.
100
149 -Read [CONTRIBUTING.md](./CONTRIBUTING.md) before reporting a bug or opening a PR.
101 +- Read [CONTRIBUTING.md](./CONTRIBUTING.md) before you report a bug or open a pull request.
102 +- Put feature requests in [Ideas](https://github.com/pingdotgg/t3code/discussions/categories/ideas).
103 +- Build from source with the [development runbook](./docs/operations/development.md#first-checkout). The [architecture overview](./docs/internals/overview.md) explains how it works.
104 +- Get help in [Discord](https://discord.gg/jn4EGJjrvv).
105
151 -Have a feature request? Start an [Ideas discussion](https://github.com/pingdotgg/t3code/discussions/categories/ideas).
106 +## License
107
153 -Need support? Join the [Discord](https://discord.gg/jn4EGJjrvv).
108 +[MIT](./LICENSE)
docs/operations/development.md
+14 -2
@@ -2,8 +2,20 @@
2
3 ## First checkout
4
5 -Install `vp` using the [root README](../../README.md#install-vp). It provides the Node version
6 -pinned in `package.json` (Node 26), so no separate Node install is needed. From the repository root:
5 +T3 Code uses [Vite+](https://viteplus.dev/guide/). Install its global `vp` command:
6 +
7 +```sh
8 +curl -fsSL https://vite.plus | bash
9 +```
10 +
11 +On Windows, in PowerShell:
12 +
13 +```powershell
14 +irm https://vite.plus/ps1 | iex
15 +```
16 +
17 +`vp` provides the Node version pinned in `package.json` (Node 26), so no separate Node install is
18 +needed. From the repository root:
19
20 ```sh
21 vp i
docs/user/install.md
+2 -1
@@ -57,7 +57,7 @@ the nightly train, run your installed `t3` (for example `t3 connect`), not
57
58 There is no `t3` executable for Intel Macs (the desktop app is available). To
59 run a server there, build it from source with `vp`, which provides the Node version it needs
60 -([Install vp](https://github.com/pingdotgg/t3code#install-vp)):
60 +([Install vp](../operations/development.md#first-checkout)):
61
62 ```bash
63 git clone https://github.com/pingdotgg/t3code
@@ -76,6 +76,7 @@ or use a package manager:
76 | Platform | Install |
77 | ------------------ | ------------------------------------------------------------ |
78 | Windows | `winget install T3Tools.T3Code` |
79 +| Windows (Scoop) | `scoop install extras/t3code` |
80 | macOS | `brew install --cask t3-code` |
81 | Debian, Ubuntu | `sudo apt install ./T3-Code-*.deb` |
82 | Arch Linux | `yay -S t3code-bin` |