Upgrade & shell setup
Keep the orl CLI current with orl upgrade or Homebrew, and add shell completions for bash, zsh, and fish, plus man pages.
Upgrade
orl upgrade # upgrade to the latest release
orl upgrade --check # report whether a newer version exists, change nothing
orl upgrade --version 0.2.0 # install a specific version (v0.2.0 also works; release tags carry the v)If you installed with Homebrew, upgrade with Homebrew instead:
brew upgrade --cask orlorl checks for a newer release in the background and prints a one-line notice
when one is available. It never blocks a command, and --quiet silences it.
orl upgrade also verifies the release's cosign signature before installing
it, failing closed if that check does not pass.
See the CLI changelog for what changed in each release.
Shell completions
Generate a completion script for your shell:
orl completion bash > /etc/bash_completion.d/orl
orl completion zsh > "${fpath[1]}/_orl"
orl completion fish > ~/.config/fish/completions/orl.fishRun orl completion --help for the exact install path on your system.
Man pages
The Homebrew cask and the deb/rpm packages install man pages, so once orl is
installed you can read them the usual way:
man orlVersion
orl --versionAgents (MCP)
Run orl from an agent, as commands or as MCP tools, with cost caps, JSON errors and no prompts. Add it to Claude and choose which tools to expose.
Changelog
What changed in each orl release, with links to the generated GitHub release notes and the exact command to install a specific version.