Skip to main content
Kalam Documentation

Context awareness

Read surroundings lets a Pro (or Pro trial) dictation profile pass lightweight context from your screen to Improve with AI, helping the polish step match names, tone, and technical terms already in front of you. Context is never sent to your speech engine.

Profile editor showing Read your surroundings toggle and context sources. (Click to zoom)

How context changes output (Example)​

Suppose you are replying in Gmail inside a thread where your teammate Ananya asked "Can we ship Thursday?" and you dictate "tell her yes if qa signs off by wednesday":

  • Without Read surroundings: Tell her yes if QA signs off by Wednesday.
  • With Read surroundings (Email profile): Hi Ananya,\n\nYes—we can ship Thursday if QA signs off by Wednesday.

Context sources per profile​

Configure Read surroundings individually inside each profile under Dictation → Profile → Read your surroundings:

SourceWhat Kalam readsWhen it is captured
Active app contentDepth setting: Off, Window title, Focused field, or Extended (password fields are never read)After you finish speaking
ClipboardPlain text currently on your clipboardWhen you press your dictation shortcut
Selected textText highlighted when you start dictating (Windows & macOS)When you press your dictation shortcut
Date and timeYour local date and time (helpful for "tomorrow" or "next Friday")After you finish speaking

Platform differences​

SourceWindowsmacOSLinux
Active app contentWindow title, focused field, and ExtendedWindow title and focused field (Extended best-effort)Capped at Window title (Wayland titles depend on compositor support)
ClipboardSupportedSupportedBest-effort (may be empty on GNOME Wayland / COSMIC)
Selected textAccessibility APIs (may vary in terminals/PDFs)Uses Accessibility permissionNot available
Date and timeSupportedSupportedSupported

Sensitive apps override context​

Whenever the active window matches Sensitive apps, Kalam blocks all context capture—app name, window title, focused field, clipboard, and selection stay completely unread.