Skip to content

Tutorials

T3 Code on your machine

Run T3 Code's server on the machine and drive Claude Code and Codex threads from a browser or your phone, with the laptop closed.

Experimental. This setup is new and can change or stop working. Tell us what breaks on the feedback board.

T3 Code is an open-source app for running coding agents as threads, each with its diff and its own worktree. On a repose machine the threads run the machine's own Claude Code and Codex, keep going after you close the laptop, and survive a stop, start or restore.

Install the server

ssh todo-app.repose 'npx -y t3@latest service install'

The service is a systemd user unit, so a repose stop and repose start brings it back. It listens on localhost:3773 on the machine, and only there.

Open it on your laptop

While you're attached, the port is already on your laptop: open http://localhost:3773. If you aren't, forward it:

repose open 3773 --project todo-app

T3 Code asks to be paired the first time a browser connects. Get a pairing link from the machine:

ssh todo-app.repose 'npx -y t3@latest pair'
Pairing with todo-app (http://127.0.0.1:3773).
Pairing URL: http://localhost:3773/pair#token=...
Expires: ...

Open that URL on the laptop before it expires. Ignore its note about the URL reaching only the machine; repose open put the same port on your laptop. The threads use the machine's agents, with their copied logins and the Claude login you made on any of your machines. Add your checkout as a project (/home/dev/todo-app) and start a thread.

To reach it from your phone, use T3 Code's own T3 Connect or t3 pair --tailscale. repose has no public URL to offer.

The T3 Code desktop app can add the machine as an SSH computer, todo-app.repose; it uses your own ssh, so the certificate renews by itself. We've tested the browser route above and not the desktop app's.

What changes on a repose machine

  • Claude Code doesn't ask. T3 Code starts the machine's claude, which runs in bypassPermissions mode, and T3 Code's approval settings don't change that. For Codex, T3 Code's settings apply.
  • You still get notified. A question from a thread, or its repose-notify --done, notifies you as one in tmux does.
  • repose status doesn't list T3 Code's threads. It shows agents in the project's tmux windows only. A machine whose agents all run under T3 Code, with no SSH session open, gets the "unused for 24h" notice even while threads are working.
  • Ignore T3 Code's "Updates available" notice for Claude and Codex. The agents come with the machine and update with its base; T3 Code leaves them alone.
  • A restore takes T3 Code with it. Its threads and pairing live in ~/.t3 on the machine, so restoring a snapshot puts them back as they were then.

Disk

Each T3 Code update keeps the old server under ~/.t3/runtime/versions. Check with:

ssh todo-app.repose 'du -sh ~/.t3/runtime/versions'

npx -y t3@latest uninstall removes the service, the launcher and every downloaded version, and keeps your projects and threads.

When it doesn't work

The page doesn't load. Check the service on the machine with ssh todo-app.repose 'systemctl --user status t3code', and that repose open 3773 is still running on your laptop.

A Codex thread answers but says the command host is unavailable. Older bases shipped Codex without the part it runs commands through. A newer base has it; if the project's Config tab has Hold base updates ticked, untick it.

Search docs

  • Quickstart Start here
  • Install Start here
  • Run and attach Using repose
  • SSH and editors Using repose
  • Sync Using repose
  • The machine Using repose
  • Installing software Using repose
  • Secrets and security Using repose
  • Lend the agents your Chrome Using repose
  • Agents Using repose
  • Notifications Using repose
  • Projects and lifecycle Using repose
  • Git with repose Tutorials
  • Watch the agent's browser Tutorials
  • A git workflow for several agents Tutorials
  • Run a swarm Tutorials
  • T3 Code on your machine Tutorials
  • herdr on your machine Tutorials
  • Pricing Account
  • Limits and acceptable use Account
  • CLI reference Reference
  • Troubleshooting Reference