Remote SSH

Maestri supports connecting to remote servers via SSH, enabling inter-agent communication across machines or isolated environments.

Enabling SSH

1. Go to Settings > General > Remote SSH.
2. Click Configure.
3. Toggle Enable SSH workspaces.
4. Optionally adjust the Tunnel Port (default: 7433).

How it works

When you connect to an SSH workspace, Maestri installs a small script on the remote server and opens a reverse tunnel so agents can communicate back.

The script is a simple curl wrapper — you can inspect it anytime. No background processes are installed.

Per-connection settings

When configuring SSH for a workspace or terminal, you can customize:

• Host — hostname or IP address
• User — SSH username
• Port — SSH port (default: 22)
• Script Path — where the maestri script is installed (default: ~/.local/bin/maestri)
• Add to PATH — whether to add the script directory to your shell profile

Security notes

• Uses your existing SSH keys from ~/.ssh
• Tunnel only binds to localhost — remote access requires the SSH connection
• First-time host keys are auto-accepted; changed keys trigger a warning