Install and uninstall

Install from the disk image

1. Download the disk image from opsty.dev. Not sure which chip your Mac has? Choose Apple menu ▸ About This Mac: Chip: Apple M… means yes, and Processor: Intel means Opsty will not run on it. Opsty is made for Apple silicon only.
2. Open the downloaded .dmg and drag Opsty onto the Applications folder beside it. Then eject the disk image.
3. Open Opsty from Applications or Spotlight. The first time, macOS says it was downloaded from the internet and asks whether to open it; choose Open. Opsty is signed and notarized by Apple, so that is the only question.

Keep it in an Applications folder, yours or the Mac’s: Opsty updates itself only from there. See Updates.

Your first command

After your first command finishes, one note appears under the next prompt: Type a command and its explanation appears here. It adds that hovering a finished command shows copy and run again, and that Opsty checks dl.opsty.dev for a new version once a day, which Settings ▸ Privacy can turn off. Any key closes the note, and it does not come back.

Or install from Terminal

curl -fsSL opsty.sh | sh

This downloads the same disk image, checks it against SHA256SUMS and Apple’s notarization, and copies Opsty to Applications, or to ~/Applications if the main folder is not writable. It never uses sudo. To read the script before you run it:

curl -fsSL opsty.sh | less

Or with Homebrew

brew install --cask opsty-dev/tap/opsty

The same notarized app, from Opsty’s own tap. The full name trusts the tap as it installs, so there is no separate brew tap, and Homebrew also puts the opsty command on your PATH. Opsty updates itself, so brew upgrade leaves it alone.

Coming from 0.3.0 or earlier

Those versions cannot update themselves. Download the current version once and drag it over the old copy in Applications; your settings, history and themes are kept. From then on Opsty updates itself.

From 0.7.0 the app is called Opsty, with a capital O. A copy that updated itself from 0.6.0 or earlier says Opsty in its menus, but keeps its old folder name, opsty.app, in Finder until you install it again from the disk image or from Terminal, which installs it as Opsty.app. Nothing else differs.

Uninstall

Drag Opsty from Applications to the Trash. That leaves your settings and history where they are, in case you come back. Installed with Homebrew, brew uninstall --cask opsty does the same, and brew uninstall --zap --cask opsty also removes the folders and the Quick Action listed below; the last two items are yours to undo. To remove everything by hand:

• ~/.config/opsty holds your settings, history, imported themes and the note of what was running.
• ~/Library/Application Support/opsty holds Electron’s working files and the updater’s few small files.
• ~/Library/Caches/opsty-updater and ~/Library/Caches/dev.opsty.opsty.ShipIt hold downloaded updates.
• If you installed the Finder Quick Action, delete it from ~/Library/Services.
• If you put the opsty command on your PATH, remove /usr/local/bin/opsty; it needs sudo.
• If you made Opsty the app for ssh:// links, switch Open ssh:// and x-man-page:// links off in Settings ▸ Advanced before you delete the app, so Terminal gets them back.

Opsty never edited your dotfiles, so there is nothing to undo there.