Skip to main content
Kalam Documentation

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.

Placeholder until labs.webp is added under apps/docs/static/img/screenshots/.

Turn on the plugin platform​

  1. Open Labs in the sidebar.
  2. Under Experiments, switch Plugin platform on.
  3. 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):

PluginWhat it adds
Kulta TasksVoice-driven tasks and checklists
Focus Time TrackerTracks focus time in the active window
Pomodoro PillAdds a Pomodoro timer chip to the Pill
Voice Flow CoachAdds a speaking-pace badge
Smart Text StampMasks 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 badgeMeaning
OffInstalled in your Plugins directory, disabled
StandbyEnabled; background worker starts on demand
RunningWorker active
Stopped after errorWorker exited with an error — inspect Diagnostics
Ready / Needs attentionManifest 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.