Skip to content

Work on a remote machine over SSH ​

Point DevAgent at any SSH target — a beefier dev box, a GPU host, a cloud sandbox — and it feels like a local worktree. Same editor, same diff view, same agents, different compute. You can open remote repos or just arbitrary folders. For the full menu of local / SSH / server / ephemeral-VM modes, see Ways to run DevAgent.

Setup ​

  1. Add the host under Settings → SSH.
  2. Test the connection. Make sure git is installed on the host if you're working with a repo.
  3. Add the repo to DevAgent, selecting the SSH target as its location — or open any remote folder directly from the file picker.

Run ​

  1. Create a worktree. DevAgent runs git worktree add on the remote.
  2. Launch an agent — it runs on the remote host, not your laptop.
  3. Edit files inline — DevAgent streams saves to the remote filesystem.
  4. Review the diff, commit, and push from your laptop as usual.

Disconnects ​

Laptop sleeps, Wi-Fi drops — the agent keeps running remotely. DevAgent reconnects and re-attaches the terminal. Nothing lost.

DevAgent Desktop Documentation