To Install
Just tell your agent:
The README has everything an agent needs: the pacman repository, the package, the Hyprland bind. Launch it, flip one switch in Settings, and Ctrl+Alt+Return is yours.
By hand
Envy ships from its own pacman repository, hosted on GitHub. Add it to /etc/pacman.conf once:
[envynote] SigLevel = Optional TrustAll Server = https://github.com/skuthus/Envy-Linux/releases/download/repo
Then install it:
From then on omarchy update brings each new version along with everything else. Prefer a file? The AppImage and tarball are on GitHub. Prefer to build it? git clone https://github.com/skuthus/Envy-Linux && cd Envy-Linux/linux && makepkg -si.
Envy on the Omarchy desktop
Ctrl+Alt+Return summons Envy by default. Type, Return, and the note is open. Envy will follow your Omarchy theme automatically.
Envy in every Omarchy theme
Envy in Tokyo Night. Pick another theme below and the page follows. So does the app: these are real captures, one per theme, nothing retouched.
Follows your theme (even your custom themes!)
$ omarchy theme set tokyo-night
Envy reads the live theme from ~/.local/state/omarchy/current/theme/colors.toml. Run omarchy theme set and a running window retints in place. omarchy font set is honoured the same way. Prefer a fixed look? Settings → Appearance pins Envious light or dark and any font you name.
What's native
- Summon
- Ctrl+Alt+Return is a Hyprland bind. Envy lives on the
special:envyscratchpad, floating and centred, and slides in over whatever you're doing. Press it again and it's gone. Not running yet? The same chord launches it. - An eye in the bar
- The Mac's menu bar eye is an Omarchy bar widget here, installed on first launch. Open while the window is on screen, closed while hidden. Click it to summon, right-click for the menu. Move it with
omarchy bar move. - Hyprland Blur
- Surfaces are translucent, so Hyprland's blur does the rest. Envy overrides the default window opacity so text stays as sharp as an opaque terminal.
- One box
- Type to filter as you type. Return opens the top match, or creates a note from what you just typed. Operators narrow it:
tag:,inbox:,@friday. See the manual for more commands. - Flat files
- Every note is plain Markdown, UTF-8, in
~/Documents/Envyor any folder you point it at. Readable by anything, forever. Sync it with whatever you already trust. - Wiki-links and embeds
[[Note]]links.![[Note]]pulls another note's live content inline. Rename a note and every link to it is rewritten across the vault.- Tasks and dates
[ ]anywhere on a line is a checkbox.@2026-09-05or@mondayis a due date. Both live in the text itself, so both survive without Envy.- Same core as the Mac
- The note model is the Rust
envy-coreshared with Envy for Windows, ported line for line from the macOS original. One vault, three platforms. - Agent-ready
- The package installs an
envyskill for your coding agent: every setting, every shortcut, every colour token, andenvynote config checkto validate an edit. Ask your agent to make Envy match a theme and it knows how. Use it for an Agent PKMS, editing .md skills, or personal work and writing. - Nothing phones home
- No account. No sync service. No telemetry. No network calls at all. Airgap-friendly by construction, not by promise.
Setup one switch
Wayland has no app-registered global hotkeys, so the summon is a Hyprland bind, and the package ships it. Launch Envy, open Settings → System, and turn on Bind Ctrl+Alt+Return in Hyprland. That adds one guarded line to ~/.config/hypr/bindings.lua and reloads Hyprland. Turn it off and the line goes away. A line you wrote yourself is never touched.
Prefer to do it by hand? It is the same line:
-- ~/.config/hypr/bindings.lua pcall(dofile, "/usr/share/envy/hyprland-envy.lua")
That file floats the main window as a centred panel, drops Omarchy's default window opacity so text stays sharp, and binds Ctrl+Alt+Return to envynote --toggle. Ctrl+Alt+C centres the window after you have dragged it about. Every setting, including these, lives in ~/.config/envy/config.md; the Settings panel writes the same file.
Specifications, complete
- Version
- 1.0.0
- Requires
- Omarchy 3+, or Arch with Hyprland
- Runtime
- webkit2gtk-4.1, gtk3
- Packages
- pacman repo, AppImage, tarball
- License
- MIT, source on GitHub
- File format
- Markdown, UTF-8
- Storage
- One folder, chosen by you