v1.4.0 · Current release

Spotlight bar for Omarchy.

Launch apps, switch windows, find files and calculate. Convert currencies and units, all from Super .

What it does

Apps, calculations and keyword commands.

Type an app name or calculation directly. Use prefixes such as w for windows, : for emoji and kill for processes. Type ? for help and examples.

Find & launch

Get to the app, window or file you need.

Calculate & convert

Quick answers without reaching for another app.

Tools & shortcuts

Small utilities for the things you do every day.

Install

One command. Then Super + Period.

Everything Command Bar needs comes with Omarchy, so there is nothing else to install.

Terminal

omarchy plugin add https://github.com/Saikomantisu/omarchy-commandbar --enable

01

Add the plugin

Run the command in a terminal. It enables itself.

02

Press Super + Period

The bar opens over whatever you are doing.

03

Type, or press ?

The help screen lists every feature with an example.

Configure

Make it yours with one JSON file.

Change the hotkey, set your home currency, pin the time zones you check and add keyword commands of your own. Changes apply when you save.

Read the README

~/.config/omarchy/extensions/commandbar.json

{
  "hotkey": "SUPER + PERIOD",
  "currency": { "home": "EUR", "favorites": ["USD", "GBP"] },
  "commands": [
    {
      "keyword": "aw",
      "title": "Arch Wiki",
      "open": "https://wiki.archlinux.org/index.php?search={q}"
    }
  ]
}

FAQ

Questions, answered.

Does it replace the Omarchy menu?

No. It leaves the menu on Super + Space alone and sits beside it on Super + Period. It is an alternative to the separate emoji picker, calculator and agent picker, each of which has its own key.

Does anything leave my machine?

Currency conversions fetch exchange rates when needed, using a daily cache. Web searches open in your browser. AI prompts go to the agent or chat website you select. File search reads names, not file contents; the bar stores its cache locally.

What does the ai command do?

It opens your default Omarchy agent in a terminal with your prompt. The agent uses auto-approve and can run commands without asking. If no default is set, it opens the agent picker. Separate results can open the prompt in configured chat websites such as ChatGPT and Claude.

Can I change the hotkey?

Yes. Set hotkey in your commandbar.json and save. The default is Super + Period.

Can I add my own commands?

Yes. Add entries to the commands list in your config, each with a keyword, a title and either a web address to open or a command to run.

How do I remove it?

Terminal

omarchy plugin remove io.github.saikomantisu.commandbar
rm -rf ~/.cache/omarchy-commandbar ~/.config/omarchy/extensions/commandbar.json

Open source

Source code on GitHub.

Released under the MIT license, with source code and provider tests on GitHub. Report a bug or discuss a feature before contributing.

Report a bug

Open an issue with what you typed, what you expected and what happened.

Open an issue

Add a feature

Each feature is a small JavaScript provider. Open an issue first, then keep the pull request focused.

Read the guide

Star the repo

Browse the source, follow releases or star the project on GitHub.

Star on GitHub