What is wos-giftcode-cli?

This project is a command line tool that automatically redeems gift codes for the mobile game Whiteout Survival. If you play that game, you know publishers regularly release reward codes that give you free in game items, but you have to manually type them in before they expire. This tool does that work for you. It comes in two versions, one written in Go and one in Node.js, so you can pick whichever runtime you already have installed. The tool checks two websites for active codes, filters out any that have already expired, and then submits the remaining ones on your behalf using your player ID. It keeps a local history file so it never tries to redeem the same code twice, which keeps it fast and avoids hitting the game's servers with repeat requests. One notable part of the design is how it handles the CAPTCHA challenge the game shows during redemption. Instead of paying for a commercial CAPTCHA solving service, it runs an offline image recognition model on your own machine to read and solve the CAPTCHA automatically, with a fallback to solving it by hand if the automatic attempt fails. You can run it once manually, or set it up with cron, a standard scheduling tool on Mac and Linux, so it checks for and redeems codes every day without you doing anything. Setup involves copying a helper script, saving your player ID to a config file, and adding one line to your crontab. The project also includes GitHub Actions workflows that automatically build and test the code, and produce downloadable binaries for macOS, Linux, and Windows whenever a new version is tagged. It is released under the GNU General Public License version 3, which means anyone can use, modify, and redistribute it as long as derivative works stay under the same open license.