SSH Documentation

1. 1 Open SSH and create a connection.
2. 2 Enter a display name, host, port, and username.
3. 3 Choose password, private key, or no authentication. For a private key, enter the local key path and an optional passphrase.
4. 4 Use Test connection, then Save. Stored passwords and passphrases are represented by local credential references; reopening the form does not reveal the secret.

1. 1 Select a saved connection and connect to open a PTY-backed terminal session.
2. 2 Use the terminal normally. The session forwards keyboard input and resizes the remote PTY with the pane.
3. 3 Use split panes, output search, log copy/export, and the context menu for Copy, Paste, Paste Selected Text, and Select All.
4. 4 Close the session when finished. Active sessions use a confirmation flow before closing.

On first connection, review the host-key fingerprint before trusting it. A later mismatch is rejected instead of silently replacing the trusted key.

• ✓ Only trust a fingerprint that you verified through an independent channel.
• ✓ If a server key intentionally changed, reset the stored fingerprint from the connection UI and reconnect to review the new value.
• ✓ Unfour tracks failed and reconnecting states and preserves failed session tabs so the error remains visible.
• ✓ Reconnect restores the terminal transport; verify remote state before resuming an interrupted command.

Unfour records structured command history after a command is echoed by the remote shell. History is scoped to the workspace and connection, bounded locally, and conservatively redacted.

• ✓ Type at least two characters at a detected shell prompt to see up to six matching suggestions.
• ✓ Use Up and Down to choose, Tab or click to insert, and Escape to dismiss. Enter always submits the current line.
• ✓ Password-prompt input is not stored, and commands that cannot be classified safely may be excluded or shown as redacted.
• ✓ MCP history queries can filter the current workspace by connection, text, time range, and result limit; they never return terminal buffers or raw session logs.

Open Remote Files from a connected terminal session. The SFTP panel uses that session and connection to browse the remote filesystem.

• ✓ Open directories, enter a remote path, go to the parent directory, and refresh the listing.
• ✓ Upload a local file or use drag and drop, and download a selected remote file.
• ✓ Create folders, rename entries, delete selected disposable paths, and copy a remote path.
• ✓ View transfer progress and cancel an active transfer. Unfour allows one streamed upload or download per SSH connection at a time.

An SSH Task is a saved, serial sequence of enabled command, upload, and download steps. Tasks belong to a workspace and may have a default connection.

1. 1 Open Tasks, create a task, and add steps in the required order.
2. 2 Use {{name}} placeholders in supported command and path fields. Run inputs can be prefilled from workspace globals and the selected environment; mark sensitive inputs as secret.
3. 3 Review the target connection, resolved inputs, and enabled steps in the Run dialog, then start the task.
4. 4 Watch the live transcript and step status, then inspect persisted run summaries and logs. Cancel a running task when necessary.