docs/user/install.md
Install T3 Code
T3 Code is a web and desktop GUI for running coding agents on your machine.
Requirements
Node.js ^22.16 || ^23.11 || >=24.10 on the machine that runs the T3 Code server.
At least one provider CLI, installed and authenticated. See Providers below.
Run Without Installing
| 1 | npx t3@latest |
This starts the T3 Code server on your machine and opens the local web app. Use
npx t3@latest --help for the full CLI reference.
Desktop App
Download the latest release from GitHub Releases, or install from a package registry.
Windows:
| 1 | winget install T3Tools.T3Code |
macOS:
| 1 | brew install --cask t3-code |
Arch Linux:
Stable:
| 1 | yay -S t3code-bin |
Nightly:
| 1 | yay -S t3code-nightly-bin |
Providers
T3 Code drives provider CLIs; it does not ship them. Install the CLI for each provider you want to use, then authenticate it.
| Provider | CLI | Default binary | Log in with |
|---|---|---|---|
| Codex | Codex CLI | codex | codex login |
| Claude | Claude Code | claude | claude auth login |
| Cursor | Cursor CLI | cursor-agent | agent login |
| Grok Build | Grok Build CLI | grok | grok login |
| OpenCode | OpenCode | opencode | opencode auth login |
Cursor is the one to watch: install Cursor CLI, which provides the cursor-agent binary that
T3 Code looks for, but authenticate with agent login, not cursor-agent login.
Run the login command on the machine running the T3 Code server, not on the device you browse from.
Binary Discovery
Each provider CLI must be on the server's PATH, or have an explicit binary path set in
Settings → the provider instance → Binary path. Use the explicit path when a version
manager or a non-standard install location keeps the CLI off the PATH of the shell that
started T3 Code.
When Auth Is Needed
Provider auth is required before you start a session with that provider, not before you start T3 Code. You can install T3 Code, open it, and add providers afterwards. A provider that is not authenticated shows its status in Settings and fails at session start with the login command to run.
For multi-account setups, see Codex and Claude.
Next Steps
- Permission modes: how much T3 Code asks before acting
- Remote access: connect from a phone, tablet, or another desktop
- Keeping T3 Code in sync: client and server version skew
- Running in the background: Linux background service