Topgrade

topgrade

Runs as topgrade|macOS, Linux, Windows|github.com

Command form

ai-draft · 2 tasks · 12 fields

Run Topgrade's upgrade steps with a dry run, step selection and retry behaviour. Custom commands, environment variables, notifications and logging options are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui topgrade

Upgrade everythingExample values, fixed in this page — nothing here reaches a terminal

Basic

Dry run

--dry-run

Only these steps

string

Skip these steps

string

Advanced

Show skipped reasons

--show-skipped

TasksEach one presets the form for one job

Preview upgrades

dry_runonlydisableshow_skipped

Unattended upgrade

yesno_ask_retryauto_retrydisableonly

ParametersOnly these flags are editable in the form

Dry run

Print what would be done without upgrading anything.
boolean

--dry-run-n

Only these steps

Step names such as brew, cargo or system. Only these steps run.
string · repeatable

--only

Skip these steps

Step names to leave out of the run.
string · repeatable

--disable

Answer yes to prompts

Say yes to the package managers' prompts.
boolean

--yes-y

Skip Topgrade self-update

boolean

--no-self-update

Do not ask to retry failures

boolean

--no-ask-retry

Automatic retries

Retry failed steps up to this many times.
integer

--auto-retry

Config file

path

--config

Show skipped reasons

boolean

--show-skipped

Keep sudo alive

Periodically run sudo -v to avoid password re-prompts.
boolean

--sudoloop

Wait for a key at the end

boolean

--keep-k

Verbose

boolean

--verbose-v

SourcesEvery flag above is checked against these

cli

-n, --dry-run Print what would be done --disable <STEP>... Do not perform upgrades for the given steps --only <STEP>... Perform only the specified steps -y, --yes [<STEP>...] Say yes to package manager's prompt -v, --verbose Output debug logs. Alias for `--log-filter debug`. -k, --keep Pr…

manual2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed topgrade against its version. A form that does not match your version is not offered.