Start a thread
Threads
Use a new thread for a separate task. On web and desktop, New thread opens the project picker when you have more than one open project. A new thread's branch and workspace mode come from your configured defaults.
T3 Code docs: thread sidebar
What it’s for
Keeping separate tasks apart. Choose New worktree when the code changes need their own branch and working directory. A worktree is a separate copy of your project's files so agents can work without clashing.
T3 Code docs: thread sidebar
When to use it
Start a new thread whenever you begin a separate task. To keep working in an existing worktree, use New thread in this worktree from the branch toolbar.
T3 Code docs: thread sidebar
How to use it
The T3 Code docs don't say where to change the default workspace mode. For one thread, open the workspace menu with Cmd+Shift+X (Ctrl+Shift+X on Windows/Linux) and choose New worktree.
T3 Code docs: thread sidebarkeybindings
Choose New worktree if the task needs its own branch and directory.
T3 Code docs: thread sidebar
In a desktop browser or the desktop app, press Cmd+Enter on macOS or Ctrl+Enter on Windows and Linux to start a new thread and immediately open another draft.
T3 Code docs: thread sidebar
Shift-click several models in the model picker to send the same prompt to each one as a separate thread and worktree.
T3 Code docs: thread sidebar
Theo’s tips
When reviewing heavy changes, Theo pastes the PR into a T3 Code thread with Claude and asks for a breakdown: what is changing, why it is changing, and where the risk is.
When I'm reviewing heavy changes, I'll often just paste the PR into T3 code with Claude and ask it to give me a breakdown of the changes. What is changing, why is it changing, and where is the risk?
Theo no longer starts threads over SSH or in terminals. He clicks the new thread button or uses its hotkey, then picks which machine the thread runs on.
I'm not spinning up my threads via SSH anymore. I'm not spinning up my threads in terminals anymore. I'm spinning up my threads by clicking the new thread button or the hotkey for it and then I choose where I want them to run.
What’s changed
- Open the project picker from the sidebar header or new-thread shortcut, including for projects without active threads.Updated Nov 3
- New "Use last project" preference for new threads.Updated Oct 29
- A new thread can now start on an existing branch.Updated Sep 7
2 earlier changes
- Shift+click creates a new thread in the current project, and the tooltip shows the shortcut.Updated Aug 11
- New threads can be created through project breadcrumbs.Updated Jul 27
Unofficial notes. Not affiliated with Theo or t3.gg.