Skip to content

Workshop Settings

Jump to bottom
Daniel Ellison edited this page Sep 3, 2026 · 1 revision

Settings is where you shape how Kai works with you personally: standing guidance for agents, GitHub automation, notification delivery, and how the client looks and sounds. Open it from the profile footer at the bottom of the sidebar (or the Settings button in the conversation header on narrow layouts). A section nav on the left tracks your scroll position; the sections below are the personal ones every member sees.

Everything on this page is yours alone. Your preferences, subscriptions, and delivery choices affect how Kai behaves for you, not for anyone else in the workshop.

Personal preferences

A Markdown text area for principal-wide guidance: standing instructions that reach every agent you talk to, in every channel. Write things you would otherwise repeat: how you like answers formatted, what timezone you plan in, conventions your projects follow.

The editor shows a byte counter against the size limit and a Saved / Unsaved changes indicator. Save preferences commits your draft; Discard throws it away. If you navigate away with unsaved text, the client prompts before letting the text go.

Two safety nets back the editor:

  • Concurrent edits. If the saved text changed while you were typing (another tab, another device), saving stops and offers Review concurrent changes: a side-by-side view of the latest saved text and your draft. Your draft remains untouched while you compare. Use latest saved adopts the other version; Reapply my draft… replaces the saved text with yours after a confirmation.
  • Private revision history. Every save keeps the previous text as a revision, and each revision has a Restore button. Restoring is itself non-destructive: the current text joins the history rather than vanishing.

GitHub

Personal GitHub automation settings. The GitHub login itself is protected and operator-managed; what you control here is what the automation does for you:

  • PR reviews and Issue triage toggles, each with Reset to policy to fall back to the operator's default.
  • The subscribed repository list, with Remove per row and an add form (owner, repository) for new subscriptions. Kai watches subscribed repositories for review and triage work.
  • A GitHub access token field. The token is write-only: you can set a new one, but the client never shows the current one again.

Notification delivery

Where and when Kai's notifications reach you:

  • Per-adapter alert toggles turn each delivery adapter on or off for you.
  • A per-channel level for every channel you belong to: All messages, Mentions and replies, or Muted.
  • Direct mentions override muted channels: with this on, a message that mentions you directly still alerts you even in a channel you muted.
  • Do not disturb: a daily quiet window with a timezone and validated start and end times. Save schedule applies it.
  • Per-integration-class destination pickers route each class of integration notification (GitHub activity, for example) to the channel you want, each with a Reset.

Client preferences

How the Workshop looks and sounds:

  • Theme. Eleven themes: Atom One Dark, Atom One Light, Dracula, Nord, Solarized Dark, Solarized Light, Catppuccin Mocha, Catppuccin Latte, GitHub Light Default, GitHub Dark Default, and GitHub Dark Dimmed. The theme is an account preference stored on the server, so it follows you to every browser you have enrolled; it is not a per-device toggle.
  • Voice output. Per client: Off, Text and voice, or Voice only, plus a Voice selection picker. Unlike the theme, voice choices stay with the specific enrolled browser, so your desk machine can speak while your laptop stays silent.

Runtime settings for an agent

When you open Settings for a specific agent runtime, it shows a different set of sections: Runtime settings (backend, model, response timeout, each with Apply and Reset to policy) and Workspace settings (the active workspace plus per-workspace overrides). You normally reach this view from the agent's detail page in the Agents workspace, and links into agent settings land there; see Workshop Agents. Resetting the model or timeout to policy may restart the active runtime, and the dialog says so before you confirm.

Good to know

  • Theme follows your account; voice stays with the client. The theme reaches every enrolled browser because the server stores it. Voice output is a property of each enrolled browser.
  • Unsaved preference text prompts before navigation. The client asks before dropping your draft, from any navigation path out of Settings.
  • Reset to policy is your undo for overrides. GitHub toggles, notification destinations, and runtime settings all offer it; it returns the setting to the operator-managed default.

See also

Clone this wiki locally