User guide

Everything you need to dictate, polish, and summarize — and a plain-English explanation of what happens under the hood. Developers: the developer guide covers the codebase.

Getting started

1. Install. Windows 11 24H2+ (.exe installer). Kivo runs in the background — look for it in the system tray.

2. Walk through onboarding. First launch shows a short setup flow: permissions, shortcut overview, and the optional AI key. Closing Settings never quits Kivo — it keeps running quietly.

3. Grant permissions only when asked. Kivo never asks up front for everything. It prompts in context:

Permission	Why
Accessibility	Reads your current selection and inserts or replaces text.
Input Monitoring	Sees the modifier-only dictation gesture (holding `Ctrl` + `Win`).
Microphone	Records only while dictation is active — never in the background.
Speech Recognition	Sends audio to the operating system’s speech engine. Audio is never sent to Gemini.

Adding your AI key

Dictation works with no key at all — you get the raw OS transcript. Writing actions need a configured AI provider or a running local endpoint. Link summaries require Gemini.

To configure AI: open Settings → AI, choose Gemini, OpenCode Zen, OpenCode Go, or a custom OpenAI-compatible endpoint, and save a key if required. Arrange up to five models in order, then use Test connection. Requests try your model queue in order; key or balance problems stop failover. Local endpoints can work without a key.

Where’s my key stored? In Windows Credential Manager — managed entirely by the Rust process. It is never returned to the webview, never logged, and only leaves your machine inside the HTTPS request for the action you invoke.

Dictation

Hold, speak, release

Defaults: Ctrl + Win on Windows (changeable in Settings → Dictation). Hold the shortcut in any app, speak, release — the transcript lands at your cursor.

The Flow Bar

The pill overlay tells you exactly what’s happening:

State	Meaning
Waveform	Listening — speak now.
Finishing	Processing, including optional AI cleanup.
Checkmark	Inserted. The bar fades away on its own.
Error + Retry	Something failed (e.g. no speech heard). Retry if offered.

Press esc to cancel mid-dictation. Enable Show Flow Bar while idle in Settings if you want a quiet “ready” indicator between sessions.

AI cleanup (optional)

Improve dictated text with AI tidies punctuation and obvious filler without changing your meaning. Turn it off in Settings → Dictation for verbatim transcripts.

Language & microphone

Pick a microphone (or System Default) and a dictation language in Settings → Dictation. Automatic follows the system speech language on Windows — where only installed languages can start dictation.

Writing Tools

Select text in any app, hit your Writing Tools shortcut (Ctrl + Space). A compact popup opens next to your cursor or selection.

Action	Does	Result
Proofread	Fixes grammar and spelling	Can replace
Rewrite	Improves clarity and wording	Can replace
Shorten	Shortens, keeps meaning	Can replace
Friendly	Warms the tone	Can replace
Professional	Polishes the tone	Can replace
Summarize	Short overview	Preview first
Key Points	Extracts essentials	Preview first
Custom	“Describe your change…” in your own words	Can replace

Replace vs. Copy: summaries and key points preview a result first. Text results offer Copy and can offer explicit Replace when the captured selection allows it. Link summaries can only be copied.

Nothing selected?

With nothing selected, Kivo asks you to select text first. Highlight the text or a public webpage or YouTube URL, then invoke Writing Tools.

Keyboard-first

Arrow keys move through actions, Enter runs, typing jumps straight to a custom instruction, esc goes back or closes.

Summaries: articles, text & video

Select text to summarize it, or select a public link to preview a summary with its source URL:

Entry point	Use when
Summarize (with text selected)	You already highlighted an article or transcript.
Writing Tools (with a URL selected)	The selected public webpage or YouTube URL opens the link summary choice when Summarize is enabled.

Good to know. Webpages are retrieved via Gemini’s URL context; YouTube links use its video input. Only the link you submit is sent — Kivo never reads your tabs, cookies, or history. Private/unlisted videos and paywalled or sign-in pages aren’t supported; if retrieval fails, close the popup, select the article text or transcript, and invoke Summarize again.

Settings tour

General — launch at login, appearance (System/Light/Dark), idle Flow Bar, start in background.

Dictation — shortcut recorder, microphone, language, AI cleanup, sound feedback.

Writing Tools — shortcut and configurable writing actions with reset.

AI — provider selection, key management, connection testing, and an ordered model queue. Local AI endpoints are supported.

About — version and update check: stable releases offer in-app Download and Install plus Restart now, with a GitHub download fallback; beta installations can also follow the rolling beta through in-app updates when updater signing is configured.

How it works (the short version)

Kivo is one app with four small windows: the Flow Bar (dictation pill), Writing Tools (selection popup), Settings, and Onboarding. The visible interface is just presentation — all privileged work (shortcuts, window placement, speech, text replacement, credentials, Gemini calls) happens in the trusted Rust process.

Voice audio goes to your OS speech engine and comes back as text. That text is inserted locally. Writing actions, summaries, and optional AI dictation cleanup send text to the provider chosen in Settings. Local endpoints keep these requests on your computer. Link summaries require Gemini. Closing a popup cancels the pending request and discards late results.

Shortcuts

Where	Keys	Does
Anywhere	`Ctrl` + `Win` hold	Dictate; release to insert
Anywhere	Your writing shortcut	Open Writing Tools
Flow Bar	`esc`	Cancel dictation
Popup menu	Arrows · `Enter`	Move · run action

Both global shortcuts are re-recordable in Settings.

Limits & timing

Thing	Limit
Text summaries	Up to 200,000 characters — split longer pieces
Writing requests	20-second deadline
Link summaries	90-second deadline (retrieval takes longer)
Summaries vs. Replace	Summaries can’t replace — including via shortcut

A request already received by Gemini may still use quota even if you close the popup first. Long videos can use more quota than pasted text; normal Gemini usage limits and billing apply.

Troubleshooting

Dictation won’t start

Check the microphone permission, confirm the shortcut isn’t claimed by another app, and on Windows verify your speech language is installed.

Writing actions show a configuration error

You need a valid Gemini key: Settings → AI → save, then Test connection. A “rate limited” status means Gemini is throttling — wait and retry.

Replace doesn’t work in an app

Replacement needs native UI Automation access to the target app. If the OS can’t preserve the selection there, Kivo fails safely instead of mangling your text — use Copy and paste manually.

Link summary failed

Confirm the page or video is public. If retrieval fails, select its text or transcript and invoke Summarize again.