Remote Development

Run Claude Code on remote machines and keep every Crystl feature working — approval panels, file transfers, and click-to-open.

Toggle auto-tunnel in Settings and every SSH connection automatically forwards the bridge port and installs Claude Code hooks on the remote. No manual setup, no paste-this-command step.

Claude runs on the remote server. Approval panels, question panels, and notifications appear on your Mac. Drag files into the SSH terminal and they're SCP'd to the remote automatically.

Why it matters

Zero-config tunnel

One toggle in Settings. Every SSH connection is automatically bridged.

File relay

Drag or paste files into SSH terminals — SCP'd automatically. Click remote paths to download and open locally.

Panels over SSH

Approval, question, and notification panels work over the tunnel. Respond locally to remote requests.

Any SSH target

Cloud VMs, dev containers, CI runners, home servers. If you can SSH into it, Crystl works.

Dive deeper in the Remote SSH docs

Ready to try it?

Create a free account and download Crystl for macOS.

get started getting started guide →

Frequently asked questions

Do I need to install anything on the remote?
No. When auto-tunnel is enabled, Crystl installs hooks on the remote automatically via SSH RemoteCommand.
Does file relay work without the auto-tunnel?
File relay requires the SSH ControlMaster socket, which the auto-tunnel sets up.
Do approval panels appear locally?
Yes. Claude on the remote posts to localhost:19280, which the SSH tunnel redirects to your Mac.
Can I use the tunnel with multiple remotes at once?
Yes. Each SSH session gets its own ControlMaster socket. Crystl tracks them independently.
What if port 19280 is already in use on the remote?
The first tunnel binds the port. Subsequent connections see 'address already in use' but this is harmless.

More features