Notifications, inbox & voice settings
Controls what shows up in your unified inbox, how and when Omniscio alerts you, and how voice commands and text-to-speech behave.
Alarm assertiveness {#alarmsAssertiveness}
Choose how forcefully an alarm interrupts you when it fires. Full-screen modal (the most assertive option) takes over the screen until you dismiss it — use this for alarms you cannot afford to miss. Banner toast pops up in the corner and fades; it still plays a sound. Silent banner shows the same corner pop-up but skips the sound entirely, so you see the alert without being interrupted mid-call or mid-focus. You can override the assertiveness for any individual alarm; this setting is the fallback default for alarms that do not specify their own. Accepted values: "modal", "banner", "silent-banner".
Inbox analytics {#inboxAnalyticsEnabled}
When turned on, Omniscio quietly tracks how you work with inbox items — how long things wait before you clear them, how often you open the inbox without acting, and roughly how much time you spend on each item. That data feeds the Stats → Inbox tab so you can spot patterns over time. Everything stays on this device; no message content, phone numbers, or identifiers are ever stored. Turn it off if you do not want that tracking at all. Default: on.
Show sessions in inbox {#inboxShowSessions}
Controls whether Claude Code sessions that need your attention appear in the unified inbox. When on, any session that has finished a turn and needs your reply — an answer, a question, a plan approval, a permission request, a mission, or a merge-conflict handback — shows up as an inbox row. Errored, stalled, stopped, recovery-failed, and rate-limit-waiting sessions never appear in the inbox; they wait in their project's Interrupted section in the sidebar instead. Turn it off to keep the inbox clear of session cards and rely only on the sidebar indicators. Default: on.
Show SMS in inbox {#inboxShowSms}
Controls whether incoming text messages routed via Pushbullet appear as rows in the unified inbox. When on, each incoming SMS creates an inbox card you can read and reply to without leaving Omniscio. Turn it off if you prefer to handle texts in your phone's own messaging app and want to keep the inbox free of SMS cards. Requires the SMS integration (Pushbullet) to be set up separately. Default: on.
Show Telegram in inbox {#inboxShowTelegram}
Controls whether incoming Telegram messages appear as rows in the unified inbox. Omniscio connects to Telegram via the MTProto protocol directly — no bot required. When on, new Telegram messages land in your inbox alongside your other communications. Turn it off to stop Telegram cards from appearing there. Requires a Telegram account to be connected in Settings. Default: on.
Show daily digest in inbox {#inboxShowDigest}
Controls whether your daily briefing summary appears in the unified inbox. When on, the morning digest card — a summary of overnight AI session activity across all your hubs — shows up as an inbox row. Turn it off to stop the digest from cluttering the inbox; the digest is still generated and accessible elsewhere. Default: on.
Show calendar reminders in inbox {#inboxShowCalendar}
Controls whether Google Calendar reminders and agenda items appear in the unified inbox. When on, upcoming events and reminders land in your inbox alongside sessions and other channels. Turn it off to keep the inbox free of calendar cards and rely on the Calendar panel instead. Requires Google Calendar to be connected. Default: on.
Show cron jobs in inbox {#inboxShowCron}
Controls whether cron jobs waiting for your approval appear in the unified inbox. When on, a cron job with a pending approval creates an inbox row so you can approve or reject it there. Cron run results are not inbox rows, and cron failure alerts are CLI approval cards that follow the "Show CLI approvals in inbox" switch instead. Turn it off if you want to handle cron approvals only from the Cron Jobs hub. Default: on.
Show automations in inbox {#inboxShowAutomations}
Controls whether automation rules waiting for your approval appear in the unified inbox. When on, a rule with a pending approval creates an inbox card so you can approve or reject it there. Turn it off if you would rather handle automation approvals only from the Automation Rules hub. Default: on.
Show CLI approvals in inbox {#inboxShowCliPending}
Controls whether pending CLI approval requests appear in the unified inbox. When on, any change an agent or external tool has asked Omniscio to make through the local control server (and cron failure alerts) shows up as an inbox row, prompting you to act. These are not tool-permission prompts inside a session; those show on the session's own row. Turn it off to suppress these cards — but be aware that pending requests will then only be visible via the CLI approval panel. Default: on.
Show recipes in inbox {#inboxShowRecipes}
Controls whether recipe items that need you appear in the unified inbox. When on, recipe approvals, recipe-authoring approvals, and recipe runs that failed, stalled, or stopped incomplete create inbox rows. Successful runs do not. Turn it off if you prefer to check recipes in the Recipes panel rather than the inbox. Default: on.
Low disk space alerts {#lowDiskSpaceAlertEnabled}
When on, Omniscio warns you in the inbox if free disk space drops below your configured floor and automatic cleanup cannot recover enough space. The warning is an inbox card, not a system notification. Turning this off silences only the warning — the automatic disk cleanup (which removes finished worktrees to protect your drive) keeps running regardless. Default: on.
Low disk space floor {#lowDiskSpaceFloorGb}
The minimum amount of free space Omniscio tries to keep on your working drive, in gigabytes. When free space drops below this number, finished worktrees are automatically cleaned up. If cleanup cannot recover enough space and low-disk alerts are on, you receive an inbox warning. Range: 5 to 500 GB. Adjust upward if you work with very large repos or want a bigger safety buffer.
SMS offline alerts {#smsHealthAlertsEnabled}
When on, Omniscio raises an inbox alert and a single notification if SMS is turned on but stops working — for example, if your Pushbullet token expires or the connection drops for a sustained period. The alert clears automatically once SMS reconnects, so you do not need to manually dismiss it. Turn it off if you are OK discovering SMS outages on your own. Only relevant while the SMS integration is enabled. Default: on.
Meeting Rooms {#meetingRoomsEnabled}
Shows the Meeting Rooms panel in the sidebar and enables the Ctrl+Shift+Z keyboard shortcut to open the quick-launch palette. Meeting Rooms let you save your recurring video call links (Zoom, Google Meet, Teams, etc.) for one-tap joining. Your saved rooms are preserved when you disable this — turning it back on restores them. Turn it off if you do not use saved meeting links and want to keep the sidebar uncluttered. Default: off.
Meeting call auto-detection {#meetingsAutoDetectEnabled}
When on, Omniscio watches for an active audio call on your computer — including browser-based calls like Google Meet and Microsoft Teams — and automatically shows a heads-up overlay so you can start capturing notes without manually starting a recording. Turn it off if you always start meetings manually or find the automatic prompt distracting. Default: off.
Live transcript indicator {#meetingsLiveIndicator}
When on, a small floating window appears on screen while a meeting is being recorded, showing the live transcript as it is being captured. It gives you a real-time view of what is being transcribed so you can catch any errors immediately. Turn it off if you find the overlay distracting and prefer to review the transcript afterward. Default: on.
Speaker attribution {#meetingsSpeakerAttribution}
When on, the transcript labels each line with who said it — distinguishing your voice from other participants. This makes the transcript easier to follow when reviewing a meeting with multiple speakers. If your transcription provider does not detect multiple speakers cleanly, turning this off can produce a cleaner single-stream transcript. Default: on.
Summary language {#meetingsSummaryLanguage}
The language Omniscio uses when writing the AI-generated notes and summaries for your meetings. This is the OUTPUT language — it controls what language the summary is written in, not what language is spoken. Set it to match the language you want to read your notes in. You can set this independently from the transcription language, so you can speak in one language and receive notes in another.
Transcript auto-delete {#meetingsTranscriptRetention}
Automatically deletes the raw meeting transcript after a set period to save space and protect privacy. Options are to never delete, or to delete after 30 days, 90 days, or 1 year. Your AI-written notes and summaries are always kept — only the raw transcription text is removed. Set to Off if you want to keep raw transcripts indefinitely. Default: off.
Transcription language {#meetingsTranscriptionLanguage}
The language spoken in your meetings, used to improve the accuracy of the live transcriber. Setting this correctly helps the speech recognition engine handle accents, vocabulary, and phrasing for the language you actually speak during calls. You can set it independently from the summary language.
Wake word detection {#wakeWordEnabled}
When on, Omniscio listens for one of two wake phrases — say "Hey Omniscio" or "Computer" — to activate voice commands without touching the keyboard. This keeps your hands free during tasks. The built-in engine (OpenWakeWord) runs locally at no cost and requires no account or API key. Requires voice commands to also be enabled. Default: off.
Error/warning display time {#toastDisplayDurationSeconds}
How long error and warning toasts stay on screen before auto-dismissing. Choose from preset durations: 5, 8, 10, 15, or 30 seconds. The default (8 seconds) matches the previous fixed duration. Success and info toasts are unaffected and always use a shorter fixed duration. If code passes an explicit duration when creating a toast, it overrides this setting. Number (seconds); accepted values: 3–30. Default: 8.
Notification timing {#notificationBehavior}
Controls when Omniscio sends OS-level notifications to your taskbar or notification center. Always sends a notification every time a session needs attention, even if Omniscio is in the foreground. Backgrounded (the default) sends notifications only when Omniscio is in the background or minimized — so you are not double-alerted while already looking at the app. Never disables all OS notifications from Omniscio entirely. Accepted values: "always", "backgrounded", "never". Default: "backgrounded".
Notification history {#notificationHistoryEnabled}
When on, Omniscio keeps a local log of every notification sound decision — whether a chime fired, was suppressed, or was rate-limited — so you can always look up "what was that sound?" in Settings → Notifications. The log stays on this device and is bounded in size. Turn it off to stop recording chime history; the notification sounds themselves are unaffected. Default: on.
Notification sounds {#notificationSoundEnabled}
Master switch for all notification chime sounds in Omniscio. When off, no sounds play for any session event — needs-you, stalled, or error — regardless of the per-event sound settings below. Turn it off for a fully silent experience, or use a headphone-friendly alternative. Default: on.
Needs-you sound {#notificationSoundNeedsYou}
The sound Omniscio plays when a session switches to "Needs You" — the agent has asked a question or is waiting for your reply. You can set a custom audio file path or use one of the built-in sounds. The default is builtin:alert-ping. Works only when notification sounds are on and the volume is above zero.
Stalled sound {#notificationSoundStalled}
The sound Omniscio plays when a session appears to have stalled — it has been running without producing output for longer than expected. You can set a custom audio file path or use one of the built-in sounds. The default is builtin:soft-bell, which is intentionally gentler than the needs-you alert. Works only when notification sounds are on.
Error sound {#notificationSoundError}
The sound Omniscio plays when a session hits an error state. You can set a custom audio file path or use one of the built-in sounds. The default is builtin:attention. Works only when notification sounds are on.
Notification volume {#notificationSoundVolume}
Sets how loud all notification sounds play, from 0 (silent) to 1 (full volume). The default is 0.5 (half volume). This applies to every notification chime — needs-you, stalled, and error alerts all share this volume setting. Alarms use the same volume by default but can be overridden per alarm.
Mobile sound {#mobileSoundEnabled}
When on, Omniscio plays notification sounds on the mobile web app in addition to the desktop. Off by default because mobile browsers often restrict auto-playing audio. Turn it on if you use the mobile interface and want audio chimes there as well.
Text-to-speech {#ttsEnabled}
Master switch for Omniscio's read-aloud feature. When on, you can have session replies spoken aloud via a voice synthesis provider of your choice. Turning it on unlocks the TTS controls below and reveals the speaker button in the session header (if showSessionVoiceButton is also on). Off by default. Requires a supported TTS provider to be configured with a valid API key.
Auto-read replies {#ttsAutoRead}
When on, Omniscio automatically speaks each new completed session reply aloud as it arrives, without you pressing the play button. Use this for a fully hands-free experience. Off by default — when off, replies are only read when you manually press the speaker button. Requires ttsEnabled to be on.
TTS daily cost cap {#ttsDailyCapUSD}
The maximum amount Omniscio will spend on text-to-speech audio synthesis each calendar day, in US dollars. Once the cap is reached, read-aloud stops for the rest of the day. Range: $0 (disables TTS) to $100. Default: $5. Adjust upward if you use TTS heavily and keep hitting the cap.
TTS provider {#ttsProvider}
The voice synthesis service used to generate spoken audio. Each provider has different voice styles, latency characteristics, and pricing. Options: Fish Audio (the default), Grok (xAI), ElevenLabs, Speechify, Pika, and Soniox. Fish Audio and Soniox are company-funded (no personal API key needed); the others bill to your own provider key. Requires ttsEnabled to be on.
TTS speed {#ttsSpeed}
How fast the synthesized voice speaks, from 0.5× (half speed) to 2× (double speed). The default is 1.0 (normal speed). This setting bakes the tempo into the generated audio at synthesis time. If you want to adjust playback speed without re-synthesizing, use the narration playback rate setting instead. Requires ttsEnabled to be on.
TTS volume {#ttsVolume}
The playback volume of spoken audio, from 0 (silent) to 1 (full volume). The default is 0.8. This is separate from the notification sound volume — it controls only the TTS read-aloud level. Requires ttsEnabled to be on.
TTS character limit {#ttsMaxChars}
The maximum length of a single message that Omniscio will read aloud in full, measured in characters. Messages longer than this limit are handled according to your summarization mode setting. Range: 100 to 10,000 characters. Default: 2,000. Increase it if you often want very long replies read verbatim; lower it to keep spoken replies brief.
TTS summarization mode {#ttsSummarizationMode}
What Omniscio does when a reply exceeds the character limit above. Verbatim reads the full text regardless of length. Summarize always condenses the reply before speaking it. Auto (the default) reads short replies in full and summarizes only when the reply exceeds the threshold below. Accepted values: "verbatim", "summarize", "auto".
Show TTS button in session header {#showSessionVoiceButton}
When on, a speaker icon appears in the session header bar so you can trigger read-aloud from within a session without opening settings. Hidden by default to keep the session header uncluttered. Requires ttsEnabled to also be on — enabling this setting alone will not show the button until TTS is turned on. Default: off.
Voice commands {#voiceEnabled}
Master switch for voice input and commands. When on, Omniscio listens for your voice via the microphone — you can speak to send messages, issue commands, and navigate the app. Turning it on also unlocks wake-word detection and the voice command settings. Off by default. This is the top-level gate; all other voice features require this to be on. Enabling voice implies consent to send your audio to the configured speech-to-text provider.
Voice feedback sounds {#voiceFeedbackSounds}
When on, Omniscio plays small audio cues to confirm voice actions — for example, a brief tone when it starts listening, finishes processing, or completes a command. These sounds help you know your voice input was heard without looking at the screen. Turn it off for a fully silent voice experience. Requires voiceEnabled to be on. Default: on.
Voice response style {#voiceResponseStyle}
Controls how the AI responds when you send a message by voice. Off means the AI replies the same way it would for a typed message — no length adjustment. Short keeps replies brief and to the point, better suited for spoken responses. Conversational strikes a middle ground: friendly and natural, but not as terse as "short." Accepted values: "off", "short", "conversational". Default: "off".
Speech-to-text provider {#voiceSttProvider}
The service that converts your spoken audio to text for voice input. Options: Deepgram Nova-3 (the default — fast, streaming), ElevenLabs Scribe v2 (lowest latency), Groq Whisper v3 Turbo (transcribes after you stop speaking), Grok/xAI (in development, requires xAI key), and Built-in/local (free, runs on your own computer — revealed by localSttEnabled). Each provider has different latency, accuracy, and cost characteristics. Requires voiceEnabled to be on. Default: "deepgram".
Filter spam {#spamFilterEnabled}
Checks messages from people you don't know and keeps junk in Spam. Messages from people you know are never checked. Off by default, so nothing is filtered until you turn it on; the per-channel switches below are then live, and each is disabled until this one is on. Toggle; accepted values: true | false. Find it in the Inbox hub's Spam tab.
Filter spam in texts {#spamFilterSmsEnabled}
Checks texts from numbers that aren't saved as contacts and that you have never texted. Short-code senders such as bank and login codes are never checked. On by default, but it does nothing until Filter spam is on.
Filter spam in agent email {#spamFilterAgentEmailEnabled}
Checks new email from strangers to your agent's address and your public support address. Caught mail starts no session and gets no reply, so junk sent to your agent cannot quietly spend a session. On by default, but it does nothing until Filter spam is on.
Filter spam in calendar invites {#spamFilterCalendarEnabled}
Checks calendar invites from organizers outside your own organization. A caught invite is hidden rather than announced — you get no notice for it. On by default, but it does nothing until Filter spam is on.
Remove invites from blocked senders {#spamFilterCalendarDeleteEvent}
Also deletes an invite from your Google Calendar when it comes from a sender you have marked as spam. Invites the automatic check catches are only hidden, never deleted; this is the switch that removes them. Deleted invites stay in Google Calendar's trash for 30 days. On by default, but it does nothing until Filter spam is on.