Skip to content
updateself documentation edited this page Oct 16, 2026 · 7 revisions

Documentation for updateself 2.1.0. Versioned source.

updateself documentation

updateself updates installed system packages and common CLI tools. updsf invokes the same program; update.sh remains available from a checkout.

Downloads

Published releases and package downloads contain installers, checksums and release notes. Downloads appear when a release is published. For development builds, use Git installation or signed-in Actions → CI → Artifacts for development packages.

First run

bash update.sh --help
bash update.sh --dry-run
bash update.sh --ask

The default skips confirmations. Start with a preview, then review commands with --ask. Authentication and vendor prompts can still occur. No reboot is initiated.

Guides

Task Guide
Update or uninstall updateself itself Self-management
Install, upgrade, remove or enable completions Installation
Select options and components Command Reference
Update your platform macOS, Linux, BSD, Nix
Understand tool ownership Supported Tools
Inspect Python and update pip Python and pip
Download packages or understand CI Packages and Releases
Check compatibility and limitations Platform Support
Resolve failures or skipped tools Troubleshooting and FAQ
See future work Roadmap

Missing tools are skipped, never installed. Package-managed executables stay with their owner. User tools run under the selected account. Cleanup, supported base-system installation and bulk Python updates require explicit options.

Source, contribution instructions and issue reporting live in the project repository.

Clone this wiki locally