HerdRanger 0.20.18 pre-release guide

05 · SSH terminal and files

Know when you are controlling a live shell.

Choose a standalone shell, review a Herdr agent’s output, or deliberately attach a writable terminal when interactive input is needed.

Open the user guide

Open a standalone shell

Open a saved SSH profile for a standard shell. A Herdr profile can also offer a separate general server shell. Verify the displayed target before sending input.

Use the terminal’s Connections button to return to an open view or connect to a saved server. Leaving a view through Connections differs from explicitly closing it. Review the shell-stop confirmation when closing a terminal-backed view.

Continue in the existing agent terminal

When a waiting Herdr agent (opens in a new tab) needs an interactive login, OAuth, MFA, passphrase, or approval, Continue in live terminal attaches to that existing terminal after confirmation. It does not create a new shell or change the selected agent.

Input is live and may contain secrets. HerdRanger does not record, forward, or replay typed terminal input. Confirm the target before entering credentials.

Terminal controls

  • Resize text. Use a two-finger pinch on the supported terminal surface. Text adjusts in half-point steps from 10 to 28 sp.
  • Read scrollback. Scroll with one finger. Long-press to select text.
  • Paste. Review the clipboard content before confirming. A newline can execute a command.
  • Insert dictation. Review the transcript before inserting it without Enter.
  • Restore focus. Use the keyboard control to reopen the Android keyboard after dismissing it.

Submit the saved password once

If the profile stores the account password, the key button reads it from encrypted storage and sends it with one Enter directly to the current PTY. It is not displayed or copied to Android’s clipboard.

Use it only while a visible prompt—such as sudo—requests that same account password. The action disables while the credential is read to prevent duplicate taps.

Browse and transfer files

Where the host supports SFTP, browse folders and review the source, destination and permissions before uploading, downloading or creating a folder. Available file and attachment actions depend on the mode, entry point and host permissions.

Core’s New folder workflow creates a child directory only after you review the destination. See creating a space.

Inspect workspace changes

In Core, select a terminal with a workspace folder, then open Changes from the workspace tools. The current view shows bounded, read-only Git status and unstaged and staged diffs. Use Refresh to read again, or Back to chat to return. Verify the machine and folder before interpreting the result.

Core workspace reads require host support, Python 3.9 or later, and Git for Changes. Files provides folder browsing and bounded text previews. These read-only tools do not stage, commit, discard, or edit your files. Legacy TUI exposes its supported Git and file inspection through Workspace Inspector.

A workspace diff does not identify which agent made an edit. It may include your own work and other agents’ changes. Untracked files can appear in status without a normal Git diff; large results may be limited. The current view is not a comparison against your previous visit.

Planned change-review improvements

Planned, not available yet. The following review tools are a proposed direction, with no announced release date.

  • A changed-file list and readable per-file diffs, with staged and unstaged changes distinguished.
  • Review marks that clear when a file changes again, plus a count of files still to review.
  • An explicit review baseline and a Since last review comparison that accounts for earlier uncommitted work.
  • An Ask agent about this change action that prepares an editable question for you to review before sending.

These improvements are intended to fit the existing Changes pane and familiar controls. File differences would remain separate from agent action tracking. Pull-request and check-status integration is a later area to evaluate, rather than a current capability.