Topgrade
github.com
- Free plan
- Windows
- macOS
- Linux
What Topgrade is
Topgrade is a free command-line tool that detects the tools in use on a system and runs the commands needed to update them. Run it with the `topgrade` command. The project offers self-updating binaries, source installation and package-manager options for its supported platforms, which include macOS, Windows, Linux and FreeBSD. Its example configuration covers Arch package managers, DNF, Nix, Homebrew, Flatpak and Winget. Topgrade can pull or fetch selected Git repositories, and custom commands can run before, during or after its built-in commands. It can also connect over SSH to run Topgrade on configured remote hosts before working locally. On its first run, it creates a configuration file if one is missing and merges in files from `topgrade.d`. The project describes itself as a maintained fork of r-darwish's Topgrade. Its example configuration advises against running it as root on Unix; only the latest version is supported, and fixes are not backported.
Who it suits
Topgrade suits users who want to update multiple tools from a command-line workflow across supported operating systems. Its remote execution, Git repository settings and custom commands may also suit people managing configured hosts or update routines.
Good to know, and what to watch
- Detects tools and runs their update commands
- Supports macOS, Windows, Linux and FreeBSD
- Includes multiple package-manager integrations
- Can run custom commands around built-in updates
- Can use SSH on configured remote hosts
- Requires a command-line workflow
- Example configuration advises against running as root on Unix
- Only the latest version is supported
- Fixes are not backported
Plans
Every plan and priceTopgrade
Free plan
The verdict
Topgrade brings updates for supported tools into a configurable command-line workflow, with options for repositories, custom commands and remote hosts. Users should note its Unix privilege guidance and that older versions do not receive backported fixes.
What the maker publishes
- CLI workflow
- The project README says to run Topgrade with the `topgrade` command. source
- Configuration
- On first run, Topgrade creates a configuration file if one does not already exist, and it also loads and merges files from `topgrade.d`. source
- Custom commands
- Custom commands can be configured to run before, during, or after Topgrade's built-in commands. source
- Git repositories
- Topgrade can pull or fetch predefined and user-configured Git repositories, with a setting to choose fetch instead of pull. source
- Install options
- The project lists self-updating binaries and source installation for all platforms, plus package-manager installation options. source
- Package integrations
- The example configuration includes settings for Arch package managers, DNF, Nix, Homebrew, Flatpak, and Winget. source
- Privilege guidance
- The example configuration says Topgrade should not be run as root on Unix because it invokes sudo or an equivalent where needed. source
- Project history
- The repository describes this project as a fork of r-darwish's Topgrade that aims to keep it maintained. source
- Purpose
- Topgrade detects the tools you use and runs the appropriate commands to update them. source
- Remote execution
- Topgrade can use SSH to run Topgrade on configured remote hosts before acting locally. source
- Security reporting
- The security policy directs vulnerability reports to the repository's Security tab. source
- Support and community
- The project invites users to open an issue or discussion for questions and provides a Discord server for discussion. source
- Supported operating systems
- The release page provides binaries for Apple macOS, Windows, Linux, and FreeBSD. source
- Supported versions
- The security policy says only the latest Topgrade version is supported and fixes are not backported. source
Checked against the maker's pages on 30 Sept 2026.