Remote Agent Workflow
FreshRun AI agents on remote servers while monitoring from your desktop.
Remote Workflow
Step 1: Configure SSH Host
Settings → SSH Hosts → Add:
| Field | Example |
|---|---|
| Name | prod-server |
| Host | 10.0.0.50 |
| Port | 22 |
| Username | deploy |
| Private Key | /home/user/.ssh/id_ed25519 |
| Remote Dir | /home/deploy/project |
Or import from SSH config: Dropdown auto-detects hosts from ~/.ssh/config.
Step 2: Test Connection
Click "Test Connection" — verifies SSH connectivity and agent availability on the remote machine.
Step 3: Create Remote Agent
When creating a new agent, use the "SSH Remote Execution" dropdown to select your configured host.
Remote agents show:
- "REMOTE" pill in the Left Bar
- Host name badge in the Main Panel header
- Agent type shows "claude-code (SSH)"
Full Remote Capabilities
Everything works remotely:
- File Explorer browsing remote filesystem
- Auto Run executing on remote projects
- Git Worktrees on remote repositories
- Command Terminal executing on remote host (full PTY)
- Group Chat participation alongside local agents
Step 4: Monitor
Use your desktop to monitor remote work:
- History panel logs remote Auto Run completions
- Usage Dashboard tracks remote sessions
- Director's Notes provides unified view
See Also
- SSH Remote Execution — Detailed SSH setup
- Group Chat — Remote agents in Group Chat
- Auto Run Workflow — Task execution