First we take Manhattan, then we take Berlin.
Alt+Space for Omarchy: one launcher that searches your machine and either hands off to native Omarchy tools or owns the gaps they don’t cover.
Not a Raycast UI clone. An Omarchy umbrella: same muscle memory as a modern launcher, styled like Omarchy’s menu/clipboard surfaces, wired into Hyprland and the Omarchy CLI.
Site: omnicast.best · News: omnicast.best/news · Code: github.com/KOUSTAV2409/omnicast · X: @koustavdotco
Not affiliated with omarchy.org. Independent community project that intends to earn a place in that ecosystem.
Paste this to Cursor / Claude / ChatGPT on an Omarchy machine:
Set up Omnicast on this Omarchy box:
1. omarchy plugin add https://github.com/KOUSTAV2409/omnicast.git --enable
2. ~/.config/omarchy/plugins/koustav.omnicast/bin/omnicast-omarchy-setup
3. Confirm Alt+Space toggles Omnicast; Super+Space stays the Omarchy menu
Needs: Omarchy (Hyprland + Quickshell). Omnicast is an Omarchy shell plugin, not an AUR app.
omarchy plugin add https://github.com/KOUSTAV2409/omnicast.git --enable
~/.config/omarchy/plugins/koustav.omnicast/bin/omnicast-omarchy-setupWhat that does:
- Installs the plugin under
~/.config/omarchy/plugins/koustav.omnicast/ - Enables the bar widget (search icon). The widget always calls the plugin-local
bin/omnicast(no PATH dependency) omnicast-omarchy-setupsymlinks CLI to~/.local/bin/omnicastand binds Alt+Space (leaves Super+Space for the Omarchy menu)
Update later: omarchy plugin update koustav.omnicast then re-run setup if the bind path changed.
Listing: Omarchy Plugins · koustav.omnicast
Omarchy’s package repo is OPR (pkgs.omarchy.org via omacom/omarchy-pkgs), not the AUR. Scaffold: packaging/opr/. Submit after the plugin path is airtight.
git clone --depth=1 https://github.com/KOUSTAV2409/omnicast.git ~/.local/share/omnicast
bash ~/.local/share/omnicast/install.shOr from a working tree: ./bin/omnicast and ./bin/omnicast-omarchy-setup.
Script commands: drop executables in ~/.config/omnicast/commands/. See docs/script-commands.md.
Snippets are managed inside the launcher (no global keystroke expander).
Stuck? Open an issue. Feedback from Raycast → Omarchy users is especially welcome.
| Hotkey | Alt+Space → bin/omnicast |
| Super+Space | Left for the native Omarchy menu |
| Search | Fuzzy match + frecency, favorites, aliases |
| Chrome | Search → list → footer · Enter primary · Ctrl+K actions · Esc dismiss |
| Look | Omarchy [menu] / [launcher] tokens, Hyprland rounding |
Omnicast dismisses and opens the native surface:
- Clipboard history
- Emoji picker
- Theme & background
- Images / screenshots browser
- Find Files (portal picker → open)
- Keybindings viewer
- System menu, capture, share, reminders
- Apps & commands:
.desktopapps + Omarchy CLI catalog- Try:
foot,screenshot,nightlight(→ Omarchy: Toggle Nightlight)
- Try:
- File search: type a name → Files section (
fd+ content viarg) under a scope (home/projects/ …)- Try: a folder/file name · Enter opens · Ctrl+K → Full Preview to peek
content:phrasefinds inside files (slower) ·in:projects fooscopes · Ctrl+Shift+P cycles scope- Ctrl+K: Full Preview · Copy Path · Reveal
- Calculator: math,
#hexcolors, units, rough FX (verify on Google), dates- Try:
12*7+3·#ff8800·10 km to mi·10 usd to inr(shows ≈ guess + Google live rate) ·days until 2026-12-25
- Try:
- Quicklinks: bookmarks with
{argument}/{clipboard}placeholders- Try: open Quicklinks, or search a link title you saved
- Script commands: Raycast-style frontmatter (
@raycast.*/@omarchy.*), form args,silent/compact/fullOutput- Drop scripts in
~/.config/omnicast/commands/. Seedocs/script-commands.md
- Drop scripts in
- Snippets: manage and insert text snippets from the launcher (no global expander daemon)
- Try: open Snippets → Enter to insert into active window, or Ctrl+C to copy
- Windows: Hyprland float snaps (left/right/thirds/quarters) + Omarchy helpers (pop, gaps, transparency, layout)
- Try:
snap left, open Windows, oromnicast snap left/omnicast://snap?layout=left
- Try:
- Plugins: search the Omarchy plugin directory, open the listing, install with
omarchy plugin add- Try: open Plugins, or
omnicast plugins/omnicast://plugins
- Try: open Plugins, or
- Ask AI: streams from local Ollama, or an OpenAI-compatible endpoint if you set a key
- Try: open Ask AI, or type
how does …?· settings in~/.config/omnicast/ai.json(Ctrl+K → Settings)
- Try: open Ask AI, or type
- Fallbacks: no match → Search Web or Ask AI
- Try: type nonsense → Search Web / Ask AI rows appear
- OPR package: scaffold under
packaging/opr/(Omarchy pkg repo). AUR is not the Omarchy default path. - A custom Omarchy model is a separate mission outside this repo.
Full Raycast ↔ Omarchy map: docs/raycast-vs-omarchy.md · Omarchy integration: docs/omarchy-integration.md
| Layer | Choice |
|---|---|
| OS | Omarchy (Arch) |
| Compositor | Hyprland (Wayland) |
| UI | Quickshell (Qt6 / QML), wlr-layer-shell |
| Glue | Omarchy CLI + state, hyprctl Lua dispatch |
| Path | Role |
|---|---|
bin/omnicast |
Launch / IPC toggle |
src/ |
Shell, views, services, backends |
src/views/root/ |
Calc / Handoffs / WindowActions modules |
src/services/PathSafety.js |
Client-side sensitive-path checks (aligned with path_safety.py) |
tests/smoke_backends.sh |
Backend + packaging smoke |
packaging/opr/ |
OPR (omarchy-pkgs) recipe scaffold |
bin/omnicast-omarchy-setup |
Post-plugin PATH + Alt+Space bind |
docs/work-order.md |
Ordered next actions (Berlin) |
site/ |
Public landing + news |
docs/script-commands.md |
Script command API |
docs/raycast-vs-omarchy.md |
Feature crosswalk |
implementation-plan.md |
Manhattan → Berlin plan |
roadmap.md |
Status snapshot |
memory.md |
ADRs (incl. umbrella doctrine) |
context.md |
Agent / product context |
Manhattan (non-AI umbrella): taken. Daily loop works without a model. Ask AI streams from Ollama or an OpenAI-compatible endpoint. The Omarchy plugin directory is searchable from the launcher.
Berlin: Omarchy-first hardening, then OPR. Float snaps + deeplinks shipped. Omarchy-LLM stays out of band. Deeplinks: docs/deeplinks.md. Public site: omnicast.best.
Full leftover backlog: roadmap.md → What’s left to build.
Omnicast is a local Alt+Space launcher. Cloning it from GitHub does not give anyone remote access to your machine. It runs as your user, like a browser or editor.
Hardening includes: secrets/session paths blocked from search & preview, owner-only cache (0600), no shell launch of desktop Exec= lines, script commands only from allowlisted folders, and no executing .sh/binaries from Files search.