How-to · Other machines

Open a session on another machine

View a session already running on a paired machine, or start a new one there.

You have paired with another machine and want to work with a session running on it.

To open a session already running there, click its row in the peer's own section of the sidebar.
To start a new session there instead, press the + control beside that section's header. It stays disabled, naming the machine as not reachable, while it is.
Pick a mode, then decide what the session opens on with the Repository and Path switch below the mode cards.
On Path, pick a folder from the machine's own recent list, or type its path.
On Repository, type a GitHub repository as owner/repo. The machine resolves it under its own base folder, and clones it there the first time it is named.
The line under the field names the folder it clones into. A machine whose folder is fixed says it clones into its workspace instead.
Switch on Open on a new worktree to give the run its own checkout instead of that folder's current checkout.
Pick the engine, model, thinking level and output style. The engines and styles are that machine's own, and an engine it cannot run is disabled.
Press Create. It stays disabled until the folder or repository holds text; Ctrl + Enter (⌘ + Enter on a Mac) does the same. The session opens idle, and you send its first message from its conversation.

A repository the machine has never cloned can take a few minutes. After three seconds the dialog says so and keeps waiting. The link carries no progress and no cancel, so closing the dialog leaves the machine to finish. The session appears in its section of the sidebar when the clone lands.

Turret opens the new session in the peer's own section of the sidebar, selected the same way clicking an existing row selects it.

A machine with no base folder draws a band in place of the repository field. Set writes the folder the machine suggests, over the link.

See Set the base folder for the folder a machine clones into, and Change another machine's settings for reaching that machine's own Settings.

See Pair two machines for pairing with a machine before either of these.

See What pairing grants for what creating or writing to a session on a paired machine actually authorises.