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.