This is Sarah's public fork of T3 Code for Catppuccin theme work. It ships with Catppuccin Macchiato as the default app theme.

• Fork: https://github.com/serabi/t3code
• Source project: https://github.com/pingdotgg/t3code
• Main fork branch: catppuccin

This fork pulls updates from the source project, but fork changes do not get pushed upstream. Keep local work on catppuccin, merge upstream/main when the source project moves, and push only to origin/catppuccin.

git clone --branch catppuccin https://github.com/serabi/t3code.git
cd t3code
git remote add upstream https://github.com/pingdotgg/t3code.git
bun install

If you only want to use the Catppuccin version, clone the fork and install it:

git clone --branch catppuccin https://github.com/serabi/t3code.git
cd t3code
bun install
bun run catppuccin:install

When Sarah updates this fork, pull the latest fork changes and reinstall:

git pull origin catppuccin
bun install
bun run catppuccin:install

Only use bun run catppuccin:update if you can push to serabi/t3code. That script syncs from the source project, runs checks, pushes this fork branch, then builds and installs the app.

git fetch upstream
git switch catppuccin
git merge --no-ff upstream/main
bun fmt
bun lint
bun typecheck
git push origin catppuccin

The fork has a GitHub Action that checks whether upstream/main has moved. If it has, the action opens or updates an issue labeled upstream-update. If upstream changed likely theme-related files, the issue also gets upstream-theme and lists those files so we know to check whether upstream has added native theming.

Build a local Catppuccin-flavored nightly DMG and install the app into /Applications. If an existing T3 Code (Nightly).app is present there, the installer moves it to Trash before copying the new build:

bun run catppuccin:install

The first time this fork starts, it moves the old upstream System theme default to Catppuccin Macchiato. If you later want to compare against the original themes, open Settings -> General -> Theme.

Build the DMG without installing:

bun run catppuccin:build

Sync from upstream, run the required checks, push the fork branch, then build and install:

bun run catppuccin:update

The install command creates a nightly-style version automatically, so the app is packaged as T3 Code (Nightly). To pass build options through:

bun run catppuccin:install -- --arch x64
bun run catppuccin:install -- --install-dir "$HOME/Applications"

You can also use the lower-level desktop build script directly:

node scripts/build-desktop-artifact.ts --platform mac --target dmg --arch arm64 --install

T3 Code is an "agent harness control surface". It enables control of the agents on your machine with a best-in-class mobile app (iOS, Android), web app and Electron-based desktop app.

Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, and OpenCode. If they're set up on your computer, T3 Code can control them.

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.

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 editor that you want.

The easiest way to test T3 Code is to run the server in your terminal (requires Node.js 22.16+, 23.11+, or 24.10+):

npx t3@latest

This will launch T3 Code's backend on your machine as well as the local web app to control your agents.

Tip: Use npx t3@latest --help for the full CLI reference.

Install the latest version of the desktop app from GitHub Releases, or from your favorite package registry:

winget install T3Tools.T3Code

brew install --cask t3-code

yay -S t3code-bin

We are very very early in this project. Expect bugs.

We are (mostly) not accepting contributions yet. Small fixes may be considered. Big features will not be.

Full docs live in docs/. There's no docs site yet.

• Install and first run
• Permission modes
• Keyboard shortcuts
• Remote access from a phone or another machine
• Keeping app and server in sync
• Source control integrations
• Multiple accounts: Codex · Claude
• Linux: run T3 Code as a background service

Building from source? Start at docs/internals/overview.md.

T3 Code uses Vite+ so you'll need to install the global vp command-line tool.

curl -fsSL https://vite.plus | bash

irm https://vite.plus/ps1 | iex

Checkout their getting started guide for more information: https://viteplus.dev/guide/

vp i

Read CONTRIBUTING.md before opening an issue or PR.

Need support? Join the Discord.