T3 Code is a minimal web GUI for coding agents made by Pingdotgg. This project is a downstream fork of T3 Code customised to my utility and includes various PRs/feature additions from the upstream repo. Thanks to the team and its maintainers for keeping it OSS and an upstream to look up to.
It supports Codex, Claude Code, Cursor, Copilot, Gemini CLI, Amp, Kilo, and OpenCode.
(NOTE: Amp /mode free is not supported, as Amp Code doesn't support it in headless mode - since they need to show ads for that business model to work.)
This fork is designed to keep up a faster rate of development customised to my needs (and if you want, yours as well -> Submit an issue and I'll make a PR for it). There's certain features which will (rightly) remain out of scope/priority for the project at its scale, but might be required for someone like me.
Adds full provider adapters (server managers, service layers, runtime layers) for agents that are not yet on the upstream roadmap:
| Provider | What's included |
|---|---|
| Amp | Adapter + ampServerManager for headless Amp sessions |
| Copilot | Adapter + CLI binary resolution + text generation layer |
| Cursor | Adapter + ACP probe integration + usage tracking |
| Gemini CLI | Adapter + geminiCliServerManager with full test coverage |
| Kilo | Adapter + kiloServerManager + OpenCode-style server URL config |
| OpenCode | Adapter + opencodeServerManager with hostname/port/workspace config |
| Claude Code | Full adapter with permission mode, thinking token limits, and SDK typings |
| Feature | Description |
|---|---|
| Settings page | Dedicated route (/settings) for theme, accent color, and custom model slug configuration |
| Accent color system | Preset palette with contrast-safe terminal color injection across the entire UI |
| Theme support | Light / dark / system modes with transition suppression |
| Command palette | Cmd+K / Ctrl+K palette for quick actions, script running, and thread navigation |
| Sidebar search | Normalized thread title search with instant filtering |
| Plan sidebar | Dedicated panel for reviewing, downloading, or saving proposed agent plans |
| Terminal drawer | Theme-aware integrated terminal with accent color styling |
- Custom abstract-mark app icon with macOS icon composer support
- Centralized branding constants for easy identity swaps
- Desktop icon asset generation pipeline from SVG source
sync-upstream-pr-tracksscript for tracking cherry-picked upstream PRscursor-acp-probefor testing Cursor Agent Communication Protocol- Custom alpha workflow playbook (
docs/custom-alpha-workflow.md) - Upstream PR tracking config (
config/upstream-pr-tracks.json)
Run the interactive installer — it detects your OS, checks prerequisites (git, Node.js ≥ 24, bun ≥ 1.3.9), installs missing tools, and lets you choose between development/production and desktop/web builds:
# macOS / Linux / WSL
bash <(curl -fsSL https://raw.githubusercontent.com/aaditagrawal/t3code/main/scripts/install.sh)# Windows (Git Bash, MSYS2, or WSL)
bash <(curl -fsSL https://raw.githubusercontent.com/aaditagrawal/t3code/main/scripts/install.sh)The installer supports npm, yarn, pnpm, bun, and deno detection, and will auto-install bun if no suitable package manager is found. It provides OS-specific install instructions for any missing prerequisites (Homebrew on macOS, apt/dnf/pacman on Linux, winget on Windows).
Warning
You need at least one supported coding agent installed and authorized. See the supported agents list below.
# Prerequisites: Bun >=1.3.9, Node >=24.13.1
git clone https://github.com/aaditagrawal/t3code.git
cd t3code
bun install
bun run dev- Codex CLI (requires v0.37.0 or later)
- Claude Code — not yet working in the desktop app
- Cursor
- Copilot
- Gemini CLI
- Amp
- Kilo
- OpenCode
Read CONTRIBUTING.md before opening an issue or PR.
Need support? Join the Discord.
- This project is very early in development. Expect bugs. (Especially with my fork)
- Maintaining a custom fork or alpha branch? See docs/custom-alpha-workflow.md.