coder

wush: Transfer Files and Open Shells Over WireGuard

wush is a command-line tool for transferring files and opening remote shells over peer-to-peer WireGuard connections. It suits people who need a direct, authenticated connection without setting up a relay or relying on a third-party authentication server.

View on GitHub Compare
Stars
1.5k
Forks
48
Stars, last 30 days
+0

Our take

Health score

26/100

How it is scored
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.

Selected snapshot

Stars

1,496

Forks

49

Change 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 tsnet package.
  • 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.
ProjectLanguageLicenseStarsStatus
wushGoCC0-1.01.5kNot checked yet
magic-wormholePythonMIT23kActive
tailscaleGoBSD-3-Clause37.7kActive

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_ADMIN to 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.

Comparisons