Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Topgrade

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
7.3 Club score Visit github.com

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

Topgrade

Free

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.