# Remote development over SSH

> Open a project on another machine over SSH in KazoCode. The explorer, editor, search, terminal, language servers and the agent all work on the remote files.

KazoCode can open a project that lives on another machine, such as a cloud server or a workstation, over SSH. Everything works on the remote files: the explorer, the editor, search, quick open, the terminal, language servers and the agent.

## Connect

1. Run **Connect to Host...** (`Ctrl+Shift+Alt+C`).
2. Enter the host and folder as `user@host:/path/to/project`.
3. KazoCode connects and opens the folder. A remote badge in the status bar shows which host you're on.

A remote project's address looks like `ssh://user@host:22/path/to/project`. Remote projects appear in your recent folders, so switching between them is the same as switching local folders.

> [!NOTE]
> KazoCode signs in with your SSH keys, using your normal SSH configuration. Password sign-in isn't supported, so make sure `ssh user@host` works from a terminal without a password prompt first.

## How it works

- File reads and writes, the file tree and search run as commands on the host over SSH.
- The terminal opens a login shell on the host in the project folder.
- Language servers run on the host, so code intelligence uses the host's toolchain. KazoCode checks that each server is installed there first.
- **Run Command on Host** runs a one-off command; background jobs such as a dev server run there too.

While you type, unsaved changes are kept on your computer as drafts, so a dropped connection doesn't lose your work. Reopening the file restores the draft.

**Disconnect Remote** closes the connection.
