Settings and config.toml

Settings is a window of its own, with five panes. Everything in it is saved to one plain file, ~/.config/opsty/config.toml, which you can also edit by hand.

General

The language Opsty speaks, how it calls you back, and what it does when it opens.

LANGUAGE

Language

Both are written, neither is machine-translated.

NOTIFICATIONS

When a tab needs me

While you look elsewhere: an agent hands you the turn, a long-running command stops or finishes, or a program sends a notification (OSC 9, 99 or 777, the bell). The tab’s lamp and the Dock count change either way.

MENU BAR

Lamp in the menu bar

Opsty’s mark, the lamp and the cursor, visible from any app: an empty ring at rest, a turning ring while something works, the lamp lit and the cursor blinking on your turn, a cross when something stopped, and a count. Click it for the Glance: the agent’s question with its first answer, why something stopped with Restart, what each agent is working on, every server and tunnel by name, and what you usually start. Right-click for the same rows as a menu, each with Open, Copy Address, Restart or Stop.

Quick Terminal

Press ⌥Space in any app and Opsty drops from the top of the screen with the tab that needs you in front. Press it again and it goes back where it was, and so do you. Window ▸ Show or Hide Quick Terminal does the same.

ON OPENING

Offer to start what was running

When Opsty opens, offer to start the dev servers and agents that were running when it closed. Off removes running.json at once.

Reopen last tabs

Remembers the tabs, the splits and each pane’s folder — never what was in the shell. Switching it off deletes the file too.

ON CLOSING

Keep closed tabs running for

A tab or pane with something running closes at once, without a question, and its dev server or agent keeps running, hidden, for this long — Undo ⌘Z or ⇧⌘T brings it back as it was. An idle shell always closes at once.

Settings ▸ General: the language, notifications, the menu-bar lamp and Quick Terminal, and what Opsty does when it opens.

Opening Settings

The last button in the tab strip (Settings), Opsty ▸ Settings, or ⌘, from any Opsty window. A change applies to every window at once, and the Opacity slider previews on the terminal window as you move it. ⌘W closes Settings, as it closes any Mac window.

The five panes

General: Language; When a tab needs me; Lamp in the menu bar; Quick Terminal, off by default, and its chord, with a note when another app holds the chord; Offer to start what was running; Reopen last tabs, off by default; and Keep closed tabs running for, how long a tab you closed keeps what it was running, hidden, so Undo can bring it back.
Appearance: The four theme families and any you imported; Import from another terminal; Brightness; Opacity; Blur; Font; Text size; Line spacing; and the cursor: Shape, A bar while you type a command and Blink. A program can still choose its own cursor, as vim’s insert mode does; at the next prompt Opsty goes back to yours. See Themes.
Helpers: Everything Opsty volunteers, each with its own switch: Command cards, Tab popup, Ghost text, Name what a dangerous command loses, Pasted commands, one at a time, Offer Touch ID for sudo, Explain a failure, Did you mean, Errors while it runs, Answer from the notification, While you were away and Project strip.
Privacy: The one network request, the update check, and its switch, Check for updates; See every server on this Mac and Peek at a port; a list of what Opsty reads on this Mac; Changed files and Rewind the screen; what it writes, and where; and Command history, with what is on disk now and Erase everything.
Advanced: Use ⌥ as Meta; the shell a new tab opens (your own login shell), Shell integration, Six completion styles and Diagnosis; Renderer and Scrollback; the doors in from elsewhere; Edit by hand, with the path to config.toml; and your version, with Check now and What’s new.

config.toml

Every setting is a line in ~/.config/opsty/config.toml, a plain file you own, and the file starts with a link to this page. A value out of range is brought back into range, and one Opsty cannot read falls back to the default, so a typo never leaves you with a broken window. Until you choose a language, the language line is written as a comment, because it is following your Mac’s.

Opsty rewrites the file whenever you change a setting in the app, so comments you add to it are not kept. Keys it does not recognize are.

Every key, with its default first:

