Remote Workspaces (SSH)

A Remote Workspace is a folder on another computer that you open on your Mac: a server, a lab machine, another computer at home. The files stay on that computer, and in Resomark you browse, edit, search and review changes just as in a local Workspace. When your AI works on a server, you see what it changed from your own Mac. Remote Workspaces are part of Plus, and you can use them during the trial.

Resomark is a Mac app and runs on your Mac. The computer you connect to (the host) can be:

• A Mac with Apple silicon and macOS 15 or later. Turn on Remote Login in System Settings > General > Sharing.
• Linux on ARM64 or x86_64, any distribution. It needs curl or wget, gzip, and one of sha256sum, shasum or openssl; most systems have them already. To see changes in Git repositories, it also needs git.
• Windows 11 on ARM64 or x64, with its built-in OpenSSH server turned on. Track Changes works only on local NTFS drives, not on network drives.

Resomark connects with the SSH on your Mac, so the aliases, ports, jump hosts and keys in ~/.ssh/config all apply. Try ssh host in Terminal first: if you can log in there, Resomark can connect. Getting through the network (a VPN, for example) is up to you.

1. Choose File > Add Remote Workspace…. Connect to Remote (SSH)… on the first-launch page does the same.
2. The menu at the top of the window is already set to a new remote host. Enter user@host or an SSH alias, leave the port empty to use your SSH configuration, and click Connect. For a host that's already in ~/.ssh/config, pick it from the same menu, under Remote Hosts.
3. When a password, key passphrase or verification code is needed, or the host's identity needs confirming, Resomark asks in the window. Passwords are kept only while Resomark is running and forgotten when you quit; they aren't saved.
4. Once connected, the window lists the host's folders, starting from your home folder. Click to select, double-click to go in, ↑ to go up, or type a path in the path field and press Return. ⌘⇧. shows hidden folders.
5. Click Add Workspace. If the folder isn't a Git repository and hasn't been a Workspace on any Mac before, you're asked whether to turn on Track Changes; if it has, the host's setting carries on.

If connecting fails, the window shows the reason and SSH's own message; fix the problem and click Try Again.

The first time you connect to a host, Resomark installs a small program on it, the remote helper, which reads and writes files and records changes there. You don't need to do anything: the host downloads it, and if it can't, your Mac downloads it and sends it over. It goes in ~/.resomark/remote-helper/ in your home folder (%LOCALAPPDATA%\.resomark\remote-helper\ on Windows). It doesn't need sudo, install a system service or open a port. When no Mac is connected to it, it quits after 10 minutes.

There's a dot after the big title on the folder page, and another on the remote Workspace's computer icon on the Home page. Hover over it to see the current step, such as "Waiting for authentication…".

Color	Meaning	Click it on the folder page to
Gray	Not connected; connects when used	Connect now
Blue (pulsing)	Connecting or loading	Start this connection over
Green	Connected and up to date	Check the connection once
Yellow	Connected, but something didn't update	Try again
Red	Disconnected	Reconnect

The light on the Home page only shows the state; you can't click it.

Opening Resomark doesn't connect to any Remote Workspace. It connects when you go into one, open a file in it or search in it. When no window is using it any more, it disconnects after 60 seconds and the light turns gray again. Once disconnected, it doesn't keep retrying in the background; it reconnects the next time you use it. A Remote Workspace that isn't connected doesn't show up in search results.

• There's no need to save by hand: when you pause, your edits sync to the host. A dot on the tab means syncing isn't finished yet.
• If you and a program on the host change the same file at the same time, the changes are merged. Where both changed the same place, both versions are kept with markers between them; pick what you want and delete the markers.
• If the connection drops, open files and your edits stay, and the files become read-only for the time being. Anything not yet synced is kept on this Mac. Once reconnected, Resomark first checks whether those edits arrived, then brings in what's new on the host; it never overwrites someone's newer changes with an older copy.
• Edits not yet synced when you quit are kept too, and come back the next time you open Resomark. If you can't connect, you can also use Save As… to keep them on this Mac.

• Copy to your Mac: right-click a file and choose Copy, or press ⌘C, then paste in Finder. Or drag the file from the sidebar to the desktop, Finder or another app. You get what's on the host right now, written only once it has arrived completely. Files only, not folders.
• Send to the host: drag files or folders from your Mac onto a remote folder in the sidebar. If a name is taken, you're asked whether to Keep Both or Stop; nothing is replaced. Progress shows in the window, and you can cancel. Over 1,000 files or 500 MB, you're asked first; a single file over 64 MiB isn't sent.
• Open with Default App: right-click and choose Open with Default App. HTML opens in your default browser with its images and styles; other files open as a read-only copy.
• New files, renaming, moving to the Trash and tags work as usual, as long as you're connected. Reveal in Finder and Open With aren't available for remote files.

• Folders outside Git: Track Changes works as usual; reviewing, keeping and reverting changes are the same as on your Mac. Changes and history are recorded on the host, so several Macs opening the same remote folder see the same records.
• Git repositories: Git runs on the host. You can see uncommitted changes and commit history, and switch the host's worktrees and branches. Committing, pulling and pushing aren't done in Resomark; leave them to your AI or the terminal.
• Remote files have no Mac versions, and can't be restored from a Git commit.
• Favorites and pinned folders work as usual, and are stored in the folder on the host. A Remote Workspace's favorites don't appear on the Home page; go into the Workspace to see them on its folder page.

Add Remote Workspace… has a PLUS badge. Remote Workspaces you've already added stay in the sidebar with their connections and settings, and opening one shows the subscription window. See Free, Plus and the 14-day trial.

1. In Terminal, try ssh with the same address and see whether you can log in.
2. Hover over the status light to see which step it's stuck on.
3. If it still doesn't work, choose Help > Export Remote Diagnostics… and attach the file to Report a Bug… or an email to us. See Troubleshooting.

• Kinds of Workspace
• Track Changes
• Uncommitted changes in a Git repository