Ruggi Tools

Two small command-line suites that came out of building AI Cockpit. Neither needs Cockpit, neither needs root, and both are free. The Cockpit installer offers them; you can also just download them.

ftpsuite — scripted deploys to a site you own

ftpush · ftpull · ftps-cli · ftps-gui

Four tools over one config. You define sites and pairs — a local directory mapped to a remote one — and from then on you push and pull by pair number instead of retyping paths and passwords. ftpush -p3 index.php puts the file where that pair says it goes.

Paths resolve by pair, not by where you are. A relative path is a path inside the mirror; the directory you happen to be in is never used. An absolute path matches a pair by longest prefix.
Live progress. A spinner, a percentage and a file count while the transfer runs — written to the terminal, so a long upload never looks like a hang, and never clutters a log file.
Both directions, same config. ftpull is the mirror image of ftpush: same sites, same pairs, opposite direction, plus --mirror to bring a whole pair down.
Two front-ends. ftps-cli builds a queue of transfers across several sites and runs them in one go; ftps-gui is a two-pane windowed file browser. Both share the same config and the same transfer logic.
Credentials stay put. The config is chmod 600 and never passed on a command line. Passwords are masked as you type them, kept out of the eval text so a failure can't print them, and redacted when a config is printed to screen — a full export has to be written to a file, which is created 0600.

ftpsuite page & download

secretsuite — encrypted credential sheets

secrets · secrets-cli · secrets-gui

A place to keep the keys and logins you would otherwise have in a text file: a GPG-encrypted Markdown sheet you edit like any document. The point of it is the one line in bold below.

Plaintext is never written to disk. secrets edit decrypts into RAM, opens your editor there, re-encrypts and wipes — so there is no moment where the decrypted sheet is sitting in your home directory waiting to be backed up by something.

Several stores. One for work, one for personal, one per machine — each with its own passphrase.
Templates. Start a sheet from a structure instead of a blank page, and write your own with the built-in template editor.
Mirrors. Keep dated copies on other disks or a USB stick. Rotate the passphrase and older copies still open with the old one — so each copy is tagged with the generation of passphrase it needs, and secrets rekey brings them forward without destroying the history.
Archive and restore. Encrypt a whole directory into a single .tar.gz.gpg and unpack it again.
Scan. Find credential files already lying loose on your disks — usually more than you expect.
Two front-ends. secrets-cli is a menu-driven terminal UI; secrets-gui is a windowed one. Both drive the same secrets command, so there is one implementation and no second way for things to go wrong.

secrets page & download

What these are, and what they are not

These are personal tools that got tidied up, not products. They exist because building Cockpit needed them: something to deploy the site without retyping credentials, and somewhere to keep the credentials that was not a text file.

secrets is a credential sheet, not a password manager — no browser integration, no autofill, no sync service. It is the thing you open at 3am when the password manager itself is what you cannot get into. If you want a password manager, use one; this sits underneath it.

ftpsuite speaks FTP/FTPS through lftp. If your host offers SFTP or rsync over SSH, those are better protocols — use them. This exists for the hosts that don't.

Installing

The AI Cockpit installer offers both, optionally, after Cockpit itself is set up — no root needed for either. Or install them on their own: each tarball carries its own installer.

tar xzf ftpsuite.tar.gz && sh ftpsuite/ftpsuite-install.sh
tar xzf secrets.tar.gz  && sh secretsuite/secrets-install.sh

Both install into ~/.local/bin with man pages, and both have an --uninstall that leaves your data alone.

All tools on ruggi.site Get AI Cockpit