.ie \n(.g .ds Aq \(aq .el .ds Aq ' .TH topgrade 1 "topgrade 17.12.2" .SH NAME topgrade .SH SYNOPSIS \fBtopgrade\fR [\fB\-\-edit\-config\fR] [\fB\-\-config\-reference\fR] [\fB\-t\fR|\fB\-\-tmux\fR] [\fB\-\-no\-tmux\fR] [\fB\-c\fR|\fB\-\-cleanup\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-r\fR|\fB\-\-run\-type\fR] [\fB\-\-no\-ask\-retry\fR] [\fB\-\-auto\-retry\fR] [\fB\-\-disable\fR] [\fB\-\-only\fR] [\fB\-\-custom\-commands\fR] [\fB\-\-env\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-k\fR|\fB\-\-keep\fR] [\fB\-\-notify\-end\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-disable\-predefined\-git\-repos\fR] [\fB\-\-config\fR] [\fB\-\-remote\-host\-limit\fR] [\fB\-\-show\-skipped\fR] [\fB\-\-allow\-root\fR] [\fB\-\-sudoloop\fR] [\fB\-\-sudoloop\-interval\fR] [\fB\-\-log\-filter\fR] [\fB\-\-no\-self\-update\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] .SH DESCRIPTION .SH OPTIONS .TP \fB\-\-edit\-config\fR Edit the configuration file .TP \fB\-\-config\-reference\fR Show config reference .TP \fB\-t\fR, \fB\-\-tmux\fR Run inside tmux .TP \fB\-\-no\-tmux\fR Don\*(Aqt run inside tmux .TP \fB\-c\fR, \fB\-\-cleanup\fR Cleanup temporary or old files .TP \fB\-n\fR, \fB\-\-dry\-run\fR Print what would be done Alias for \-\-run\-type dry .TP \fB\-r\fR, \fB\-\-run\-type\fR \fI\fR [default: wet] Pick between just running commands, running and logging commands, and just logging commands .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 dry: Executing commands will just print the command with its arguments .IP \(bu 2 wet: Executing commands will perform actual execution .IP \(bu 2 damp: Executing commands will print the command and perform actual execution .RE .TP \fB\-\-no\-ask\-retry\fR Do not ask what to do after a step fails .TP \fB\-\-auto\-retry\fR \fI\fR Automatically retry failed steps up to COUNT times .TP \fB\-\-disable\fR \fI...\fR Do not perform upgrades for the given steps .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 am .IP \(bu 2 adless .IP \(bu 2 android_studio .IP \(bu 2 antigravity .IP \(bu 2 antigravity_cli .IP \(bu 2 app_man .IP \(bu 2 app_manager .IP \(bu 2 aqua .IP \(bu 2 asdf .IP \(bu 2 atom .IP \(bu 2 atuin .IP \(bu 2 audit .IP \(bu 2 auto_cpufreq .IP \(bu 2 bin .IP \(bu 2 bob .IP \(bu 2 brew_cask .IP \(bu 2 brew_formula .IP \(bu 2 bun .IP \(bu 2 bun_packages .IP \(bu 2 cargo .IP \(bu 2 certbot .IP \(bu 2 chezmoi .IP \(bu 2 chocolatey .IP \(bu 2 choosenim .IP \(bu 2 cinnamon_spices .IP \(bu 2 clam_av_db .IP \(bu 2 claude_code .IP \(bu 2 claude_code_plugins .IP \(bu 2 codex .IP \(bu 2 colima .IP \(bu 2 composer .IP \(bu 2 conda .IP \(bu 2 config_update .IP \(bu 2 containers .IP \(bu 2 cursor .IP \(bu 2 cursor_agent .IP \(bu 2 custom_commands .IP \(bu 2 deb_get .IP \(bu 2 deno .IP \(bu 2 distrobox .IP \(bu 2 dkp_pacman .IP \(bu 2 dotnet .IP \(bu 2 elan .IP \(bu 2 emacs .IP \(bu 2 falconf .IP \(bu 2 firmware .IP \(bu 2 flatpak .IP \(bu 2 flutter .IP \(bu 2 fossil .IP \(bu 2 gcloud .IP \(bu 2 gearlever .IP \(bu 2 gem .IP \(bu 2 getnf .IP \(bu 2 ghcup .IP \(bu 2 git_repos .IP \(bu 2 github_cli_extensions .IP \(bu 2 gnome_shell_extensions .IP \(bu 2 go .IP \(bu 2 guix .IP \(bu 2 haxelib .IP \(bu 2 helix .IP \(bu 2 helix_db .IP \(bu 2 helm .IP \(bu 2 hermes_agent .IP \(bu 2 home_manager .IP \(bu 2 hyprpm .IP \(bu 2 install_release .IP \(bu 2 jetbrains_aqua .IP \(bu 2 jetbrains_clion .IP \(bu 2 jetbrains_datagrip .IP \(bu 2 jetbrains_dataspell .IP \(bu 2 jetbrains_gateway .IP \(bu 2 jetbrains_goland .IP \(bu 2 jetbrains_idea .IP \(bu 2 jetbrains_mps .IP \(bu 2 jetbrains_phpstorm .IP \(bu 2 jetbrains_pycharm .IP \(bu 2 jetbrains_rider .IP \(bu 2 jetbrains_rubymine .IP \(bu 2 jetbrains_rustrover .IP \(bu 2 jetbrains_toolbox .IP \(bu 2 jetbrains_webstorm .IP \(bu 2 jetpack .IP \(bu 2 julia .IP \(bu 2 juliaup .IP \(bu 2 kakoune .IP \(bu 2 krew .IP \(bu 2 lensfun .IP \(bu 2 lure .IP \(bu 2 macports .IP \(bu 2 mamba .IP \(bu 2 mandb .IP \(bu 2 mas .IP \(bu 2 maza .IP \(bu 2 micro .IP \(bu 2 microsoft_office .IP \(bu 2 microsoft_store .IP \(bu 2 miktex .IP \(bu 2 mise .IP \(bu 2 myrepos .IP \(bu 2 nix .IP \(bu 2 nix_helper .IP \(bu 2 node .IP \(bu 2 ollama .IP \(bu 2 opam .IP \(bu 2 opencode .IP \(bu 2 pacdef .IP \(bu 2 pacstall .IP \(bu 2 pearl .IP \(bu 2 pi .IP \(bu 2 pip3 .IP \(bu 2 pip_review .IP \(bu 2 pip_review_local .IP \(bu 2 pipupgrade .IP \(bu 2 pipx .IP \(bu 2 pipxu .IP \(bu 2 pixi .IP \(bu 2 pkg .IP \(bu 2 pkgfile .IP \(bu 2 pkgin .IP \(bu 2 pkgit .IP \(bu 2 platformio_core .IP \(bu 2 pnpm .IP \(bu 2 poetry .IP \(bu 2 powershell .IP \(bu 2 protonplus .IP \(bu 2 protonup .IP \(bu 2 pyenv .IP \(bu 2 raco .IP \(bu 2 rcm .IP \(bu 2 remotes .IP \(bu 2 restarts .IP \(bu 2 rtcl .IP \(bu 2 ruby_gems .IP \(bu 2 rustup .IP \(bu 2 rye .IP \(bu 2 scoop .IP \(bu 2 sdkman .IP \(bu 2 self_update .IP \(bu 2 sera .IP \(bu 2 sheldon .IP \(bu 2 shell .IP \(bu 2 skills .IP \(bu 2 snap .IP \(bu 2 soar .IP \(bu 2 sparkle .IP \(bu 2 spicetify .IP \(bu 2 stack .IP \(bu 2 stew .IP \(bu 2 system .IP \(bu 2 tldr .IP \(bu 2 tlmgr .IP \(bu 2 tmux .IP \(bu 2 toolbx .IP \(bu 2 tpack .IP \(bu 2 typst .IP \(bu 2 uv .IP \(bu 2 vagrant .IP \(bu 2 vcpkg .IP \(bu 2 vim .IP \(bu 2 vite_plus .IP \(bu 2 volta_packages .IP \(bu 2 vscode .IP \(bu 2 vscode_insiders .IP \(bu 2 vscodium .IP \(bu 2 vscodium_insiders .IP \(bu 2 waydroid .IP \(bu 2 windsurf .IP \(bu 2 winget .IP \(bu 2 wsl .IP \(bu 2 wsl_update .IP \(bu 2 xcodes .IP \(bu 2 yadm .IP \(bu 2 yarn .IP \(bu 2 yazi .IP \(bu 2 zed .IP \(bu 2 zerobrew .IP \(bu 2 zigup .IP \(bu 2 zvm .RE .TP \fB\-\-only\fR \fI...\fR Perform only the specified steps .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 am .IP \(bu 2 adless .IP \(bu 2 android_studio .IP \(bu 2 antigravity .IP \(bu 2 antigravity_cli .IP \(bu 2 app_man .IP \(bu 2 app_manager .IP \(bu 2 aqua .IP \(bu 2 asdf .IP \(bu 2 atom .IP \(bu 2 atuin .IP \(bu 2 audit .IP \(bu 2 auto_cpufreq .IP \(bu 2 bin .IP \(bu 2 bob .IP \(bu 2 brew_cask .IP \(bu 2 brew_formula .IP \(bu 2 bun .IP \(bu 2 bun_packages .IP \(bu 2 cargo .IP \(bu 2 certbot .IP \(bu 2 chezmoi .IP \(bu 2 chocolatey .IP \(bu 2 choosenim .IP \(bu 2 cinnamon_spices .IP \(bu 2 clam_av_db .IP \(bu 2 claude_code .IP \(bu 2 claude_code_plugins .IP \(bu 2 codex .IP \(bu 2 colima .IP \(bu 2 composer .IP \(bu 2 conda .IP \(bu 2 config_update .IP \(bu 2 containers .IP \(bu 2 cursor .IP \(bu 2 cursor_agent .IP \(bu 2 custom_commands .IP \(bu 2 deb_get .IP \(bu 2 deno .IP \(bu 2 distrobox .IP \(bu 2 dkp_pacman .IP \(bu 2 dotnet .IP \(bu 2 elan .IP \(bu 2 emacs .IP \(bu 2 falconf .IP \(bu 2 firmware .IP \(bu 2 flatpak .IP \(bu 2 flutter .IP \(bu 2 fossil .IP \(bu 2 gcloud .IP \(bu 2 gearlever .IP \(bu 2 gem .IP \(bu 2 getnf .IP \(bu 2 ghcup .IP \(bu 2 git_repos .IP \(bu 2 github_cli_extensions .IP \(bu 2 gnome_shell_extensions .IP \(bu 2 go .IP \(bu 2 guix .IP \(bu 2 haxelib .IP \(bu 2 helix .IP \(bu 2 helix_db .IP \(bu 2 helm .IP \(bu 2 hermes_agent .IP \(bu 2 home_manager .IP \(bu 2 hyprpm .IP \(bu 2 install_release .IP \(bu 2 jetbrains_aqua .IP \(bu 2 jetbrains_clion .IP \(bu 2 jetbrains_datagrip .IP \(bu 2 jetbrains_dataspell .IP \(bu 2 jetbrains_gateway .IP \(bu 2 jetbrains_goland .IP \(bu 2 jetbrains_idea .IP \(bu 2 jetbrains_mps .IP \(bu 2 jetbrains_phpstorm .IP \(bu 2 jetbrains_pycharm .IP \(bu 2 jetbrains_rider .IP \(bu 2 jetbrains_rubymine .IP \(bu 2 jetbrains_rustrover .IP \(bu 2 jetbrains_toolbox .IP \(bu 2 jetbrains_webstorm .IP \(bu 2 jetpack .IP \(bu 2 julia .IP \(bu 2 juliaup .IP \(bu 2 kakoune .IP \(bu 2 krew .IP \(bu 2 lensfun .IP \(bu 2 lure .IP \(bu 2 macports .IP \(bu 2 mamba .IP \(bu 2 mandb .IP \(bu 2 mas .IP \(bu 2 maza .IP \(bu 2 micro .IP \(bu 2 microsoft_office .IP \(bu 2 microsoft_store .IP \(bu 2 miktex .IP \(bu 2 mise .IP \(bu 2 myrepos .IP \(bu 2 nix .IP \(bu 2 nix_helper .IP \(bu 2 node .IP \(bu 2 ollama .IP \(bu 2 opam .IP \(bu 2 opencode .IP \(bu 2 pacdef .IP \(bu 2 pacstall .IP \(bu 2 pearl .IP \(bu 2 pi .IP \(bu 2 pip3 .IP \(bu 2 pip_review .IP \(bu 2 pip_review_local .IP \(bu 2 pipupgrade .IP \(bu 2 pipx .IP \(bu 2 pipxu .IP \(bu 2 pixi .IP \(bu 2 pkg .IP \(bu 2 pkgfile .IP \(bu 2 pkgin .IP \(bu 2 pkgit .IP \(bu 2 platformio_core .IP \(bu 2 pnpm .IP \(bu 2 poetry .IP \(bu 2 powershell .IP \(bu 2 protonplus .IP \(bu 2 protonup .IP \(bu 2 pyenv .IP \(bu 2 raco .IP \(bu 2 rcm .IP \(bu 2 remotes .IP \(bu 2 restarts .IP \(bu 2 rtcl .IP \(bu 2 ruby_gems .IP \(bu 2 rustup .IP \(bu 2 rye .IP \(bu 2 scoop .IP \(bu 2 sdkman .IP \(bu 2 self_update .IP \(bu 2 sera .IP \(bu 2 sheldon .IP \(bu 2 shell .IP \(bu 2 skills .IP \(bu 2 snap .IP \(bu 2 soar .IP \(bu 2 sparkle .IP \(bu 2 spicetify .IP \(bu 2 stack .IP \(bu 2 stew .IP \(bu 2 system .IP \(bu 2 tldr .IP \(bu 2 tlmgr .IP \(bu 2 tmux .IP \(bu 2 toolbx .IP \(bu 2 tpack .IP \(bu 2 typst .IP \(bu 2 uv .IP \(bu 2 vagrant .IP \(bu 2 vcpkg .IP \(bu 2 vim .IP \(bu 2 vite_plus .IP \(bu 2 volta_packages .IP \(bu 2 vscode .IP \(bu 2 vscode_insiders .IP \(bu 2 vscodium .IP \(bu 2 vscodium_insiders .IP \(bu 2 waydroid .IP \(bu 2 windsurf .IP \(bu 2 winget .IP \(bu 2 wsl .IP \(bu 2 wsl_update .IP \(bu 2 xcodes .IP \(bu 2 yadm .IP \(bu 2 yarn .IP \(bu 2 yazi .IP \(bu 2 zed .IP \(bu 2 zerobrew .IP \(bu 2 zigup .IP \(bu 2 zvm .RE .TP \fB\-\-custom\-commands\fR \fI...\fR Run only specific custom commands .TP \fB\-\-env\fR \fI...\fR Set environment variables .TP \fB\-v\fR, \fB\-\-verbose\fR Output debug logs. Alias for `\-\-log\-filter debug` .TP \fB\-k\fR, \fB\-\-keep\fR Prompt for a key before exiting .TP \fB\-\-notify\-end\fR \fI\fR [default: always] When to send a notification at the end of a run .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 always: Always send a notification (default) .IP \(bu 2 never: Never send a notification .IP \(bu 2 on_failure: Only send a notification if there were failures .RE .TP \fB\-y\fR, \fB\-\-yes\fR [\fI...\fR] Say yes to package manager\*(Aqs prompt .br .br \fIPossible values:\fR .RS 14 .IP \(bu 2 am .IP \(bu 2 adless .IP \(bu 2 android_studio .IP \(bu 2 antigravity .IP \(bu 2 antigravity_cli .IP \(bu 2 app_man .IP \(bu 2 app_manager .IP \(bu 2 aqua .IP \(bu 2 asdf .IP \(bu 2 atom .IP \(bu 2 atuin .IP \(bu 2 audit .IP \(bu 2 auto_cpufreq .IP \(bu 2 bin .IP \(bu 2 bob .IP \(bu 2 brew_cask .IP \(bu 2 brew_formula .IP \(bu 2 bun .IP \(bu 2 bun_packages .IP \(bu 2 cargo .IP \(bu 2 certbot .IP \(bu 2 chezmoi .IP \(bu 2 chocolatey .IP \(bu 2 choosenim .IP \(bu 2 cinnamon_spices .IP \(bu 2 clam_av_db .IP \(bu 2 claude_code .IP \(bu 2 claude_code_plugins .IP \(bu 2 codex .IP \(bu 2 colima .IP \(bu 2 composer .IP \(bu 2 conda .IP \(bu 2 config_update .IP \(bu 2 containers .IP \(bu 2 cursor .IP \(bu 2 cursor_agent .IP \(bu 2 custom_commands .IP \(bu 2 deb_get .IP \(bu 2 deno .IP \(bu 2 distrobox .IP \(bu 2 dkp_pacman .IP \(bu 2 dotnet .IP \(bu 2 elan .IP \(bu 2 emacs .IP \(bu 2 falconf .IP \(bu 2 firmware .IP \(bu 2 flatpak .IP \(bu 2 flutter .IP \(bu 2 fossil .IP \(bu 2 gcloud .IP \(bu 2 gearlever .IP \(bu 2 gem .IP \(bu 2 getnf .IP \(bu 2 ghcup .IP \(bu 2 git_repos .IP \(bu 2 github_cli_extensions .IP \(bu 2 gnome_shell_extensions .IP \(bu 2 go .IP \(bu 2 guix .IP \(bu 2 haxelib .IP \(bu 2 helix .IP \(bu 2 helix_db .IP \(bu 2 helm .IP \(bu 2 hermes_agent .IP \(bu 2 home_manager .IP \(bu 2 hyprpm .IP \(bu 2 install_release .IP \(bu 2 jetbrains_aqua .IP \(bu 2 jetbrains_clion .IP \(bu 2 jetbrains_datagrip .IP \(bu 2 jetbrains_dataspell .IP \(bu 2 jetbrains_gateway .IP \(bu 2 jetbrains_goland .IP \(bu 2 jetbrains_idea .IP \(bu 2 jetbrains_mps .IP \(bu 2 jetbrains_phpstorm .IP \(bu 2 jetbrains_pycharm .IP \(bu 2 jetbrains_rider .IP \(bu 2 jetbrains_rubymine .IP \(bu 2 jetbrains_rustrover .IP \(bu 2 jetbrains_toolbox .IP \(bu 2 jetbrains_webstorm .IP \(bu 2 jetpack .IP \(bu 2 julia .IP \(bu 2 juliaup .IP \(bu 2 kakoune .IP \(bu 2 krew .IP \(bu 2 lensfun .IP \(bu 2 lure .IP \(bu 2 macports .IP \(bu 2 mamba .IP \(bu 2 mandb .IP \(bu 2 mas .IP \(bu 2 maza .IP \(bu 2 micro .IP \(bu 2 microsoft_office .IP \(bu 2 microsoft_store .IP \(bu 2 miktex .IP \(bu 2 mise .IP \(bu 2 myrepos .IP \(bu 2 nix .IP \(bu 2 nix_helper .IP \(bu 2 node .IP \(bu 2 ollama .IP \(bu 2 opam .IP \(bu 2 opencode .IP \(bu 2 pacdef .IP \(bu 2 pacstall .IP \(bu 2 pearl .IP \(bu 2 pi .IP \(bu 2 pip3 .IP \(bu 2 pip_review .IP \(bu 2 pip_review_local .IP \(bu 2 pipupgrade .IP \(bu 2 pipx .IP \(bu 2 pipxu .IP \(bu 2 pixi .IP \(bu 2 pkg .IP \(bu 2 pkgfile .IP \(bu 2 pkgin .IP \(bu 2 pkgit .IP \(bu 2 platformio_core .IP \(bu 2 pnpm .IP \(bu 2 poetry .IP \(bu 2 powershell .IP \(bu 2 protonplus .IP \(bu 2 protonup .IP \(bu 2 pyenv .IP \(bu 2 raco .IP \(bu 2 rcm .IP \(bu 2 remotes .IP \(bu 2 restarts .IP \(bu 2 rtcl .IP \(bu 2 ruby_gems .IP \(bu 2 rustup .IP \(bu 2 rye .IP \(bu 2 scoop .IP \(bu 2 sdkman .IP \(bu 2 self_update .IP \(bu 2 sera .IP \(bu 2 sheldon .IP \(bu 2 shell .IP \(bu 2 skills .IP \(bu 2 snap .IP \(bu 2 soar .IP \(bu 2 sparkle .IP \(bu 2 spicetify .IP \(bu 2 stack .IP \(bu 2 stew .IP \(bu 2 system .IP \(bu 2 tldr .IP \(bu 2 tlmgr .IP \(bu 2 tmux .IP \(bu 2 toolbx .IP \(bu 2 tpack .IP \(bu 2 typst .IP \(bu 2 uv .IP \(bu 2 vagrant .IP \(bu 2 vcpkg .IP \(bu 2 vim .IP \(bu 2 vite_plus .IP \(bu 2 volta_packages .IP \(bu 2 vscode .IP \(bu 2 vscode_insiders .IP \(bu 2 vscodium .IP \(bu 2 vscodium_insiders .IP \(bu 2 waydroid .IP \(bu 2 windsurf .IP \(bu 2 winget .IP \(bu 2 wsl .IP \(bu 2 wsl_update .IP \(bu 2 xcodes .IP \(bu 2 yadm .IP \(bu 2 yarn .IP \(bu 2 yazi .IP \(bu 2 zed .IP \(bu 2 zerobrew .IP \(bu 2 zigup .IP \(bu 2 zvm .RE .TP \fB\-\-disable\-predefined\-git\-repos\fR Don\*(Aqt pull the predefined git repos .TP \fB\-\-config\fR \fI\fR Alternative configuration file .TP \fB\-\-remote\-host\-limit\fR \fI\fR A regular expression for restricting remote host execution .TP \fB\-\-show\-skipped\fR Show the reason for skipped steps .TP \fB\-\-allow\-root\fR Suppress warning and confirmation prompt if running as root .TP \fB\-\-sudoloop\fR Periodically run `sudo \-v` to avoid password re\-prompts during updates .TP \fB\-\-sudoloop\-interval\fR \fI\fR Interval in seconds between `sudo \-v` invocations when \-\-sudoloop is active (default: 240) .TP \fB\-\-log\-filter\fR \fI\fR [default: warn] Tracing filter directives. See: https://docs.rs/tracing\-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives .TP \fB\-\-no\-self\-update\fR Don\*(Aqt update Topgrade .TP \fB\-h\fR, \fB\-\-help\fR Print help (see a summary with \*(Aq\-h\*(Aq) .TP \fB\-V\fR, \fB\-\-version\fR Print version .SH VERSION v17.12.2