Omarchy-Send - A Terminal LocalSend Client That AI Agents Can Use

This started as a side quest and turned into one of the most useful things I've built. omarchy-send is a terminal-based LocalSend protocol client — a full TUI client that implements the documented LocalSend protocol, works on your desktop, on headless servers, and over the cloud, and crucially works with AI agents from the command line. https://www.no-signal.uk you can buy me a coffee to help with channel https://buymeacoffee.com/gnugent subscribe for updates Subscribe for more reviews and videos    / @28allday   or become a member    / @28allday   You can download Omarchy here https://omarchy.org Amazing premade Omarchy themes here and other cool stuff https://github.com/OldJobobo https://github.com/bjarneo https://github.com/HANCORE-linux The official LocalSend client is brilliant but it's GUI only — it doesn't run headless. If you're on OmaTerm on a remote box or a dev server with no desktop, you're stuck with SCP, network shares, and fiddly transfer protocols. So I built a TUI LocalSend protocol client that completely replaces LocalSend on Omarchy and runs anywhere, including machines with no GUI at all. WHAT IT IS A LocalSend protocol client in your terminal. TUI with tabs for transfers, devices, messages, and settings. Set an alias, optionally a PIN, toggle auto-accept. Files don't dump into your downloads — they go into a dedicated omarchy-send folder so everything stays organised. Because it speaks the documented LocalSend protocol, it interoperates with the standard LocalSend client on your phone or Mac. Send a file from the official LocalSend app on your Mac to your Omarchy box and it lands in the omarchy-send folder. Right-click any file on your Omarchy desktop and send it back. Same protocol, same network discovery — but as a terminal client it also runs on headless machines, which the official GUI client can't. THE AI INTEGRATION This is where it gets interesting. The installer drops in a Claude skill, so Claude Code on any machine knows how to drive the client. I shorthand the command to OSF. So you can tell Claude on a remote box "send a file to Gav" or "convert this image to PNG and send it back" and it just does it. In the video I've got three machines talking through the protocol — my local media server, a bare OmaTerm box in the cloud over Tailscale, and my Mac laptop running the official LocalSend client. I move files between all of them using natural language to Claude. THE KILLER USE CASE When I was cleaning up my MP3 collection — years of CD rips full of duplicates — I fired the whole lot at the media server through the client, then set Claude loose to find duplicates, delete them, catalogue everything, and push it to Jellyfin. I stepped back, let it run, and got a notification when it was done. AI processing files across machines while you do something else. For agentic coding it's just as useful. Agents need visual references and code bases. Offload work to a remote machine, have it processed, shipped back, all without leaving your desktop. INSTALL Clone from Git, run the one-line install. It asks whether you're installing local or remote. Local is fine for your desktop and home network. Remote is for cloud boxes and only works over Tailscale on a locked-down port. CLOUD WARNING If you put the client on a cloud box, know what you're doing with firewalls. It should only work over Tailscale. Lock down your ports — I obfuscate SSH off port 22 and route everything through Tailscale so nothing's exposed. Don't put this on a wide-open VPS. THE SCRIPT On Git and linked from no-signal.uk. Questions in the comments, issues and PRs on Git. ABOUT THIS CHANNEL I make videos about Linux, Omarchy, self-hosting, dev tools, and AI workflows. Subscribe if that's your thing. 00:00 - Start 00:13 - PREAMBLE 03:28 - INSTALL 10:01 - REMOTE SEND 17:14 - FINAL WORDS