# Diniboy1123/usque

Open-source reimplementation of the Cloudflare WARP client's MASQUE protocol.

Repository: https://github.com/Diniboy1123/usque
Canonical: https://ross.abutalabs.com/products/usque
Language: Go
License: MIT
License Family: permissive
Topics: masque, proxy, quic, socks5, tunnel, vpn-client, warp, connect-ip
Last push: 2026-07-20T06:43:48+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 93, release rhythm 93, longevity 39
- inputs: {"age_days": 559, "days_push": 44, "days_rel": 44, "gap_med": 6, "n_releases_24m": 22}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1361, forks 166 (observed 2026-08-28T04:04:30.089753+00:00)

## What it is
An open-source Go reimplementation of the Cloudflare WARP client's MASQUE mode using the Connect-IP (RFC 9484) protocol. It offers multiple operation modes including a native IP tunnel, SOCKS5 and HTTP proxies, and TCP-only L4 proxy variants.

## Use cases
- route traffic through Cloudflare WARP without the official client
- run a local SOCKS5 proxy backed by WARP's MASQUE protocol
- set up a native TUN-based VPN tunnel on Linux or Windows
- circumvent network censorship using QUIC-based MASQUE tunneling
- forward specific ports over a WARP connection
- enroll with Cloudflare Zero Trust from a custom client

## When to choose
- you want a lightweight, scriptable alternative to the official WARP client
- you need SOCKS5/HTTP proxy access to WARP instead of a full VPN tunnel
- you're on Linux and want native MASQUE tunnel support
- you need censorship circumvention via QUIC/Connect-IP

## When to avoid
- you need a fully supported, production-hardened VPN across all platforms
- you want WireGuard-style simplicity and broad tooling compatibility
- you require guaranteed support since only Linux amd64 is well tested

## Facets
- artifact type: cli-tool
- maturity: active
- function: proxy, vpn, networking, cryptography
- domain: privacy, censorship-circumvention, networking, security
- platform: windows, cross-platform, cli
- tags: masque, cloudflare-warp, quic, connect-ip, socks5, http-proxy, tunnel, go, linux, macos, android, docker

## Member repositories
- Diniboy1123/usque (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:30.089753+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:33.055219+00:00, confidence not recorded.
  - readme: https://github.com/Diniboy1123/usque (fetched 2026-08-28T04:04:30.089753+00:00, sha 3b5e881e7063)
- Data as of 2026-08-30T08:39:29.467469+00:00.