Docs/Using Chervil

Hey Sprig (voice)

Talk to Chervil hands-free with the on-device wake word.

You can summon Sprig with your voice. Say "Hey Sprig" and Chervil wakes up, listens for your request, and gets to work — no clicking required.

On-device wake word

The wake word is detected on your device — Chervil isn't streaming your microphone to the cloud to listen for it. It waits locally for "Hey Sprig" and only then handles your request.

Using it

  • Enable Hey Sprig in Settings.
  • Say "Hey Sprig", then your request — "Hey Sprig, plan my afternoon".
  • Chervil pops up, captures what you say, and Sprig responds like any other request.

It's a natural fit for quick, hands-free asks while you're doing something else — and it pairs well with composed pages you can glance at and act on.

The quick bar, by keyboard

The same floating bar answers to a global hotkey — Ctrl+Shift+Space — from anywhere, even when Chervil isn't focused. Type a request to compose a page, or tap 💬 to turn the bar into a chat: ask a quick question and Sprig answers right there, with no tab opened and no page built. When a quick chat turns into real work, ↗ Open in Chervil carries the whole conversation into the app.

Confirm before it composes

By default, a wake word doesn't compose anything on its own. Chervil shows you what it heard and waits for you to press Compose (or Enter) — and if you don't, it quietly cancels after a few seconds. That way a stray "Hey Sprig" from a TV or a noisy room can't run off and build a page by itself. If you're in a quiet spot and want the old hands-free behavior, turn off "Confirm before composing from a wake word" in Settings → Voice.

Tuning for a noisy room

Live with a TV, music, or chatter that never stops? Turn on Noisy room mode in Settings → Voice. It changes how Chervil listens, end to end:

  • the wake word must be a clearer match, held across several moments — a single lucky blip from a broadcast won't fire it, and after a wake it cools down before listening again;
  • the command capture tracks the room's background level and only counts audio that clearly rises above it as your voice — a TV's steady murmur doesn't qualify;
  • if nobody actually speaks after a wake, the recording is thrown away without ever being transcribed; and
  • the confirm step always applies, even if you've turned the confirm toggle off.

In a quieter room, the Wake-word threshold slider is still the gentler dial — higher means Chervil needs a clearer match before it wakes.