Skip to content

SBT

Settings

Settings¶

Open Settings from the sidebar (g9). Each change saves as you make it.

Section	What you change there
Appearance	Light, dark or system mode, palette, corners, motion, row spacing, the Dock icon
General	Notifications, merge method, automatic completion, the tour
Workspaces	Which folders SBT tracks, and their colours
Panes	How panes split and what opens from the title bar
Pages	Which pages the sidebar shows
Keys	Every key, rebindable
Prompts	The instructions the Library's writing agent follows
Connections	The apps and accounts agents may use, with your notes for each
Import & export	Task lists to send to someone, or to bring in
Flags	Recent changes you can switch off
About	Your version and build

Connections¶

A connection is an app or account an agent can use, such as Gmail or a calendar. Add notes to it, like "archive, never delete" or "new events are blue". An agent reads them before it first uses that connection, and adds to them as it learns your preferences.

Import & export saves a workspace's open tasks, one project's tasks or the ones you pick as a .switchbard file. Sign-ins, connections, chats, history and your work order never go in. Importing shows exactly what will be added before anything changes, and new tasks get IDs from your workspace.

sbt share export launch.switchbard --in-project Launch
sbt share import launch.switchbard   # a preview; nothing is written yet

Flags¶

New features sometimes arrive behind a flag. Flags lists each one with what it changes. Switch one off to take that change out of the window and sbt; switch it back on any time.

sbt flags list
sbt flags off session_folders

The settings file¶

Every setting lives in ~/.switchbard/settings.toml, which the window and the terminal app both read. You can edit it by hand. For example:

[global]
agent_harness = "pi"            # claude, codex or pi
hide_statuses = ["Done"]
notify_agents = true
agent_idle_stop_minutes = 30    # 0 never stops an idle agent