Cross-platform, unofficial CLI for Cloudflare Warp
wgcf is a cross-platform command-line interface designed for managing interactions with Cloudflare Warp, offering developers and IT professionals a flexible tool for network configuration.
Key Features:
Account Registration: Quickly create new accounts for seamless integration with Cloudflare services.
License Management: Easily switch or update license keys to utilize existing Warp+ subscriptions efficiently.
WireGuard Profile Generation: Automatically generate profiles tailored for WireGuard, ensuring compatibility and optimal performance.
Status Monitoring: Check account status and troubleshoot connectivity issues with detailed trace information.
Audience & Benefits:
Ideal for developers, IT professionals, and security-conscious users seeking a robust CLI solution. wgcf provides ease of use in setting up and managing Cloudflare Warp services across various platforms. It enhances flexibility by supporting multiple configurations and ensuring compatibility with existing infrastructure, making it an essential tool for network management.
Installwgcf via winget to experience its benefits firsthand, enabling efficient command-line operations without the need for additional downloads or references.
README
wgcf
> wgcf is an unofficial, cross-platform CLI for Cloudflare Warp
Features
Register new account
Change license key to use existing Warp+ subscription
Generate WireGuard profile
Check account status
Print trace information to debug Warp/Warp+ status
Download
You can find pre-compiled binaries on the releases page.
Usage
Run wgcf in a terminal without any arguments to display the help screen. All commands and parameters are documented.
Register new account
Run the following command in a terminal:
wgcf register
The new account will be saved under wgcf-account.toml
Generate WireGuard profile
Run the following command in a terminal:
wgcf generate
The WireGuard profile will be saved under wgcf-profile.conf. For more information on how to use it, please check the official WireGuard Quick Start.
Maximum transmission unit (MTU)
To ensure maximum compatibility, the generated profile will have a MTU of 1280, just like the official Android app. If you are experiencing performance issues, you may be able to improve your speed by increasing this value. For more information, please check #40.
Add a license key
If you have an existing Warp+ subscription, for example on your phone, you can bind the account generated by this tool to your phone's account, sharing its Warp+ status. Please note that there is a limit of 5 maximum devices linked at a time. You can remove linked devices from the 1.1.1.1 app on your phone.
> [!CAUTION]
> Only subscriptions purchased directly from the official 1.1.1.1 app are supported. Keys obtained by any other means, including referrals, will not work and will not be supported.
First, get your Warp+ account license key. To view it on Android:
Open the 1.1.1.1 app
Click on the hamburger menu button in the top-right corner
> [!WARNING]
> There's a bug on Cloudflare's side that prevents existing accounts from getting Warp+ even after you bind a correct license key. If you have ever connected to Warp VPN, then your account is affected. You will need to make a new account via:
>
> wgcf register > wgcf register >
> Then immediately proceed with the steps below, without running any other commands. For more details, check !85
Connect to the WireGuard profile generated by this tool, then run:
wgcf trace
If you look at the last line, it should say warp=on or warp=plus, depending on whether you have Warp or Warp+ respectively.
> [!WARNING]
> If you're seeing warp=on even after you bound a Warp+ license key, you are likely experiencing a known bug, please refer to the Add a license key section.
Development
The API client code is auto-generated from the OpenAPI spec openapi-spec.yml and stored under the openapi/ package. Do not touch any code under that package, instead, change the spec file and regenerate the API client code. To do this, install openapi-generator, then run:
go generate
Notice of Non-Affiliation and Disclaimer
We are not affiliated, associated, authorized, endorsed by, or in any way officially connected with Cloudflare, or any of its subsidiaries or its affiliates. The official Cloudflare website can be found at https://www.cloudflare.com/.
The names Cloudflare Warp and Cloudflare as well as related names, marks, emblems and images are registered trademarks of their respective owners.
