Our take
- Activity
- 19
- Community
- 43
- Issues
- 21
- Pull requests
- 20
+0 stars in the last 30 days
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,496Forks
49Change since Nov 16, 2026: -1 stars·0 forks
Overview
wush connects two computers through a WireGuard overlay so users can transfer files or open a shell on a remote host. It addresses the need for a simple way to move files and access a machine without limiting the connection to file transfer alone.
Connections use UDP hole punching when possible, with Tailscale's public DERP relays as an alternative. Authentication uses keys generated by wush serve; no Tailscale account is required. The tool is a fit for developers and other technical users comfortable with a command-line workflow and sharing an authentication key securely.
Key Features
- Transfers files between computers with
wush cp. - Opens a remote shell with
wush ssh. - Creates a peer-to-peer WireGuard connection using Tailscale's
tsnetpackage. - Attempts direct UDP connections through NAT hole punching, with DERP relay connectivity as an alternative.
- Uses generated keys to authenticate incoming connections without a third-party authentication server.
- Can support other network tools, such as rsync and ssh, over the overlay.
Use Cases
- A developer needs to send a large file to another computer without setting up a file-sharing service.
- A user wants command-line access to a remote host for a short-lived task.
- A small team needs to move files or access machines directly, and can exchange authentication keys securely.
- A technical user wants a WireGuard-based connection that can also carry tools such as rsync, rather than a file-transfer-only workflow.
Getting Started
Install with Homebrew:
brew install wush
Run wush serve on the host, then use the generated authentication key with client commands such as wush cp or wush ssh. See the README for installation alternatives, usage details, and networking notes.
Alternatives
- magic-wormhole: Magic Wormhole transfers files using one-time codes, while wush also opens remote shells over peer-to-peer WireGuard connections.
- Tailscale: Tailscale provides a managed WireGuard network with SSH and file sharing, rather than wush’s direct peer-to-peer transfer and shell workflow.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| wush | Go | CC0-1.0 | 1.5k | Not checked yet |
| magic-wormhole | Python | MIT | 23k | Active |
| tailscale | Go | BSD-3-Clause | 37.7k | Active |
Considerations
- Direct UDP connectivity depends on NAT conditions. The README notes that hole punching will not work when the receiver is behind hard NAT; DERP relays provide another connection path.
- The project uses Tailscale's public DERP relays, even though it does not require a Tailscale account.
- Authentication keys contain sensitive key material. Share them only with intended clients.
- On Linux, the installer sets
CAP_NET_ADMINto help increase UDP socket buffer sizes. Manual installations may need this capability for best performance.
Found this useful?
Share it with someone who would like wush.