ferry

A dual-pane SFTP client for the terminal. Think FileZilla, minus the GUI.

Built with Go and Bubble Tea. Linux and macOS.

Install

go install github.com/Ichihiroy/ferry@latest

Usage

ferry                          # open the site picker
ferry deploy@example.com       # connect directly
ferry me@host:2222/var/www     # custom port and start directory

Authentication uses your existing SSH setup: keys loaded in ssh-agent, then ~/.ssh/id_ed25519, id_ecdsa, id_rsa. Passphrase-protected keys must be added to the agent first (ssh-add). Host keys are checked against ~/.ssh/known_hosts; unknown hosts show their fingerprint and ask before being trusted.

Saved sites live in ~/.config/ferry/sites.yaml.

Keys

Site picker

Key	Action
enter	Connect
a	Add site
e	Edit site
d	Delete site
l	Local-only mode (both panes on this machine)
q	Quit

File browser

Key	Action
tab	Switch pane
↑ ↓ j k	Move
enter → l	Open directory
backspace ← h	Parent directory
space	Mark / unmark
t	Transfer marked (or current) to other pane
n	New directory
r	Refresh both panes
Q	Open transfer queue
esc	Clear marks
q	Quit

Queue

Key	Action
x	Cancel job
c	Clear finished
esc	Back

Directories transfer recursively. Transfers run one at a time in the background while you keep browsing.