wgcf is a cross-platform CLI tool that enables users to register, manage, and generate WireGuard profiles for Cloudflare Warp and Warp+ VPN services.
🚤 Cross-platform, unofficial CLI for Cloudflare Warp
This tool is primarily used by individuals who want to create and manage Cloudflare Warp VPN accounts and generate WireGuard configuration profiles for secure network connections. It is especially useful for users who want to leverage Warp+ subscriptions on multiple devices or automate VPN profile generation and status monitoring via the command line.
Only Warp+ subscriptions purchased directly from the official 1.1.1.1 app are supported; referral or unofficial keys will not work. There is a maximum limit of 5 devices linked per Warp+ subscription. When adding a license key, an existing account must be deleted and re-registered before updating and generating profiles. The generated WireGuard profile uses an MTU of 1280 for compatibility, which can be adjusted if performance issues arise.
Download pre-compiled binaries from the releases page: https://github.com/ViRb3/wgcf/releases
Run the wgcf executable in a terminal to access the CLI
No additional installation commands are specified in the READMEwgcf register
Registers a new Cloudflare Warp account and saves it to wgcf-account.toml
wgcf generate
Generates a WireGuard profile saved as wgcf-profile.conf for use with the Warp VPN
wgcf update
Updates the account information, typically used after adding a Warp+ license key
wgcf status
Displays the current status of the Warp device/account
wgcf trace
Prints trace information to verify if Warp or Warp+ is active