canido.dev
Projects/iluxav / omaestro

omaestro

Lua automation rules for Hyprland, like Hammerspoon

Get it on GitHub
af99d85 / 2026-10-0411 things you can doFollow (Atom feed)Maintained by @iluxav

Write small Lua rules that make your Hyprland desktop act for you: hotkeys, window placement, timers, system events, and rewriting selected text with a local model.

What you can do with it

Rewrite, summarize or translate the text you selected with a local model and paste the result in place.

Good to know

Needs Ollama with a model pulled (llama3.2 by default) or another OpenAI-compatible endpoint set in omaestro.toml; text goes only to that endpoint.

Since v0.1.6

Bind hotkeys, per-app hotkeys, modal key layers and chord menus from Lua without touching your Hyprland config.

Good to know

A chord already bound by Hyprland or Omarchy is refused unless you free it or turn om override on.

Since v0.1.6

React when a window opens, gets focus or changes title, and float, center, move or arrange windows from a rule.

Since v0.1.6

Snap the focused window to a half, a third, the center or the full screen with a key chord.

Since v0.1.6

Run actions every interval, once after a delay, or every day at a set time, such as a stretch reminder.

Since v0.1.6

Run actions on sleep and wake, USB devices, battery level, network changes, monitors and new files in a directory.

Good to know

Battery is polled every 30 seconds; sleep and wake come from logind.

Since v0.1.6

Type a short trigger like :sig anywhere and have it replaced by your text.

Good to know

Your user must be in the input group; typing goes through a US keymap.

Since v0.1.6

Keep the last ten clipboard entries and pick one to paste with a hotkey.

Since v0.1.6
Show all 11

Install, configure, update and share rule plugins straight from git repositories.

Good to know

Plugins run as you with everything om can do; there is no registry or review.

Since v0.1.6

See every rule in a panel in the Omarchy bar and switch each one on or off.

Good to know

The panel and bar icon need the Omarchy plugin install.

Since v0.1.6

Bring back a window you just closed, with its content and scroll position, within three seconds.

Good to know

SUPER+W is Omarchy's close-window chord: unbind it in bindings.lua or turn om override on, otherwise the rule is refused.

Since af99d85
Release history 2
af99d852026-10-04

Undo closing a window within three seconds and get it back with its unsaved content.

Details

New tile-close-undo plugin: SUPER+W hides the focused window and closes it 3 seconds later; SUPER+Z in between restores it as it was.

On main; install with om plugin add https://github.com/iluxav/omaestro/tree/main/plugins/tile-close-undo. No new om release needed.

Added: Bring back a window you just closed, with its conte…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.1.62026-10-02
First release

Select text anywhere, press a hotkey, and get it back rewritten in place by a local model.

Details

First releases (v0.1.1 to v0.1.6, 2026-09-30 to 2026-10-02): the om daemon and command, Lua rules in ~/.config/omaestro/init.lua and rules.d/, an Omarchy shell panel, and installable plugins from the repository's plugins/ directory.

Also: Settings in ~/.config/omaestro/omaestro.toml; om doctor checks the tools it uses; om skill install adds a skill for AI coding agents.

omarchy plugin add https://github.com/iluxav/omaestro --enable downloads the prebuilt om for x86_64 or aarch64 and checks its SHA256; or make install from a checkout. Needs Hyprland 0.56 or newer.

Added: Rewrite, summarize or translate the text you select…Added: Bind hotkeys, per-app hotkeys, modal key layers and…Added: React when a window opens, gets focus or changes ti…Added: Snap the focused window to a half, a third, the cen…Added: Run actions every interval, once after a delay, or…Added: Run actions on sleep and wake, USB devices, battery…Added: Type a short trigger like :sig anywhere and have it…Added: Keep the last ten clipboard entries and pick one to…Added: Install, configure, update and share rule plugins s…Added: See every rule in a panel in the Omarchy bar and sw…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
Written by the project's maintainer, @iluxav, and checked against the repository.