oma-cast

A Raycast-esque launcher for Omarchy. It learns what you use, searches your apps and every Omarchy action, and looks like it shipped with your theme.

---

Why

Omarchy's built-in menu is great at what it does. oma-cast adds what Raycast users miss on Linux:

• Learns your habits. Results are ranked with a port of Raycast's root-search algorithm, plus frecency and learned search terms. The things you actually use float to the top, and if you type ff and pick Firefox, ff keeps meaning Firefox.
• One search for everything. Your apps, all ~400 Omarchy menu actions (with breadcrumbs and live ✓ state), web-search fallbacks, and an explicit hand-off to your default coding agent.
• Your shortcuts. Give anything an alias, pin favorites, and hide the commands you never touch.
• Keyboard-first. A Ctrl+K action panel, Ctrl+1–9 quick picks, search history on ↑, section jumping, and emacs-style navigation.
• Native to Omarchy. It runs inside omarchy-shell as a plugin, with no Electron, no Node and no extra daemons. It opens in about 40 ms and follows your theme live when you run omarchy theme set.

Screenshots

Every Omarchy action, with breadcrumbs	Ctrl+K: actions for any result

No match? Send the query to Google or DuckDuckGo

Follows your Omarchy theme

There's no theme config. oma-cast binds to Omarchy's own colours, so it changes the moment you switch themes.

Install

Requires Omarchy 4 (Hyprland 0.56+, omarchy-shell) and socat, which Omarchy already ships.

git clone https://github.com/typecraft-dev/oma-cast.git
cd oma-cast
bin/oma-cast install          # link the plugin into omarchy-shell and the CLI into ~/.local/bin
oma-cast setup hyprland       # bind Alt+Space
oma-cast doctor               # check everything is wired up

Press Alt+Space. Super+Space stays the Omarchy menu. You can change the launcher binding in ~/.config/hypr/oma-cast.lua.

To remove it: oma-cast uninstall.

Ask your default agent

Type a question, select Ask default agent under the web-search fallbacks, and press Enter. Ctrl+Alt+Enter sends the current root-search text directly. This opens a new session with your question in Omarchy's configured default agent and terminal (Foot, Ghostty, Kitty or Alacritty).

The action checks your setup first. Missing agent/terminal setup leaves the launcher open with your question and an error. Closing the launcher during the check cancels the pending hand-off. Normal app search and Enter selection keep working as before; typing alone never submits a question.

Requires an Omarchy version with omarchy-agent-prompt and omarchy-agent --prompt (verified against quattro revision 3ac4365). Select your defaults in Omarchy Settings. Agent authentication, accounts, approval behaviour, session working directory and terminal selection remain owned by Omarchy and the agent CLI. oma-cast does not store the question in search history, read credentials, or make model API calls. Successful preflight checks establish launch prerequisites, not successful sign-in or a running terminal; those still need live desktop validation.

Keyboard

Key	Does
↵ / Ctrl+↵ / Ctrl+Shift+↵	Run the first, second or third action
Ctrl+K	Open the action panel
Super+V / Ctrl+V / Ctrl+Shift+V / Shift+Insert	Paste text into the query (also accepts clipboard-history selections)
Ctrl+Alt+↵	Ask the default agent using the current root-search text
Ctrl+1…9	Pick a result
↑ on an empty search	Search history
Ctrl+↑ / Ctrl+↓	Jump between sections
Ctrl+N / Ctrl+P	Next / previous
Ctrl+Shift+F	Add to favorites (Ctrl+Alt+↑↓ to reorder)
Ctrl+Shift+C	Copy
Alt+Shift+D	Disable a command
Esc / Shift+Esc	Back / back to root
Ctrl + / Ctrl − / Ctrl 0	Zoom

CLI

oma-cast toggle | show | hide
oma-cast run <commandId>         # e.g. app:com.mitchellh.ghostty, omarchy:style.theme
oma-cast call <method> [json]    # call any backend method
oma-cast doctor

Roadmap

oma-cast is early. Search, ranking and the Omarchy integration are done. Coming next:

• Settings window
• Script Commands
• Clipboard history, snippets, quicklinks, calculator
• Running Raycast extensions built from the open-source raycast/extensions repo
• Window management
• Importing your .rayconfig from macOS

The full plan is in SPEC.md.

Development

node --test tests/*.test.js # unit tests, no npm install needed
tests/smoke.sh            # live checks against the running shell
oma-cast dev          # reload on every save

Quickshell caches QML for the life of the process, so run oma-cast reload after editing anything under plugin/. See CLAUDE.md for the layout and conventions.

Notes

oma-cast is an independent, clean-room project. It isn't affiliated with or endorsed by Raycast, and it contains no Raycast code or assets. It never contacts Raycast's servers and has no telemetry. Its agent action explicitly hands your question to Omarchy's existing coding-agent launcher; it provides no embedded AI runtime.