SSH Sessions

Saved remote SSH connections with terminal access, file browsing, and agent-driven remote execution.

Scape supports saved SSH connections for remote terminal access, file browsing, and agent-driven remote command execution — all from within the Scape window.

Setting up a connection

  1. Open Settings → SSH.
  2. Click Add Connection.
  3. Fill in the connection details:
FieldDescription
NameA display name for the connection
HostHostname or IP address
PortSSH port (default 22)
UsernameRemote user
Auth methodSSH Agent, Key File, or Password
Remote pathOptional default directory to open

Scape detects ~/.ssh/config aliases, so you can reference hosts defined there.

Using SSH connections

Once saved, a connection gives you:

  • Terminal access — Click Connect to open a remote terminal tab in Scape.
  • File browsing — Browse the remote filesystem via SFTP directly in Scape.
  • Remote coding session — Click Claude to launch a coding session on the remote machine.

Testing connectivity

Before saving, use the Test button to verify the connection works. Scape uses libssh2 with a 10-second timeout.

Credentials

SSH credentials (passwords and key passphrases) are stored securely in macOS Keychain. Connection metadata is persisted in SQLite.

MCP tools

ToolDescription
list_ssh_connectionsList all saved SSH connections
delete_ssh_connectionRemove a saved connection