The best way to control Claude Code, Codex and more from any computer or phone
Mirrored from https://github.com/Camo67/t3code.git
Synced Nov 21, 03:37 UTC
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| 56 | This installs the `t3` command. Run `t3` to start the server and open the web app. |
| 57 | |
| 58 | ```bash |
| 59 | curl -fsSL https://t3.codes/install.sh | sh |
| 60 | ``` |
| 61 | |
| 62 | On Windows, in PowerShell: |
| 63 | |
| 64 | ```powershell |
| 65 | irm https://t3.codes/install.ps1 | iex |
| 66 | ``` |
| 67 | |
| 68 | To try it once without an install, run `npx t3@latest`. |
| 69 | |
| 70 | ### Phone |
| 71 | |
| 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 | |
| 74 | ### Sign in to an agent |
| 75 | |
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| 99 | We have limited review capacity. Small, focused fixes are the most likely to be merged. Features need an approved discussion first. |
| 100 | |
| 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 | |
| 106 | ## License |
| 107 | |
| 108 | [MIT](./LICENSE) |