Labs
Labs lets you turn on the Kalam plugin platform, install the official reference suite, switch custom Pill skins on Windows and macOS, and inspect plugin worker diagnostics. Plugins stay off until you opt in.
Screenshot needed
labs.webp
Visible. Labs title, Experiments toggles (Plugin platform, Developer mode), Reference plugin suite, and Your plugins cards.
Capture. Paper theme, Labs view with Plugin platform enabled.
Alt. Labs screen showing the Plugin platform toggle, Reference plugin suite cards, and installed plugins list.
labs.webp is added under apps/docs/static/img/screenshots/.Turn on the plugin platform
- Open Labs in the sidebar.
- Under Experiments, switch Plugin platform on.
- Leave Developer mode off unless you are authoring a plugin. Turning Developer mode on exposes your Plugins directory controls (Open plugins folder and Copy path), manifest validation checks, and live worker logs.
Install the reference plugin suite
Under Reference plugin suite, click Install reference suite (or install individual entries) to copy the five official reference plugins into your plugins folder (~/.kalam/plugins on macOS/Linux, %USERPROFILE%\.kalam\plugins on Windows):
| Plugin | What it adds |
|---|---|
| Kulta Tasks | Voice-driven tasks and checklists |
| Focus Time Tracker | Tracks focus time in the active window |
| Pomodoro Pill | Adds a Pomodoro timer chip to the Pill |
| Voice Flow Coach | Adds a speaking-pace badge |
| Smart Text Stamp | Masks secrets before dictated text is typed |
Use Update reference suite whenever a newer build updates the bundled examples.
Manage installed plugins
Your plugins scans every subfolder in your Plugins directory containing a kalam-plugin.json manifest and reports how many are active (N of M turned on). Filter by All, Running, Voice actions, Sidebar views, or Pill & overlay (search appears once seven or more plugins are installed).
Open any plugin card to view its Settings (manifest preferences), Capabilities, Diagnostics (folder path, plugin ID, triggers, worker output), Open view, and Restart.
| Status badge | Meaning |
|---|---|
| Off | Installed in your Plugins directory, disabled |
| Standby | Enabled; background worker starts on demand |
| Running | Worker active |
| Stopped after error | Worker exited with an error — inspect Diagnostics |
| Ready / Needs attention | Manifest loaded cleanly or failed manifest validation |
Custom Pill skins
On Windows and macOS, plugins that bundle a Pill skin show Use as Pill skin to replace the default Pill look, or Restore Default Pill to revert. On Linux, dictation stays in the panel chip; plugins can still surface chips through a Pill slot (Linux panel chip).
Sensitive app isolation
Apps protected by Sensitive apps stay isolated from plugins—Kalam withholds protected window titles and transcripts from plugin workers.