Workspaces & demos

A workspace is a named bundle of:


Model	The default model for chats in this workspace
MCP servers	Which servers’ tools the model can use
Skills	Which skills are advertised
System prompt	Persona and rules
Starter prompts	One-click chips on an empty chat
Max agent steps	Upper bound on model ↔ tool round trips per message (default 12)
Generative UI	Whether the model gets the `render_ui` tool (default on)

Create one per use case — “Support bot”, “SRE on-call”, “Sales demo: CRM” — and switch between them from the top bar. Chats remember which workspace they started in.

The sidebar groups your chats by workspace. + next to a workspace starts a chat in it, and the folder button at the top makes a new workspace with the current one’s model, MCP servers and skills (change them in Settings → Workspaces). A new chat (⌘ J) starts in the workspace of the chat you’re in.

Demo mode checklist

Starter prompts that show off your best flows, in the order you want to present them.
Presenter mode — ⌘ . hides the sidebar and inspector and enlarges text. Toggle the inspector back with ⌘ I when you want to show “how it works”.
Compare — run the same question on two models live.
Command palette — ⌘ K to jump between workspaces, models and past chats without touching the mouse.
Light theme for projectors — the sun/moon icon in the top bar.

Chat history

Chats are saved to ~/.moka/sessions/ (or $MOKA_HOME/sessions). Search them from the sidebar or the command palette. Each chat stores both what you saw and the exact model message history, so reopening a chat and continuing works exactly as before.