T3 Code documentation
Every T3 Code guide in one place — installation, quickstart, runtime modes, worktrees, remote access, the CLI reference and architecture.
The full guide index. If you're new, start with the quickstart — everything else makes more sense once you have a thread running.
Getting started#
- Quickstart — provider setup,
npx t3, first thread, in about two minutes - Installation — every method compared, and what to install first
- npx t3 — zero install, and the route for servers
- Windows — winget, the
.exe, and the PATH gotcha - macOS — Homebrew cask, Apple Silicon, Gatekeeper
- Linux — AUR, AppImage, systemd
- FAQ — cost, requirements, privacy, and what it isn't
Guides#
- Runtime modes — Full Access vs Supervised, and what the boundary actually is
- Worktrees, diffs and pull requests — the git plumbing that makes parallel agents work
- Remote access —
t3 serve, Tailscale, SSH tunnels, pairing tokens - Phone and tablet access — no native app, but the browser route works
- Updates and nightly builds — whether to ride nightly or pin a version
Reference#
- CLI reference —
t3,t3 serve,t3 auth,t3 project, dev commands - Configuration and ports — 3773, 9234, binding, dev instances
- Architecture — WebSocket to Node server to provider CLI, and how to debug by layer
Providers#
- All providers — the four supported agents, compared
- Codex · Claude Code · Cursor · OpenCode
- Gemini, Ollama and others — what's supported and what isn't
Troubleshooting#
- All fixes — indexed by error message, with a layer-by-layer diagnostic
- The four most common: initialize timeout,
'codex' not found, port 3773 in use, app-server won't start
Comparisons#
- T3 Code alternatives — where it sits among agent GUIs, orchestrators and editors
- vs the Codex app · Claude Code CLI · Conductor · Cursor · Vibe Kanban
Keeping current#
- News and changelog digest — what changed in recent builds, in English
A note on scope#
This is a community reference, not the official documentation. It exists because T3 Code moves fast — nightly builds most days — and there's value in a stable place for the practical details: exact commands per platform, what actually happens on a remote box, and the error messages that send people to GitHub issues.
Every page records when it was last checked against the repository. For anything canonical, use the official docs, the repository, or the Discord.
FAQ#
Where is the official T3 Code documentation?#
The official docs are hosted at pingdotgg-t3code.mintlify.app, with additional markdown files in the docs directory of the pingdotgg/t3code GitHub repository. This site is an independent community reference.
Is there a T3 Code manual or handbook?#
There's no printed manual. The official documentation plus the repository's docs directory are the canonical sources; this site organises the practical material by task and by error message.
How do I search the T3 Code docs?#
Use the search box at the top of any page on this site, or press / to focus it. It searches page titles, descriptions and content across all guides.