cliftp
A dual-pane terminal FTP client that actually looks good.

cliftp is a local ↔ remote file browser for your terminal: click around with
the mouse or drive it entirely from the keyboard, upload and download with a
live progress bar, and manage remote files (mkdir/rename/delete) without
leaving the pane. No config file to write, no FTP verbs to remember.
Built with Bubble Tea and
Lip Gloss — the same stack
behind cliamp, whose rounded, boxed-in
look this borrows. Colors come from your terminal's own ANSI palette rather
than hardcoded hex, so if you're on Omarchy, cliftp
re-skins itself the moment you run omarchy theme set.
Features
- Dual-pane browser — local filesystem on one side, remote FTP on the
other, both navigable independently
- Mouse-driven — click a row to select it, double-click to open a
directory or transfer a file, scroll wheel to move around
- Full keyboard control — vim-style (
hjkl) or arrow keys, nothing
requires the mouse
- Upload / download with a live progress bar
- mkdir, rename, delete (with a confirm prompt) on either side
- Quick-connect — remembers your last connection so the next launch is
one keypress
- Theme-reactive — pulls colors from the terminal's ANSI palette, Nerd
Font icons throughout
Install
go install github.com/fush1ft/cliftp@latest
Or build from source:
git clone https://github.com/fush1ft/cliftp
cd cliftp
go build -o cliftp .
Usage
cliftp # opens the connect screen
cliftp -host ftp.example.com -user me # prefills and auto-connects
| Flag |
Default |
Description |
-host |
— |
FTP server to connect to on startup |
-port |
21 |
FTP port |
-user |
anonymous |
Username |
-pass |
— |
Password |
-local-dir |
current directory |
Where the local pane starts |
Quick-connect: after a successful connection, the host/port/username/
password are saved to ~/.config/cliftp/lastconn.json (mode 0600, in a
0700 directory). Launch cliftp with no flags next time and the connect
screen comes up prefilled — press Enter and you're in. Passing explicit
flags overrides this for that run, and saves over it on success.
Controls
Mouse: click a row to select it (and focus that pane) · double-click to
open a directory or transfer the selected file · scroll wheel to move the
cursor.
| Key |
Action |
Tab |
switch pane |
↑/↓, j/k |
move cursor |
PgUp/PgDn, Home/End (g/G) |
jump around the list |
Enter, →/l |
open directory, or transfer the selected file |
Backspace, ←/h |
go to parent directory |
Space/t |
transfer selected file (upload if local pane is active, download if remote) |
n |
new directory |
r |
rename |
x / Delete |
delete (asks to confirm) |
R |
refresh both panes |
c |
open the connect screen (reconnect / switch server) |
? |
toggle full keybind help |
q / Ctrl+C |
quit |
Limitations
- Directory transfers aren't implemented yet — files only.
- One transfer at a time; other network actions are blocked while it's in
flight (the FTP connection itself isn't safe for concurrent use).
- Plain FTP only — no FTPS/TLS yet.
Credits
- cliamp for the terminal-Winamp look
that inspired the panel styling
- Charm for Bubble Tea, Lip Gloss, and Bubbles
- jlaffaye/ftp for the FTP client library
License
MIT