NAME

topgrade

SYNOPSIS

topgrade [--edit-config] [--config-reference] [-t|--tmux] [--no-tmux] [-c|--cleanup] [-n|--dry-run] [-r|--run-type] [--no-retry] [--disable] [--only] [--custom-commands] [--env] [-v|--verbose] [-k|--keep] [--skip-notify] [-y|--yes] [--disable-predefined-git-repos] [--config] [--remote-host-limit] [--show-skipped] [--allow-root] [--log-filter] [--no-self-update] [-h|--help] [-V|--version]

DESCRIPTION

OPTIONS

--edit-config

Edit the configuration file

--config-reference

Show config reference

-t, --tmux

Run inside tmux

--no-tmux

Don't run inside tmux

-c, --cleanup

Cleanup temporary or old files

-n, --dry-run

Print what would be done

Alias for --run-type dry

-r, --run-type <RUN_TYPE> [default: wet]

Pick between just running commands, running and logging commands, and just logging commands

Possible values:

--no-retry

Do not ask to retry failed steps

--disable <STEP>...

Do not perform upgrades for the given steps

[possible values: am, android_studio, app_man, aqua, asdf, atom, atuin, audit, auto_cpufreq, bin, bob, brew_cask, brew_formula, bun, bun_packages, cargo, certbot, chezmoi, chocolatey, choosenim, cinnamon_spices, clam_av_db, composer, conda, config_update, containers, cursor, custom_commands, deb_get, deno, distrobox, dkp_pacman, dotnet, elan, emacs, falconf, firmware, flatpak, flutter, fossil, gcloud, gem, ghcup, git_repos, github_cli_extensions, gnome_shell_extensions, go, guix, haxelib, helix, helm, home_manager, hyprpm, jetbrains_aqua, jetbrains_clion, jetbrains_datagrip, jetbrains_dataspell, jetbrains_gateway, jetbrains_goland, jetbrains_idea, jetbrains_mps, jetbrains_phpstorm, jetbrains_pycharm, jetbrains_rider, jetbrains_rubymine, jetbrains_rustrover, jetbrains_toolbox, jetbrains_webstorm, jetpack, julia, juliaup, kakoune, krew, lensfun, lure, macports, mamba, mandb, mas, maza, micro, microsoft_store, miktex, mise, myrepos, nix, nix_helper, node, opam, pacdef, pacstall, pearl, pip3, pip_review, pip_review_local, pipupgrade, pipx, pipxu, pixi, pkg, pkgfile, pkgin, platformio_core, pnpm, poetry, powershell, protonup, pyenv, raco, rcm, remotes, restarts, rtcl, ruby_gems, rustup, rye, scoop, sdkman, self_update, sheldon, shell, snap, sparkle, spicetify, stack, stew, system, tldr, tlmgr, tmux, toolbx, typst, uv, vagrant, vcpkg, vim, volta_packages, vscode, vscode_insiders, vscodium, vscodium_insiders, waydroid, winget, wsl, wsl_update, xcodes, yadm, yarn, yazi, zigup, zvm]

--only <STEP>...

Perform only the specified steps

