Repository navigation
Releases
T3 Code Roles Preview 0.1.10-preview.20261118.7
Unofficial preview. This is a fork of T3 Code with one extra feature, Roles & models. The T3 Code team didn't build it, so please report problems here and not upstream.
What it adds
Settings → Threads → Roles & models lets you give roles like implementation, review, security or research their own model, a delegation mode and optional instructions, for the whole machine or per project. Once a role has a model, your agents see the roles you set up and hand matching work to that role's model. So a quick review can run on a cheap model while a security pass gets a strong one.
- Prefer (the default): agents hand off substantive work and handle quick questions and small fixes themselves.
- Always: real matching work goes to the role, unless you ask the agent to do it itself.
Roles only apply to work T3 hands off. Your own threads keep the model you picked. The full guide is in Roles and models.
Install
It installs next to your normal T3 Code as T3 Code Roles Preview, with its own data folder (~/.t3-roles-preview). Your real threads, projects and settings aren't touched, so you'll add your projects again. Sign-ins for Claude Code, Codex and other agents belong to those tools, so the preview uses the ones you already have.
Linux (x64, Ubuntu 24.04 or newer, or a similar distro)
- AppImage:
chmod +x T3-Code-Roles-Preview-*.AppImage, then run it. - Debian or Ubuntu:
sudo apt install ./T3-Code-Roles-Preview-*-amd64.deb
macOS (Apple silicon)
Needs macOS 13 or newer. Open the .dmg and drag T3 Code Roles Preview into Applications. The app isn't notarized by Apple, so macOS blocks it the first time you open it. Go to System Settings → Privacy & Security, scroll down, click Open Anyway next to T3 Code Roles Preview and confirm.
If macOS says the app is damaged instead, run this once in Terminal and open it again:
xattr -dr com.apple.quarantine "/Applications/T3 Code Roles Preview.app"
To check a download, compare sha256sum <file> (Linux) or shasum -a 256 <file> (macOS) with SHA256SUMS.txt.
Good to know
- It doesn't auto-update. Grab new builds from Releases.
- It doesn't send usage data, and it doesn't install the
t3command. - It takes over
t3code://links (like pairing links) until you open your normal T3 Code again. - T3 Connect sign-in isn't included.
- Always is guidance to the agent, not a server-enforced guarantee.
- The phone app doesn't show Roles settings yet. Set roles up in the desktop app.
Uninstall
- Linux: delete the AppImage, or run
sudo apt remove t3code-roles-preview. - macOS: move the app to the Trash.
- To remove its data too, delete
~/.t3-roles-previewand the app profile:~/.config/t3code-roles-previewon Linux,~/Library/Application Support/t3code-roles-previewon macOS.
Feedback
Open an issue with this release's version, your OS, which roles you set up with which models, and what the agent did compared with what you expected.
Think Roles should be part of T3 Code, or that it shouldn't? Say why in the Roles discussion on upstream.
What's new in this build
A small update to help preview users join the Roles discussion:
- A one-time prompt asks whether Roles should be part of T3 Code, with an option to open the discussion or dismiss it.
- Settings → Threads → Roles & models keeps a Discuss on GitHub button, so you can find it again later.
The prompt waits until you've sent a few messages and gone idle. Once dismissed, it stays dismissed.
Build
Built from c22076933e on Linux and an Apple-silicon Mac. The Linux installers were packaged in Ubuntu 24.04. Based on upstream T3 Code at 9d28fc921b (November 16, 2026).
The update passed formatting, lint, unused-code checks, affected-package type checks, nine focused tests and React compiler checks. The Linux installer also passed an isolated launch check, including the new discussion button in Settings. GitHub Actions rejected new runs for this repository, so this build was made locally and did not get a new full CI run. The Mac app is ad-hoc signed, not signed with an Apple Developer ID or notarized.
T3 Code Roles Preview 0.1.10-preview.20261117.6
Unofficial preview. This is a fork of T3 Code with one extra feature, Roles & models. The T3 Code team didn't build it, so please report problems here and not upstream.
What it adds
Settings → Threads → Roles & models lets you give roles like implementation, review, security or research their own model, a delegation mode and optional instructions, for the whole machine or per project. Once a role has a model, your agents see the roles you set up and hand matching work to that role's model. So a quick review can run on a cheap model while a security pass gets a strong one.
- Prefer (the default): agents hand off substantive work and handle quick questions and small fixes themselves.
- Always: real matching work goes to the role, unless you ask the agent to do it itself.
Roles only apply to work T3 hands off. Your own threads keep the model you picked. The full guide is in Roles and models.
Install
It installs next to your normal T3 Code as T3 Code Roles Preview, with its own data folder (~/.t3-roles-preview). Your real threads, projects and settings aren't touched, so you'll add your projects again. Sign-ins for Claude Code, Codex and other agents belong to those tools, so the preview uses the ones you already have.
Linux (x64, Ubuntu 24.04 or newer, or a similar distro)
- AppImage:
chmod +x T3-Code-Roles-Preview-*.AppImage, then run it. - Debian or Ubuntu:
sudo apt install ./T3-Code-Roles-Preview-*-amd64.deb
macOS (Apple silicon)
Needs macOS 13 or newer. Open the .dmg and drag T3 Code Roles Preview into Applications. The app isn't notarized by Apple, so macOS blocks it the first time you open it. Go to System Settings → Privacy & Security, scroll down, click Open Anyway next to T3 Code Roles Preview and confirm.
If macOS says the app is damaged instead, run this once in Terminal and open it again:
xattr -dr com.apple.quarantine "/Applications/T3 Code Roles Preview.app"
To check a download, compare sha256sum <file> (Linux) or shasum -a 256 <file> (macOS) with SHA256SUMS.txt.
Good to know
- It doesn't auto-update. Grab new builds from Releases.
- It doesn't send usage data, and it doesn't install the
t3command. - It takes over
t3code://links (like pairing links) until you open your normal T3 Code again. - T3 Connect sign-in isn't included.
- The phone app doesn't show Roles settings yet. Set roles up in the desktop app.
Uninstall
- Linux: delete the AppImage, or run
sudo apt remove t3code-roles-preview. - macOS: move the app to the Trash.
- To remove its data too, delete
~/.t3-roles-previewand the app profile:~/.config/t3code-roles-previewon Linux,~/Library/Application Support/t3code-roles-previewon macOS.
Feedback
Open an issue with this release's version, your OS, which roles you set up with which models, and what the agent did compared with what you expected.
Think Roles should be part of T3 Code, or that it shouldn't? Say why in the Roles discussion on upstream.
What's new in this build
The Mac app is now ad-hoc signed, so macOS should offer Open Anyway instead of needing a Terminal command.
Build
Built from cc0f13c5b9 by workflow run 44097804854. Based on upstream T3 Code at 9d28fc921b (November 16, 2026). Not signed with an Apple Developer ID. The Mac app is ad-hoc signed.