flash

Flash manual

Flash is a resident macOS app: keyboard hints for every control, a Vim-like normal mode over all of macOS, a mouse grid, a tmux-style status bar, desktop widgets, terminal popups and sandboxed plugins, configured in one TOML file. This site is the full manual; the project README is the short version, and :help inside Flash shows the concise guides next to the live state of your own installation.

Start here

• Getting started: one hotkey, then the grid, search, normal mode, the bar and widgets.
• Configuration and the full default reference.
• Commands: every flash <verb> and its options.
• Privacy: each permission prompt, network destination and file.
• Troubleshooting, starting with flash doctor.

Coming from another tool

Alternatives compares Flash with Neru, Homerow, Shortcat, Vimium, Hammerspoon, SketchyBar, AeroSpace and others, one page each, with what they do better and how to move your setup over.

Going deeper

The status format, plugins, widgets and popups pages cover the bar; the plugin cookbook, protocol and Rust SDK cover writing plugins; the architecture, development and release pages cover contributing.

This site is open source. Improve this page.