topgrade(1)
🎀 topgrade — General Commands Manual 🎀
hi bestie!! okay so this is the topgrade page from the General Commands Manual, and it's genuinely the single most iconic command on your whole machine 💅 no cap, it's the one that goes around upgrading everything for you.
✨ NAME ✨
topgrade — literally the name says it all 💖
🦋 SYNOPSIS 🦋
topgrade [--edit-config] [--config-reference] [-t|--tmux] [--no-tmux]
[-c|--cleanup] [-n|--dry-run] [-r|--run-type] [--no-ask-retry]
[--auto-retry] [--disable] [--only] [--custom-commands] [--env]
[-v|--verbose] [-k|--keep] [--notify-end] [-y|--yes]
[--disable-predefined-git-repos] [--config] [--remote-host-limit]
[--show-skipped] [--allow-root] [--sudoloop] [--sudoloop-interval]
[--log-filter] [--no-self-update] [-h|--help] [-V|--version]like, look at all those flags. it's giving main character energy 👑
🌸 DESCRIPTION 🌸
okay so, huge mood: this section is empty in the original page. nothing here. it's a vibe-only blank space 🫶 so we're not inventing anything, we're just moving on to the good part.
💅 OPTIONS 💅
the group chat of flags, in order, no skips:
--edit-config— open up the config file so you can edit it ✏️--config-reference— show the config reference, iykyk-t,--tmux— run it insidetmux--no-tmux— don't run it insidetmux-c,--cleanup— clean up temporary or old files 🧹-n,--dry-run— just print what would be done, nothing gets touched 🫧
alias for --run-type dry, bestie
-r,--run-type <RUN_TYPE>[default:wet] — pick between just running commands, running and logging commands, or just logging commands. your three icons:dry— executing commands will just print the command with its argumentwet— executing commands will perform actual executiondamp— executing commands will print the command and perform actual execution
--no-ask-retry— don't ask what to do after a step fails 🙈--auto-retry <COUNT>— automatically retry failed steps up to COUNT times 🔁--disable <STEP>...— do not perform upgrades for the given steps 🙅♀️
possible values, and yes there are a lot, we're listing them all because I would never do you like that:
amandroid_studioantigravityapp_manaquaasdfatomatuinauditauto_cpufreqbinbobbrew_caskbrew_formulabunbun_packagescargocertbotchezmoichocolateychoosenimcinnamon_spicesclam_av_dbclaude_codecolimacomposercondaconfig_updatecontainerscursorcustom_commandsdeb_getdenodistroboxdkp_pacmandotnetelanemacsfalconffirmwareflatpakflutterfossilgcloudgearlevergemgetnfghcupgit_reposgithub_cli_extensionsgnome_shell_extensionsgoguixhaxelibhelixhelix_dbhelmhome_managerhyprpmjetbrains_aquajetbrains_clionjetbrains_datagripjetbrains_dataspelljetbrains_gatewayjetbrains_golandjetbrains_ideajetbrains_mpsjetbrains_phpstormjetbrains_pycharmjetbrains_riderjetbrains_rubyminejetbrains_rustroverjetbrains_toolboxjetbrains_webstormjetpackjuliajuliaupkakounekrewlensfunluremacportsmambamandbmasmazamicromicrosoft_officemicrosoft_storemiktexmisemyreposnixnix_helpernodeollamaopampacdefpacstallpearlpipip3pip_reviewpip_review_localpipupgradepipxpipxupixipkgpkgfilepkginplatformio_corepnpmpoetrypowershellprotonplusprotonuppyenvracorcmremotesrestartsrtclruby_gemsrustupryescoopsdkmanself_updatesheldonshellskillssnapsparklespicetifystackstewsystemtldrtlmgrtmuxtoolbxtpacktypstuvvagrantvcpkgvimvite_plusvolta_packagesvscodevscode_insidersvscodiumvscodium_insiderswaydroidwindsurfwingetwslwsl_updatexcodesyadmyarnyazizigupzvm
--only <STEP>...— perform only the specified steps 👀 same energy, opposite direction:
possible values:
amandroid_studioantigravityapp_manaquaasdfatomatuinauditauto_cpufreqbinbobbrew_caskbrew_formulabunbun_packagescargocertbotchezmoichocolateychoosenimcinnamon_spicesclam_av_dbclaude_codecolimacomposercondaconfig_updatecontainerscursorcustom_commandsdeb_getdenodistroboxdkp_pacmandotnetelanemacsfalconffirmwareflatpakflutterfossilgcloudgearlevergemgetnfghcupgit_reposgithub_cli_extensionsgnome_shell_extensionsgoguixhaxelibhelixhelix_dbhelmhome_managerhyprpmjetbrains_aquajetbrains_clionjetbrains_datagripjetbrains_dataspelljetbrains_gatewayjetbrains_golandjetbrains_ideajetbrains_mpsjetbrains_phpstormjetbrains_pycharmjetbrains_riderjetbrains_rubyminejetbrains_rustroverjetbrains_toolboxjetbrains_webstormjetpackjuliajuliaupkakounekrewlensfunluremacportsmambamandbmasmazamicromicrosoft_officemicrosoft_storemiktexmisemyreposnixnix_helpernodeollamaopampacdefpacstallpearlpipip3pip_reviewpip_review_localpipupgradepipxpipxupixipkgpkgfilepkginplatformio_corepnpmpoetrypowershellprotonplusprotonuppyenvracorcmremotes
(the list keeps going in the next chunk of the page, we're not done yet 💜)
restartsrtclruby_gemsrustupryescoopsdkmanself_updatesheldonshellskillssnapsparklespicetifystackstewsystemtldrtlmgrtmuxtoolbxtpacktypstuvvagrantvcpkgvimvite_plusvolta_packagesvscodevscode_insidersvscodiumvscodium_insiderswaydroidwindsurfwingetwslwsl_updatexcodesyadmyarnyazizigupzvm
ok that's the whole alphabet soup, no cap 💀 every single step name, straight from the source.
--custom-commands<NAME>... — only run the custom commands you name, nothing else. selective queen behavior 💅--env<NAME=VALUE>... — set environment variables for the run. yes bestie, you can pass more than one.-v,--verbose— output debug logs. it's literally just an alias for--log-filter debug, so don't act surprised when it's loud.-k,--keep— prompt for a key before exiting. perfect if you want to screenshot the chaos before the window vanishes 🫶--notify-end<NOTIFY_END> [default:always] — decides when the end-of-run notification goes out ✨
possible values:
always— always send a notification (this is the default, icon behavior)never— never send a notificationon_failure— only send a notification if there were failures 😭
-y,--yes[<STEP>...] — say yes to the package manager's prompt. you can scope it to specific steps, or just let it ride. the possible values are:amandroid_studioantigravityapp_manaquaasdfatomatuinauditauto_cpufreqbinbobbrew_caskbrew_formulabunbun_packagescargocertbotchezmoichocolateychoosenimcinnamon_spicesclam_av_dbclaude_codecolimacomposercondaconfig_updatecontainerscursorcustom_commandsdeb_getdenodistroboxdkp_pacmandotnetelanemacsfalconffirmwareflatpakflutterfossilgcloudgearlevergemgetnfghcupgit_reposgithub_cli_extensionsgnome_shell_extensionsgoguixhaxelibhelixhelix_dbhelmhome_managerhyprpmjetbrains_aquajetbrains_clionjetbrains_datagripjetbrains_dataspelljetbrains_gatewayjetbrains_golandjetbrains_ideajetbrains_mpsjetbrains_phpstormjetbrains_pycharmjetbrains_riderjetbrains_rubyminejetbrains_rustroverjetbrains_toolboxjetbrains_webstormjetpackjuliajuliaupkakounekrewlensfunluremacportsmambamandbmasmazamicromicrosoft_officemicrosoft_storemiktexmisemyreposnixnix_helpernodeollamaopampacdefpacstallpearlpipip3pip_reviewpip_review_localpipupgradepipxpipxupixipkgpkgfilepkginplatformio_corepnpmpoetrypowershellprotonplusprotonuppyenvracorcmremotesrestartsrtclruby_gemsrustupryescoopsdkmanself_updatesheldonshellskillssnapsparklespicetifystackstewsystemtldrtlmgrtmuxtoolbxtpacktypstuvvagrantvcpkgvimvite_plusvolta_packagesvscodevscode_insidersvscodiumvscodium_insiderswaydroidwindsurfwingetwslwsl_updatexcodesyadmyarnyazizigupzvm
--disable-predefined-git-repos— don't pull the predefined git repos. if you don't want that default repo pull, this is your girl 🎀--config<PATH> — use an alternative configuration file. point it wherever your heart wants.--remote-host-limit<REGEX> — a regular expression that restricts remote host execution. yes, a regex, so be careful and be precise 🧚--show-skipped— show the reason why steps got skipped. finally, the lore 🙈--allow-root— suppresses the warning and the confirmation prompt if you're running as root. highkey powerful, use it on purpose.--sudoloop— periodically runssudo -vso you don't get password re-prompts in the middle of updates. the way this saves you 😭--sudoloop-interval<SECONDS> — how many seconds betweensudo -vinvocations when--sudoloopis active (default:240).--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. sometimes you're just not in the mood to grow ✨-h,--help— print help (see a summary with-h).-V,--version— print version.
🦋 VERSION 🦋
v17.4.0and that's the whole page, bestie — you ate that 💅 this absolute icon of a manual is topgrade 17.4.0, documented under the topgrade(1) page. go forth, update everything, and remember: reading the manpage is main character energy 👑🫶
📦 where this page comes from
- alpine 3.24: topgrade-doc 17.4.0-r0 · GPL-3.0-or-later
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms