The Opsty guide
Opsty is a Mac terminal for people who build with AI and run things on their own Mac: dev servers, coding agents, ssh sessions. Leave them running and look away; each tab says what it is doing, Opsty calls you back when one needs you, and the next time you open it, it offers to start everything again.
This guide is for Opsty 0.7.0, on macOS 13 or later with Apple silicon. Everything in Opsty has a button or a menu item, and shortcuts are faster, never the only way in. Its interface is in English and Korean (한국어) and follows your Mac’s language; the guide quotes the English labels.
Start
Getting Opsty onto your Mac, and keeping it current.
- Install and uninstall
macOS 13 or later on Apple silicon. From the disk image or from Terminal, and how to remove it.
- Updates
It downloads in the background and never restarts on its own.
Every day
The tabs, the Running list, and coming back to what you left running.
- Tabs, panes and windows
The tab strip, the lamp on every tab, splits, moving tabs and panes between windows, and how Opsty knows an agent.
The window · Splits · Windows · What each tab says · How Opsty knows an agent
- Notifications and the menu bar
Called back only when you look away. Answer from the banner, or click Opsty’s mark in the menu bar for the Glance.
Answering from the notification · The menu bar, the Glance and Quick Terminal
- While you were away
What each tab did while you were gone, in one panel, before you start typing.
- The Running list
Every server, agent and ssh session left running, with its detail beside the list: the page it serves, ports already in use, and why something stopped.
- Starting what was running
The next morning: yesterday’s servers and conversations, offered back in one sheet.
- The launcher, history and find
One launcher for tabs, commands, history and servers, in columns that stay put. ⌘F for a tab’s output.
- The Ledger
The mark beside every command, the rows a program marked as problems, the formatted view, what clearing the screen erases, what it changed, and Rewind.
Explained
Plain words for what failed, what a command will do, and what a paste would run.
- Failure cards
Twenty common errors, each explained in one sentence that quotes the line it read, with the next command.
- Command cards
Cards for 26 commands: their parts, their options, and what Enter will do.
- Pasted and risky commands
What a destructive command loses, and walking a pasted block one step at a time.
Agents
Claude Code, Codex and Gemini CLI in Opsty.
- Running an agent
Shift+Enter, Write a message, clean copies, and two agents in one folder.
Servers
ssh, reconnecting, sending files, and the servers you mark as production.
- Servers and production
Connect, reconnect, send a file to a server, and mark the ones that matter.
Make it yours
Looks, every setting, the doors in, and the shortcuts.
- Themes, glass and type
Four theme families, frosted glass, colors from your old terminal, and fonts.
- Settings and config.toml
Every pane of the Settings window, and every key in config.toml.
- Opening Opsty from elsewhere
Folders from Finder, a Quick Action, opsty . in another terminal, and ssh:// links.
- Shell integration
What makes the marks and cards work, and what to do when it doesn’t load.
- Keyboard shortcuts
Every shortcut, and the menu it lives in.
Help
Privacy in short, and fixes for the usual problems.
- Privacy, in short
One network request, the update check, and nothing else. The short version.
- Troubleshooting
macOS warnings, missing notifications, agents, updates and Korean input.
macOS will not open Opsty · No notifications · An agent’s tab · Updates · Korean input · Anything else