Skip to content

install.md

Latest commit

 

History

History
84 lines (57 loc) · 2.98 KB

install.md

File metadata and controls

84 lines (57 loc) · 2.98 KB
Raw

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

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:

winget install T3Tools.T3Code

macOS:

brew install --cask t3-code

Arch Linux:

yay -S t3code-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