[possible values: am, android_studio, app_man, aqua, asdf, atom, atuin, audit, auto_cpufreq, bin, bob, brew_cask, brew_formula, bun, bun_packages, cargo, certbot, chezmoi, chocolatey, choosenim, cinnamon_spices, clam_av_db, composer, conda, config_update, containers, cursor, custom_commands, deb_get, deno, distrobox, dkp_pacman, dotnet, elan, emacs, falconf, firmware, flatpak, flutter, fossil, gcloud, gem, ghcup, git_repos, github_cli_extensions, gnome_shell_extensions, go, guix, haxelib, helix, helm, home_manager, hyprpm, jetbrains_aqua, jetbrains_clion, jetbrains_datagrip, jetbrains_dataspell, jetbrains_gateway, jetbrains_goland, jetbrains_idea, jetbrains_mps, jetbrains_phpstorm, jetbrains_pycharm, jetbrains_rider, jetbrains_rubymine, jetbrains_rustrover, jetbrains_toolbox, jetbrains_webstorm, jetpack, julia, juliaup, kakoune, krew, lensfun, lure, macports, mamba, mandb, mas, maza, micro, microsoft_store, miktex, mise, myrepos, nix, nix_helper, node, opam, pacdef, pacstall, pearl, pip3, pip_review, pip_review_local, pipupgrade, pipx, pipxu, pixi, pkg, pkgfile, pkgin, platformio_core, pnpm, poetry, powershell, protonup, pyenv, raco, rcm, remotes, restarts, rtcl, ruby_gems, rustup, rye, scoop, sdkman, self_update, sheldon, shell, snap, sparkle, spicetify, stack, stew, system, tldr, tlmgr, tmux, toolbx, typst, uv, vagrant, vcpkg, vim, volta_packages, vscode, vscode_insiders, vscodium, vscodium_insiders, waydroid, winget, wsl, wsl_update, xcodes, yadm, yarn, yazi, zigup, zvm]

--custom-commands <NAME>...

Run only specific custom commands

--env <NAME=VALUE>...

Set environment variables

-v, --verbose

Output debug logs. Alias for `--log-filter debug`

-k, --keep

Prompt for a key before exiting

--skip-notify

Skip sending a notification at the end of a run

-y, --yes [<STEP>...]

Say yes to package manager's prompt

[possible values: am, android_studio, app_man, aqua, asdf, atom, atuin, audit, auto_cpufreq, bin, bob, brew_cask, brew_formula, bun, bun_packages, cargo, certbot, chezmoi, chocolatey, choosenim, cinnamon_spices, clam_av_db, composer, conda, config_update, containers, cursor, custom_commands, deb_get, deno, distrobox, dkp_pacman, dotnet, elan, emacs, falconf, firmware, flatpak, flutter, fossil, gcloud, gem, ghcup, git_repos, github_cli_extensions, gnome_shell_extensions, go, guix, haxelib, helix, helm, home_manager, hyprpm, jetbrains_aqua, jetbrains_clion, jetbrains_datagrip, jetbrains_dataspell, jetbrains_gateway, jetbrains_goland, jetbrains_idea, jetbrains_mps, jetbrains_phpstorm, jetbrains_pycharm, jetbrains_rider, jetbrains_rubymine, jetbrains_rustrover, jetbrains_toolbox, jetbrains_webstorm, jetpack, julia, juliaup, kakoune, krew, lensfun, lure, macports, mamba, mandb, mas, maza, micro, microsoft_store, miktex, mise, myrepos, nix, nix_helper, node, opam, pacdef, pacstall, pearl, pip3, pip_review, pip_review_local, pipupgrade, pipx, pipxu, pixi, pkg, pkgfile, pkgin, platformio_core, pnpm, poetry, powershell, protonup, pyenv, raco, rcm, remotes, restarts, rtcl, ruby_gems, rustup, rye, scoop, sdkman, self_update, sheldon, shell, snap, sparkle, spicetify, stack, stew, system, tldr, tlmgr, tmux, toolbx, typst, uv, vagrant, vcpkg, vim, volta_packages, vscode, vscode_insiders, vscodium, vscodium_insiders, waydroid, winget, wsl, wsl_update, xcodes, yadm, yarn, yazi, zigup, zvm]

--disable-predefined-git-repos

Don't pull the predefined git repos

--config <PATH>

Alternative configuration file

--remote-host-limit <REGEX>

A regular expression for restricting remote host execution

--show-skipped

Show the reason for skipped steps

--allow-root

Suppress warning and confirmation prompt if running as root

--log-filter <LOG_FILTER> [default: warn]

Tracing filter directives.

See: https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives

--no-self-update

Don't update Topgrade

-h, --help

Print help (see a summary with '-h')

-V, --version

Print version

VERSION

v16.9.0