Key	Default, and what else it takes	In Settings
`theme`	`"lamp"`; or `"fjord"`, `"ember"`, `"ink"`, or `"custom:<name>"` for a theme you imported	Appearance ▸ the theme
`appearance`	`"system"`; or `"light"`, `"dark"`	Appearance ▸ Brightness
`glass`	`0.92`; from `0.3` to `1`	Appearance ▸ Opacity
`blur`	`true`	Appearance ▸ Blur
`fontFamily`	`"JetBrains Mono"`; any font’s name	Appearance ▸ Font
`fontSize`	`13`; from `9` to `24`	Appearance ▸ Text size
`lineHeight`	`1`; from `1` to `1.5` (Settings offers 1, 1.1 and 1.25)	Appearance ▸ Line spacing
`cursorStyle`	`"block"`; or `"bar"`, `"underline"`	Appearance ▸ Shape
`cursorPromptBar`	`true`	Appearance ▸ A bar while you type a command
`cursorBlink`	`true`	Appearance ▸ Blink
`language`	your Mac’s language until you set it; `"en"` or `"ko"`	General ▸ Language
`notificationsEnabled`	`true`	General ▸ When a tab needs me
`menuBarLamp`	`true`	General ▸ Lamp in the menu bar
`quickTerminal`	`false`, from 0.7.0; a file that already says `true` keeps it	General ▸ Quick Terminal
`quickTerminalKey`	`"Alt+Space"`; a chord with Command, Alt or Control in it	General ▸ Quick Terminal, the chord
`rememberRunning`	`true`	General ▸ Offer to start what was running
`restoreWorkspace`	`false`	General ▸ Reopen last tabs
`closeHoldSeconds`	`10`; from `0` (stop at once) to `60`	General ▸ Keep closed tabs running for
`cards`	`"typing"`; or `"off"`	Helpers ▸ Command cards
`completion`	`"tab"`; or `"off"`	Helpers ▸ Tab popup
`ghostText`	`true`	Helpers ▸ Ghost text
`dangerHints`	`true`	Helpers ▸ Name what a dangerous command loses
`pasteSteps`	`true`	Helpers ▸ Pasted commands, one at a time
`touchIdOffer`	`true`	Helpers ▸ Offer Touch ID for sudo
`failureCards`	`true`	Helpers ▸ Explain a failure
`discoverTools`	`true`	Helpers ▸ Did you mean (it also lets the project strip read a project’s manifests)
`projectStrip`	`true`	Helpers ▸ Project strip
`liveErrors`	`true`	Helpers ▸ Errors while it runs
`notifyActions`	`true`	Helpers ▸ Answer from the notification
`awaySummary`	`true`	Helpers ▸ While you were away
`updates`	`"auto"`; or `"off"`	Privacy ▸ Check for updates
`allServers`	`true`	Privacy ▸ See every server on this Mac
`peekPorts`	`true`	Privacy ▸ Peek at a port
`watchChanges`	`true`	Privacy ▸ Changed files
`snapshots`	`true`	Privacy ▸ Rewind the screen
`historyEnabled`	`true`	Privacy ▸ Command history
`optionAsMeta`	`false`	Advanced ▸ Use ⌥ as Meta
`shellIntegration`	`true`	Advanced ▸ Shell integration
`completionStyles`	`true`	Advanced ▸ Six completion styles
`renderer`	`"auto"`; or `"webgl"`, `"dom"`	Advanced ▸ Renderer
`scrollback`	`10000` lines per pane; up to `500000`	Advanced ▸ Scrollback

A few more keys belong to parts of Opsty that are switched off in 0.6.0, and have no row in Settings: instruments, bridge, studio, ledger and prodConfirm. Leave them as they are. firstRunSeen records that the first-run note has been shown. 0.6.0 drops lenses, the box that was drawn over a command’s output; the key goes the next time Opsty writes the file, and Show formatted is what replaced it.

Two more things live beside the file: hosts.toml, the servers you marked as production, and themes/, the themes you imported.

Language

Opsty’s interface is written in English and in Korean, neither machine-translated. It follows your Mac’s language until you choose one in Settings ▸ General ▸ Language, or with View ▸ Toggle language.