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.
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:
| Source | What Kalam reads | When it is captured |
|---|---|---|
| Active app content | Depth setting: Off, Window title, Focused field, or Extended (password fields are never read) | After you finish speaking |
| Clipboard | Plain text currently on your clipboard | When you press your dictation shortcut |
| Selected text | Text highlighted when you start dictating (Windows & macOS) | When you press your dictation shortcut |
| Date and time | Your local date and time (helpful for "tomorrow" or "next Friday") | After you finish speaking |
Platform differences
| Source | Windows | macOS | Linux |
|---|---|---|---|
| Active app content | Window title, focused field, and Extended | Window title and focused field (Extended best-effort) | Capped at Window title (Wayland titles depend on compositor support) |
| Clipboard | Supported | Supported | Best-effort (may be empty on GNOME Wayland / COSMIC) |
| Selected text | Accessibility APIs (may vary in terminals/PDFs) | Uses Accessibility permission | Not available |
| Date and time | Supported | Supported | Supported |
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.