[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94884":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":9,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":14,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":16,"hasPages":16,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":18,"readmeContent":19,"aiSummary":20,"trendingCount":14,"starSnapshotCount":14,"syncStatus":21,"lastSyncTime":9,"discoverSource":22},94884,"wgcf","ViRb3\u002Fwgcf","ViRb3","🚤 Cross-platform, unofficial CLI for Cloudflare Warp",null,"https:\u002F\u002Fgithub.com\u002FViRb3\u002Fwgcf","Go",8611,867,0,61.82,false,"main","2026-08-24 04:01:22","# wgcf\n> wgcf is an unofficial, cross-platform CLI for [Cloudflare Warp](https:\u002F\u002F1.1.1.1\u002F)\n\n![](https:\u002F\u002Fimg.shields.io\u002Fdrone\u002Fbuild\u002FViRb3\u002Fwgcf)\n![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FViRb3\u002Fwgcf)\n![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002FViRb3\u002Fwgcf\u002Ftotal)\n![](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Fcode-size\u002FViRb3\u002Fwgcf)\n\n## Features\n- Register new account\n- Change license key to use existing Warp+ subscription\n- Generate WireGuard profile\n- Check account status\n- Print trace information to debug Warp\u002FWarp+ status\n\n## Download\nYou can find pre-compiled binaries on the [releases page](https:\u002F\u002Fgithub.com\u002FViRb3\u002Fwgcf\u002Freleases).\n\n## Usage\nRun `wgcf` in a terminal without any arguments to display the help screen. All commands and parameters are documented.\n\n### Register new account\nRun the following command in a terminal:\n```bash\nwgcf register\n```\nThe new account will be saved under `wgcf-account.toml`\n\n### Generate WireGuard profile\nRun the following command in a terminal:\n```bash\nwgcf generate\n```\nThe WireGuard profile will be saved under `wgcf-profile.conf`. For more information on how to use it, please check the official [WireGuard Quick Start](https:\u002F\u002Fwww.wireguard.com\u002Fquickstart\u002F).\n\n#### Maximum transmission unit (MTU)\nTo 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](https:\u002F\u002Fgithub.com\u002FViRb3\u002Fwgcf\u002Fissues\u002F40).\n\n### Add a license key\n\nIf 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.\n\n> [!CAUTION]\n> 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.\n\nFirst, get your Warp+ account license key. To view it on Android:\n1. Open the `1.1.1.1` app\n2. Click on the hamburger menu button in the top-right corner \n3. Navigate to: `Account` > `Key`\n\nNow, back to wgcf.\n\n> [!WARNING]\n> 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:\n>\n> ```wgcf register\n> wgcf register\n> ```\n> Then immediately proceed with the steps below, without running any other commands. For more details, check [!85](https:\u002F\u002Fgithub.com\u002FViRb3\u002Fwgcf\u002Fissues\u002F85)\n\nRun the following commands:\n\n```bash\nwgcf update --license-key \"YOUR_LICENSE_KEY_GOES_HERE\"\nwgcf generate\n```\n\n\n### Check device status\nRun the following command in a terminal:\n```bash\nwgcf status\n```\n\n### Verify Warp\u002FWarp+ works\nConnect to the WireGuard profile [generated](#generate-wireguard-profile) by this tool, then run:\n```bash\nwgcf trace\n```\nIf you look at the last line, it should say `warp=on` or `warp=plus`, depending on whether you have Warp or Warp+ respectively.\n\n> [!WARNING]\n> 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](#add-a-license-key) section.\n\n## Development\nThe API client code is auto-generated from the OpenAPI spec [openapi-spec.yml](openapi-spec.yml) and stored under the [openapi\u002F](openapi\u002F) 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](https:\u002F\u002Fopenapi-generator.tech\u002Fdocs\u002Finstallation), then run:\n\n```bash\ngo generate\n```\n## Notice of Non-Affiliation and Disclaimer\nWe 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:\u002F\u002Fwww.cloudflare.com\u002F.\n\nThe names Cloudflare Warp and Cloudflare as well as related names, marks, emblems and images are registered trademarks of their respective owners.\n","wgcf 是一个跨平台的非官方命令行工具，用于管理和配置 Cloudflare Warp 服务。它支持注册新 Warp 账户、绑定 Warp+ 许可证密钥、生成标准 WireGuard 配置文件（.conf）、查询账户状态及网络链路追踪信息。基于 Go 编写，无需依赖 Cloudflare 官方客户端，直接与 Warp 后端协议交互，生成的配置兼容各平台 WireGuard 实现。适用于希望在桌面系统（Linux\u002FmacOS\u002FWindows）或服务器上以轻量方式使用 Warp 或 Warp+ 加速网络流量的用户，尤其适合自动化部署、脚本集成或无图形界面环境。",2,"trending"]