Skip to main content
Interface Guide

One floating pill. Every state it can be in.

Pulse is a translucent overlay — no window chrome, no taskbar entry. Below is the real, shipped interface at its actual size: the same component, just a different border color and two lines of text for each state.

Core states

Every one of these is the exact same component — just a different border color and two lines of text. That's the whole interface.

Say "Pulse" or type below
Idle

Resting state. Fades to 35% opacity after a few seconds of inactivity so it stays out of the way, and brightens instantly on hover or activity.

Listening…
Listening

Triggered by the wake word or a click on the orb. The border itself glows blue and breathes — not just a small status dot.

Thinking…
"open my email folder"
Thinking

Transcript captured, the planner is reasoning about the next step — with your on-screen context already factored in.

Working on it…
open_app { "name": "notepad" }
Acting

A tool is executing. The detail line shows exactly what's running, live — no black box, no silent action.

Speaking…
Opening Notepad and typing your note now.
Speaking

Pulse is talking. Interruptible mid-sentence by saying the wake word again — genuine barge-in, not a queued interruption.

Pulse core not running
Start run.bat to launch Pulse
Disconnected

Backend unreachable. The overlay retries every 500ms for the first 10 seconds, then backs off — never a silent freeze.

Wake-word training

Training happens entirely on your voice, entirely on your machine. The pill's glow is the only progress indicator — no separate dialog, no extra window.

Working on it…
Sample 3 of 5…
Training — in progress

Wake-word retraining, using only your own voice. The whole app deliberately blocks other commands until it finishes.

Working on it…
✓ Wake word trained: pulse
Training — done

Border holds solid green for 6 seconds, then fades back to idle. The new model hot-swaps in — no restart needed.

Working on it…
Training failed — model unchanged
Training — failed

The old, working model stays untouched. Wake detection resumes automatically either way — never left silently off.

Controls

A collapsible panel keeps the always-on-top overlay minimal by default, and expands to full controls with one click.

One switch for Superhero Mode

Guided feedback, window narration, and typing echo — toggled together, not three settings to hunt for.

Screen-aware, without asking

Pulse keeps a lightweight read of your focused window running in the background, so “open my email folder” resolves against what’s actually on screen — not a blind filesystem search.