Chapter · Documentation

How it works.

Reference docs for Keyfloe — what each capability does, how to drive it from the keyboard, and what stays on your Mac. We're filling these in as features stabilise.

Living document

Getting started.

  1. Install. Drag Keyfloe.app to your Applications folder.
  2. Grant permissions. First launch walks you through Accessibility, Microphone, Screen Recording, and Files & Folders. These let the pill respond to fn, hear your voice, see what you're working on, and organise files when asked.
  3. Press fn. Tap to open the pill. Hold to dictate. That's the whole UI.

Capabilities.

Voice

Hold fn while you speak. On release the words land in the active text field. Transcription runs locally on your Mac's Apple Neural Engine via WhisperKit — your voice never leaves the device.

Chat

Tap fn once. The pill appears under your cursor; type a question, hit return. The pill reads what's on your screen so you don't need to copy + paste context.

Background tasks

Ask "organise my Downloads" or "rename these screenshots" and the agent runs in the background. It pings you with a notification when it's done — or earlier if it needs a decision.

Memory

Ambient memory (opt-in) captures a thumbnail + OCR of your screen every few seconds. Searchable locally with natural language ("the link I saw at 2pm"). Never uploaded.

Keyboard map.

  • fn tap — open the pill
  • fn hold — dictate into the focused field
  • ⌘⇧Space — backup activation chord (Carbon-level, works everywhere)
  • Esc — close the pill
  • ↑ ↓ — cycle through suggestion chips
  • ⌘F in the dashboard — global search of memory + transcripts

Privacy.

See the privacy policy for the full list. Short version: everything that can run locally does. Cloud is opt-in per request and clearly indicated.