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
7<h1 align="center">T3 Code</h1>
8
9<p align="center">The open-source control plane for coding agents.</p>
10
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
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
26T3 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
28It 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
30## What you get
31
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
40## Install
41
42### Desktop app
43
44[Download T3 Code](https://t3.codes/download) for macOS, Windows, or Linux. You can also use a package manager:
45
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
54### Command line
55
56This installs the `t3` command. Run `t3` to start the server and open the web app.
57
59curl -fsSL https://t3.codes/install.sh | sh
61
62On Windows, in PowerShell:
63
65irm https://t3.codes/install.ps1 | iex
67
68To try it once without an install, run `npx t3@latest`.
69
70### Phone
71
72Get 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
74### Sign in to an agent
75
76T3 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
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
80## "Wait, what are you selling me?"
81
82Nothing. 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
84We 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
88[Install and first run](./docs/user/install.md)
89[Remote access from a phone or another machine](./docs/user/remote-access.md)
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
95[All docs](./docs/README.md) has the full list.
96
97## Contributing
98
99We have limited review capacity. Small, focused fixes are the most likely to be merged. Features need an approved discussion first.
100
101Read [CONTRIBUTING.md](./CONTRIBUTING.md) before you report a bug or open a pull request.
102Put feature requests in [Ideas](https://github.com/pingdotgg/t3code/discussions/categories/ideas).
103Build from source with the [development runbook](./docs/operations/development.md#first-checkout). The [architecture overview](./docs/internals/overview.md) explains how it works.
104Get help in [Discord](https://discord.gg/jn4EGJjrvv).
105
106## License
107
108[MIT](./LICENSE)