GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - mikker/LeaderKey: The *faster than your launcher* launcher

BranchesTags
Open more actions menu

Latest commit

 

History

159 Commits
159 Commits

Folders and files

NameName
Last commit message
Last commit date
.cursor
.cursor
 
 
.github
.github
 
 
Leader Key.xcodeproj
Leader Key.xcodeproj
 
 
Leader Key
Leader Key
 
 
Leader KeyTests
Leader KeyTests
 
 
Updates
Updates
 
 
bin
bin
 
 
.editorconfig
.editorconfig
 
 
.gitignore
.gitignore
 
 
.swift-version
.swift-version
 
 
AGENTS.md
AGENTS.md
 
 
CLAUDE.md
CLAUDE.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
buildServer.json
buildServer.json
 
 

Repository files navigation

NB: Leader Key has been surpassed by Tuna

Tuna is a complete launcher – much more capable, and with Leader Key built in!

Meet Tuna

Leader Key will stay free and open source but my focus will be on Tuna going forward.


Leader Key.app

The *faster than your launcher* launcher

A riff on Raycast, @mxstbr's multi-key Karabiner setup, and Vim's <leader> key.

Watch the intro video on YouTube:

Yes, I only have that one thumbnail face.

Install

Download

📦 Download latest version or

Homebrew

$ brew install leader-key

Post-Install setup

  • Open the settings menu with the menu bar icon Screenshot 2025-05-21 at 1 58 46 PM

  • Choose your leader (Shortcut that will open the app)

    Screenshot 2025-05-21 at 2 01 56 PM
  • Add your shortcuts to the Config settings

Why Leader Key?

Problems with traditional launchers:

  1. Typing the name of the thing can be slow and give unpredictable results.
  2. Global shortcuts have limited combinations.
  3. Leader Key offers predictable, nested shortcuts -- like combos in a fighting game.

Example Shortcuts:

  • leaderom → Launch Messages (open messages)
  • leadermm → Mute audio (media mute)
  • leaderwm → Maximize current window (window maximize)

URL Scheme

Leader Key supports URL scheme automation for integration with tools like Alfred, Raycast, shell scripts, and more.

Available URL Schemes

Configuration Management

# Reload configuration from disk
open "leaderkey://config-reload"

# Show config.json in Finder
open "leaderkey://config-reveal"

Window Control

# Show Leader Key window
open "leaderkey://activate"

# Hide Leader Key window
open "leaderkey://hide"

# Clear navigation state (return to root)
open "leaderkey://reset"

Settings & Info

# Open settings window
open "leaderkey://settings"

# Show about dialog
open "leaderkey://about"

Navigation

# Navigate through keys and execute actions
open "leaderkey://navigate?keys=a,b,c"

# Navigate without executing (preview mode)
open "leaderkey://navigate?keys=a,b,c&execute=false"

Example Use Cases

  • Alfred/Raycast workflows: Trigger Leader Key shortcuts programmatically
  • Shell scripts: Automate configuration reloads after editing config.json
  • Keyboard maestro: Chain Leader Key actions with other automations
  • External triggers: Open specific action sequences from other applications

FAQ

What do I set as my Leader Key?

Any key can be your leader key, but only modifiers will not work.

Examples:

  • F12
  • ⌘ + space
  • ⌘⌥ + space
  • ⌘⌥⌃⇧ + L (hyper key)

Advanced examples:

Using Karabiner you can do more fancy things like:

  • right ⌘ + left ⌘ at once (bound to F12) my personal favorite
  • caps lock (bound to hyper when held, F12 when pressed)

See @mikker's config in the wiki for akimbo cmds example.

I disabled the menubar item, how can I get Leader Key back?

Activate Leader Key, then cmd + ,.

Command action is failing with "Command not found"

You need to make sure your shell environment is correctly set up for non-interactive mode, and exports the PATH variable.

For zsh make sure you have your PATH variable exported in ~/.zshenv

For bash make sure you have your PATH variable exported in ~/.bash_profile

License

MIT

About

The *faster than your launcher* launcher

mikkelmalmberg.com/apps

Topics

macosmacos-app

Resources

Readme
MIT license
Activity

Stars

2.3k stars

Watchers

20 watching

Forks

96 forks
Report repository

Releases

Sponsor this project

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.