An experimental Windows and macOS CLI for managing World of Warcraft: Forever add-ons from downloaded ZIPs. Preview changes, manage related folders together, and recover interrupted operations. No API key is needed.
Install Git and Rust 1.91 or newer with Cargo, then run:
git clone https://github.com/nu-sync/wowza.git
cd wowza
cargo install --locked --path .
wowza configure 'C:\battlenet\World of Warcraft\_forever_'On macOS, run the same commands in Terminal and configure '/Applications/World of Warcraft/_forever_'.
Use your game installation root, not its Interface\AddOns folder. Wowza remembers it. Use --path '<installation>' to override it for one command.
wowza status
wowza status --verbosewowza shows a quick-start guide without reading the installation. wowza status shows packages, problems, and suggested next steps. Existing add-ons installed outside Wowza remain unmanaged; there is no import command yet.
Examples of popular add-ons with Forever releases listed on CurseForge (checked 2026-11-06):
| Add-on | Useful for | Find it with Wowza |
|---|---|---|
| Questie | Quest guidance | wowza search "Questie" |
| Leatrix Plus | Quality-of-life interface tweaks | wowza search "Leatrix Plus" |
| Leatrix Maps | Map enhancements | wowza search "Leatrix Maps" |
| Bagnon | Combined bag and bank displays | wowza search "Bagnon" |
| Auctionator | Auction-house tools and item values | wowza search "Auctionator" |
These commands open CurseForge in your browser. For agents, wowza search "Questie" --url prints only the link; --json returns a structured URL handoff. The agent retrieves page content with its own browsing tools.
Download a ZIP and verify that its release targets Forever. Wowza does not download releases or establish compatibility. Preview and install it, replacing the example path with your downloaded ZIP:
wowza install 'C:\Downloads\addon.zip' --dry-run
wowza install 'C:\Downloads\addon.zip'Wowza shows the affected folders and asks before applying a change.
Use a folder name from a package installed through Wowza:
wowza update MyAddon 'C:\Downloads\new-release.zip'
wowza remove MyAddonFor updates, choose a ZIP from the same project with the same folder names. Both commands affect the whole package, preserve saved settings, and retain the original files. Modified packages are refused.
wowza pending
wowza recoverRecovery previews the interrupted operation and asks for confirmation. If several operations are pending, use the command printed by pending. Recovery does not undo completed updates or removals.
Keep the game and other add-on managers closed during changes, and keep backups.
Add --dry-run to preview a change, --yes to skip its confirmation, or --json for structured output. JSON package changes require --yes or --dry-run.
Run wowza --help for all commands. See the command reference for options and limits, or Repository Guidelines to contribute. Report problems in GitHub Issues. Licensed under MIT.