mossferry
<p align="center" <a href="https://mossferry.muslewski.com"<img src="https://img.shields.io/badge/website-mossferry.muslewski.com-3dff9a?style=flat-square&labelColor=02060c" alt="Website"</a </p
<p align="center" <a href="https://www.npmjs.com/package/mossferry"<img src="https://img.shields.io/npm/v/mossferry?style=flat-square" alt="npm"</a <a href="https://github.com/muslewski/mossferry/discussions"<img src="https://img.shields.io/badge/discussions-join-3dff9a?style=flat-square&labelColor=02060c" alt="Discussions"</a <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT" </p
<p align="center" <a href="https://mossferry.muslewski.com"<img src="https://raw.githubusercontent.com/muslewski/mossferry-website/main/public/mossferry4.webp" alt="mossferry spore" width="360"</a </p
<p align="center"<bSite:</b <a href="https://mossferry.muslewski.com"mossferry.muslewski.com</a</p
The green ferry between your machines. Moss carries the green identity and the mosh phonetics; ferry is the job — carrying you across to your remote tmux sessions. Short daily command: ferry.
|>
__|__ __
__|_o_o_|__ / _|___ _ _ _ _ _ _
_|___________|_ | _/ -_) '_| '_| || |
\ o o o / |_| \___|_| |_| \_, |
~~~\_____________/~~~~~~~~~~~~~~~~~~~~~~~~ |__/ ~~<p align="center"<img src="./assets/demo-picker.gif" width="720" alt="ferry picker demo"</p
---
A two-part tool for opening remote tmux sessions over mosh. Host-agnostic: written for a laptop ↔ workstation pair, but nothing is hard-coded to those machines.
┌──────────── local ────────────┐ ┌──────────── remote ───────────┐
│ bin/mossferry │ mosh │ bin/repo-session │
│ - parse args / config │ ──ssh──▶│ - fzf (or menu) session picker│
│ - launch mosh or ssh │ │ - create / attach / claim │
│ - update, doctor │ │ - all tmux logic │
└───────────────────────────────┘ └───────────────────────────────┘Installed paths are symlinks into this repo, so git pull is deploy.
Safety (door, not building)
mossferry is the hop into remote tmux — not an agent sandbox or secrets manager. Host AI-session safety (trust tiers, YOLO sandboxes, env hygiene) stays on the machine you land on.
Coming soon: optional share/preview modes and clearer doctor guidance. See docs/safety-roadmap.md for the boundary and planned nits. Vulnerability reporting: SECURITY.md.
Name origin
mossferry was chosen after the previous short name collided hard with a popular speech model (owning PyPI/crates) and a mobile SSH/mosh terminal in the same space. The name is clean on npm, crates.io, PyPI, Homebrew, AUR, and GitHub. Identity color: green.