# T3 Code for Raycast

URL: https://www.raycast.com/skilux/t3-code

> Start T3 Code coding agent sessions with a prompt, search threads, and jump to threads waiting on your input.

- Install: raycast://extensions/skilux/t3-code
- Author: [Skilux](https://www.raycast.com/skilux)
- Installs: 176
- Platforms: macOS
- Categories: Developer Tools
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/c4e0f79975a011e16032382f2d1263f712f8b43c/extensions/t3-code/

## Commands

- **Prompt T3 Code**: Start a new T3 Code session with a prompt.
- **Waiting T3 Threads**: Active threads where the agent has stopped and the ball is in your court.
- **Search T3 Threads**: Search every live thread and open it in T3 Code.

## README

### T3 Code for Raycast

Three commands against the T3 Code server running on this Mac.

- **Prompt T3 Code** — write a prompt, attach files, pick a preset (project, model, permissions and workspace), optionally branch into a git worktree. Creates the thread, sends the prompt, opens the thread in T3 Code.
- **Waiting T3 Threads** — active threads (not settled, snoozed or archived) whose agent has stopped.
- **Search T3 Threads** — every live thread, by title, project or branch.

#### Prompt T3 Code

- **Files** take any file type, up to 8 per prompt: images up to 10 MB, other files up to 50 MB.
  A screenshot on the clipboard is attached when the command opens, unless it was already sent.
  `⌘⇧V` attaches one copied later, `⌘⇧A` attaches the files selected in Finder, and `⌘Y` previews
  what is attached. Protocol v1 servers accept images only.
- **Preset** is the project, model, permissions and workspace in one choice. Starred presets come
  first, then the combinations you used recently. `⌘D` stars the current settings, and again
  unstars them. Choose Custom… for the separate fields. Model names show the provider and effort,
  for example `Claude · Sonnet 5.5 · high · 1M`.
- `↵` sends and opens the thread in T3 Code. `⌘⇧↵` sends and leaves T3 Code alone.
- Worktrees need the project folder on this Mac, because the base branch is read from its git
  repository.

#### Setup

Issue a token and paste it into the extension preferences on first run:

```
# Server address: the running server publishes it here.
ORIGIN=$(node -p "JSON.parse(require('fs').readFileSync(process.env.HOME+'/.t3/userdata/server-runtime.json','utf8')).origin")
# If that file is missing or has no origin, or you set the Server Origin preference,
# use that value instead:
# ORIGIN=http://127.0.0.1:3773

# Issue the token with the CLI at the server's own version.
VERSION=$(curl -s $ORIGIN/.well-known/t3/environment | node -p "JSON.parse(require('fs').readFileSync(0,'utf8')).serverVersion")
npx t3@$VERSION auth session issue --ttl 365d --label raycast --token-only
```

The CLI must match the server's version: a token issued by a different version can be
written to the previous database, and the server then rejects it. The commands use only
`node`, `curl` and `npx`, which come with macOS and Node.

Revoke it with `t3 auth session revoke`, list sessions with `t3 auth session list`.

The server origin comes from `~/.t3/userdata/server-runtime.json` unless the
`Server Origin` preference is set, so a restarted server on a new port needs no
reconfiguration.

#### How it talks to T3

Everything runs against the T3 Code server on this machine, over loopback:

- `GET /api/orchestration/shell` for projects and threads.
- `GET /.well-known/t3/environment` for the server's orchestration protocol version.
- `GET /api/auth/websocket-ticket`, then a WebSocket to `/ws`, for creating threads on protocol v2.
- `POST /api/orchestration/dispatch` for `thread.create` and `thread.turn.start` on protocol v1.

On protocol v2 the extension sends the `x-t3-orchestration-protocol` header and maps the
v2 thread fields onto the v1 shape. v2 removed thread creation over HTTP, so Prompt T3 Code
uses one `orchestration.launchThread` call over the WebSocket: it creates the thread, prepares
the worktree and sends the first message. Attachments are uploaded first through
`attachments.createUploadUrl`. On v1 the images travel inside the turn as data URLs.

Opening a thread uses `t3code://threads/<environmentId>/<threadId>` on supported
desktops (stable 0.1.0 and later, or Nightly builds from 2026-10-12 build 3010).
The environment ID comes from the configured server, and the desktop version is
read from the selected app's bundle. This avoids title typing and differences
between the extension's and T3 Code's search rules.

Older desktops, unavailable bundle versions, or servers without an environment ID
retain command-palette navigation. This fallback types the thread's title, project
and branch, and presses Enter only when the extension counts one matching thread.
macOS asks for Accessibility permission when this fallback is first used.

The app is found by release channel. The stable build is named `T3 Code (Alpha)` and the
Nightly build `T3 Code (Nightly)`. With the `App Name` preference empty, the extension
picks one from the running server's version, or from the installed apps when no server
is running. Set the preference to override it.

On v1 the extension creates worktrees itself with `git worktree add`, since the HTTP
dispatch handler passes commands straight to the engine and never runs the
server's worktree bootstrap. The path matches T3's own convention,
`~/.t3/worktrees/<repo>/<branch>`. On v2 the server prepares the worktree.

The preset list comes from the threads you ran recently, so the extension carries no model
list of its own. Provider names, custom models and starred models are read from
`~/.t3/userdata/settings.json` and `model-manifest.json`, read-only.

#### Development

```
npm install
npm run dev
```
