T3 Code

T3 Code is a minimal web GUI for coding agents (currently Codex, Claude, OpenCode, and Hermes, more coming soon).

Installation

Warning

T3 Code currently supports Codex, Claude, OpenCode, and Hermes. Install and authenticate at least one provider before use:

• Codex: install Codex CLI and run codex login
• Claude: install Claude Code and run claude auth login
• OpenCode: install OpenCode and run opencode auth login
• Hermes: install Hermes Agent and run hermes model

Hermes setup notes: docs/providers/hermes.md

Hermes Agent support

T3 Code can run Hermes Agent as a local ACP provider. Enable Hermes from Settings -> Providers, point the binary path at your local hermes executable, then select Hermes from the chat model picker.

Recommended macOS setup:

git clone https://github.com/nousresearch/hermes-agent.git ~/Projects/hermes-agent
cd ~/Projects/hermes-agent
python3 -m venv venv
./venv/bin/pip install -e .
mkdir -p ~/.local/bin
ln -sf ~/Projects/hermes-agent/venv/bin/hermes ~/.local/bin/hermes
~/.local/bin/hermes model

T3 Code auto-detects common Hermes paths such as ~/.local/bin/hermes, ~/Projects/hermes-agent/venv/bin/hermes, /opt/homebrew/bin/hermes, and /usr/local/bin/hermes. Hermes manages authentication through its own CLI and local config; T3 Code starts hermes acp only when a Hermes conversation needs it.

Full setup and troubleshooting guide: docs/providers/hermes.md

Run without installing

npx t3

Desktop app

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

Windows (winget)

winget install T3Tools.T3Code

macOS (Homebrew)

brew install --cask t3-code

Arch Linux (AUR)

yay -S t3code-bin

Some notes

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

We are not accepting contributions yet.

Observability guide: docs/observability.md

If you REALLY want to contribute still.... read this first

Before local development, prepare the environment and install dependencies:

# Optional: only needed if you use mise for dev tool management.
mise install
bun install .

Read CONTRIBUTING.md before opening an issue or PR.

Need support? Join the Discord.