WAWE app icon
macOS 26+·Swift 6.4·MIT·Menu-bar app

Press ⌥ Esc.
Know the term.
Keep your flow.

WAWE is a keyboard-first, distraction-free glossary that lives in your Mac's menu bar. Summon it from anywhere, fuzzy-search a term, and learn it in seconds — without ever touching the mouse.

Download the DMG
Scroll — the tour is keyboard-driven too
WAWE — Overlay
WAWE demo — search a term, open it, step through the four tiers
Every term unfolds through What It IsAnalogyWhy It MattersExample. That's the name.
One Space key reveals the next block — then closes them, on a loop.
Copy a term anywhere clipboard and it's already open when you summon.
147 terms built in. Yours merge in from a plain glossary.json — no rebuild, no restart ceremony.
Raycast-style Overlay, or a compact Mini dropdown menu bar — light, dark, or system.

Don't take our word for it.
Press ⌥ Esc — the demo below is the app.

A working slice of WAWE, running in your browser with the same keys. Click the panel, then type. Frecency ranking, single-key disclosure and all.

    ↑↓ move Enter open Space reveal ⌘C copy Esc back
    Click the panel to focus · real app ranks by frecency

    Everything, on the keyboard

    01Global summon

    ⌥Esc shows or hides the overlay from any app — a Carbon global hotkey you can rebind to ⌃Esc, ⇧Esc, ⌘Esc, ⌃Space and more in Settings.

    02Fuzzy, usage-aware search

    Type to filter. Frecency ranking floats your most-used terms up the list — without ever beating a better text match.

    03Single-key disclosure

    A one-line summary first, then Space unfolds Analogy → Why It Matters → Example, one block per press. Once everything's open, it closes them back down, on a loop. Cognitive load stays minimal.

    04Two presentation modes

    A centered, Raycast-style Overlay panel, or a compact Mini dropdown straight from the menu bar. Three panel sizes, Light / Dark / System theming.

    05Your terms, plain JSON

    An editable glossary.json is the source of truth — add terms without rebuilding. Bad JSON? The app keeps the built-ins and tells you. Updates merge in new built-ins without touching your edits.

    06Signed & notarized

    The DMG is signed with a Developer ID and notarized by Apple — it opens with a normal double-click, no Gatekeeper prompts. MIT licensed, 100% Swift.

    Light or dark — it matches your Mac

    A centered, Raycast-style panel — summon it from any app with ⌥Esc. These buttons flip the whole site, and the app with it.

    WAWE in Overlay mode
    Overlay — expanded term · light theme

    Psst — there's a Mini mode hiding in the menu bar at the top of this page. Click the little WAWE icon.

    The whole manual

    ⌥ Esc
    Summon / hide — global, rebindable
    type
    Fuzzy-filter the terms
    Move through results
    Enter
    Open the highlighted term
    Space
    Reveal the next block; then close them, on a loop
    ⌘ C
    Copy the active term
    Esc
    Back one step: term → list → clear → close
    Install — 20 seconds

    Requires macOS 26 (Tahoe) or later. Then it's two commands.

    zsh
    # Homebrew — recommended, so `brew upgrade` keeps it current
    $ brew tap aka-kika/wawe
    $ brew install --cask wawe
    # then launch it and press ⌥Esc

    Or grab the signed, notarized WAWE-x.y.z.dmg from the latest release and drag WAWE into Applications. If Homebrew flags the tap as untrusted, run brew trust aka-kika/wawe once and install again.

    Developer ID signed Notarized by Apple MIT license No Dock icon — menu-bar agent

    Questions, answered.

    What does WAWE stand for?

    What It Is · Analogy · Why It Matters · Example — the four tiers each term unfolds through. The pedagogy is the name.

    Do I ever need the mouse?

    No. Summoning, searching, opening, revealing, copying, and dismissing are all keyboard-driven. The mouse works, but nothing requires it.

    Can I add my own terms?

    Yes — on first launch the app seeds an editable file at ~/Library/Application Support/WAWE/glossary.json. Settings → Copy Template gives you the exact JSON shape; paste it in, then Reload. When an update ships new built-ins, they're merged in automatically without touching your terms.

    What's inside the built-in glossary?

    147 terms across AI/LLM, dev practice, data, security, web, and systems — each with a one-line summary, a vivid analogy, a why-it-matters, and a concrete example.

    Is it free? Is it safe to open?

    Free and MIT-licensed, source on GitHub. The DMG is signed with a Developer ID, notarized by Apple, and stapled — so it opens with a normal double-click, no "damaged" or "unidentified developer" prompts.

    Can I build it from source?

    Yes — Xcode 27 / Swift 6.4 on macOS 26+. swift run WAWE to run in dev, swift test for the unit tests, and scripts/build-app.sh for a local WAWE.app.