Run a session on another computer

SSH Remote runs a session's Claude on another computer, such as a server where your code lives or a more powerful cloud machine. You still read and reply in Yardmaster on this computer. You choose where each session runs when you start it, so local and remote sessions can sit in the same project.

The other computer needs Claude Code installed and signed in, and you need its address, a username and a password or key.

Add a remote computer#

1. 1

   Open Settings > SSH Remotes and click Quick Connect.

2. 2

   Enter the computer's address (Host), your Username and Password.

3. 3

   Yardmaster connects, makes a secure key for this computer, installs it on the other one, and checks that Claude Code is there. When it says the remote is ready to use, you are done.

The password is used once, to set up the key, and is never stored. If the check says Claude Code not found on remote, install Claude Code on that computer and try again.

Already use SSH? Add Manually takes a host, port, username and key file, and Import from SSH Config reads the computers you have already set up. Test Connection checks a saved remote at any time.

Start a session on it#

Once you have a remote, the + at the top of a project's sessions list opens a short menu: Local for this computer, or the name of a remote. Pick one. The session then works like any other.

To start on one remote by default, click the star next to it in Settings > SSH Remotes (hover it to see Set as default). The star fills in on the default remote. A remote can also have its own Remote Working Dir, the folder the session starts in.