> For the complete documentation index, see [llms.txt](https://docs.flatredball.com/gum/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flatredball.com/gum/gum-tool/upgrading.md). # Upgrading ## Introduction The Gum tool and Gum NuGet packages are updated frequently. Most updates to both require no changes in your project. This page explains how to upgrade. See the subsections for upgrading between different versions to make sure you can upgrade safely. ## How to Upgrade If you are upgrading to a new version, you should read the upgrade documentation for all versions up to the version you are upgrading. For example, if you are upgrading from October 2025 to January 2026, then you should read the following documents: * November 2025 * December 2025 * January 2025 Of course, you do not need to actually upgrade to each individual month along the way, but each month may introduce changes which are important for your project. ## Upgrading the Gum Tool The Gum tool is distributed as an archive (a `.zip` on Windows, a `.tar.xz` on macOS and Linux) which is not installed on your machine. Therefore, to upgrade Gum, you need to delete the folder that contains the extracted files, download the latest archive for your operating system, and extract it. The archives and the per-OS steps are on the [Setup](/gum/gum-tool/setup.md) page. Releases after September 2, 2026 are the native cross-platform tool (`Gum.exe` on Windows, `Gum.app` on macOS, `Gum` on Linux; some September 2026 pre-releases named it `Gum.Avalonia`). Releases up to September 2, 2026 were the Windows-only WPF tool (`Gum.zip` with `Gum.exe`). Both open the same project files, save the same files, and generate the same code, so upgrading from one to the other needs no project changes; only plugins written against the WPF tool need to be migrated (see [Plugins](/gum/gum-tool/plugins.md)). The latest releases, including pre-releases, can be found on the [GitHub Releases](https://github.com/vchelaru/Gum/releases) page. All previous releases can be found on the GitHub Releases page in case you need to run an old version. ## Upgrading NuGet Packages Gum frequently upgrades the NuGet packages with enhancements and bug fixes. To upgrade your project, upgrade the latest NuGet package through Visual Studio or the command line. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.flatredball.com/gum/gum-tool/upgrading.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.