omarchy-url-handler

Registers an omarchy:// URL scheme so a web page can offer an Install in Omarchy link for shell plugins.

omarchy://plugin/add?url=<https-git-url>[&enable=1]

Clicking such a link opens Omarchy's floating terminal running omarchy plugin add <url> [--enable]. You still see the plugin trust warning and confirm before anything is cloned — the link only pre-fills the command, it never installs silently.

Install

As an Arch package (system-wide, recommended on Omarchy):

makepkg -si

This installs /usr/bin/omarchy-url-handler and the desktop entry; the desktop-file-utils pacman hook registers it as the omarchy:// handler.

Or for the current user only, without a package:

./install.sh

This copies omarchy-url-handler to ~/.local/bin, a desktop entry to ~/.local/share/applications, and registers it with xdg-mime default … x-scheme-handler/omarchy. Remove with ./uninstall.sh.

Use from a web page

<a href="omarchy://plugin/add?url=https%3A%2F%2Fgithub.com%2Facme%2Fomarchy-weather.git&enable=1">
  Install in Omarchy
</a>

See example/index.html for a page that builds the link with URLSearchParams. Browsers ask once whether to open omarchy:// links with "Omarchy URL Handler".

Safety

Links come from untrusted pages, so the handler:

• accepts only https:// repository URLs (no ssh:, file:, ext::, local paths, or --prefixed arguments);
• never passes --yes; omarchy plugin add still asks for confirmation in the terminal;
• rejects unknown actions and reports the reason as a desktop notification.

Test what a link would run without opening anything:

omarchy-url-handler 'omarchy://plugin/add?url=https%3A%2F%2Fgithub.com%2Facme%2Fomarchy-weather.git' --dry-run