Early-stage software. Shurli is experimental and built with AI assistance. It will have bugs. Not recommended for production or safety-critical use. Read the disclaimer.
Documentation
Quick Start

Quick Start

Path A: Joining someone’s network

If someone shared an invite code with you:

# Install (or build from source: go build -o shurli ./cmd/shurli)
shurli join <invite-code> --name laptop

That’s it. You’re connected and mutually authorized.

Path B: Setting up your own network

1. Set up both machines:

go build -o shurli ./cmd/shurli
shurli init

2. Pair them (on the first machine):

shurli invite --name home
# Shows invite code + QR code, waits for the other side...

3. Join (on the second machine):

shurli join <invite-code> --name laptop

4. Use it:

# On the server - start the daemon with services exposed
shurli daemon

# On the client - connect to a service
shurli proxy home ssh 2222
ssh -p 2222 user@localhost

Path C: Relay-managed group setup

If a relay admin shared a pairing code:

shurli join <pairing-code> --name laptop
# Connects to relay, discovers other peers, auto-authorizes everyone
# Shows SAS verification fingerprints for each peer

The relay admin generates codes with shurli relay pair --count 3 (for 3 peers). Each person joins with one command. Everyone in the group is mutually authorized and verified.

Relay server: All machines connect through a relay for NAT traversal. See Relay Setup guide for deploying your own. Run shurli relay serve to start a relay.

Disclaimer

Shurli is experimental software under active development. It is built with significant AI assistance (Claude) and, despite thorough testing, will contain bugs that neither automated tests nor manual testing have caught.

By using this software, you acknowledge:

  • This is provided “as is” with no warranty of any kind (see LICENSE)
  • The developers are not liable for any damages, losses, or consequences arising from its use
  • Network tunnels may disconnect, services may become unreachable, and configurations may behave unexpectedly
  • This is not a replacement for enterprise VPN, firewall, or security infrastructure
  • You are responsible for evaluating whether Shurli is suitable for your use case

If you discover a bug, please open an issue. Every report makes the project more reliable for everyone.

Network Tools