maria-rcks

maria-rcks / miri

Public

Niri-ish, keyboard-first window manager for macOS.

macos niri paper scroll wm
64
2
100% credibility
Found May 04, 2026 at 63 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Miri organizes Mac windows into dynamic workspaces and columns using keyboard shortcuts and optional trackpad gestures for a keyboard-first experience.

How It Works

1
🖥️ Discover Miri

You get tired of a cluttered Mac screen and find Miri, a simple way to keep windows neatly organized in rows and sections.

2
📥 Get and start Miri

Download the tool and launch it on your Mac with a quick start.

3
🔓 Allow window control

Your Mac asks for permission to let Miri move and arrange windows safely, just like screen-sharing apps.

4
⚙️ Set your preferences

Optionally adjust sizes, speeds, and rules for how different apps behave to match your style.

5
⌨️ Use keyboard shortcuts

Press Cmd+1 to Cmd+9 to switch sections, Cmd+H/L to move between columns, feeling instantly productive.

6
🖱️ Swipe with trackpad

Glide three fingers left/right or up/down to smoothly pan through your organized spaces with momentum.

🎉 Perfect organized desktop

Your windows stay tiled perfectly, everything restores on quit, and you work faster without the mess.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 63 to 64 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is miri?

Miri is a Niri-ish, keyboard-first window manager for macOS, written in Swift, that tiles app windows into dynamic workspaces and columns using public Accessibility APIs. It solves macOS's clunky default window management by letting you navigate and resize via Cmd+H/L/J/K shortcuts, three-finger trackpad swipes, and hot-reloadable JSON configs for rules, gaps, and animations. Users get a smooth, persistent layout that tracks Cmd+Tab switches and app launches without replacing native Spaces.

Why is it gaining traction?

Unlike yabai or Amethyst, miri centers focused columns at 0.8 screen width for peeking, adds momentum-based trackpad navigation via private multitouch hooks, and restores layouts on crash or exit. Developers dig the per-app rules for floating/ignoring windows like Finder, hover-to-focus, and width presets cycled with Cmd+Ctrl+L—making it feel native yet powerful. Hot config reloads and persistence hook power users tired of manual setups.

Who should use this?

macOS developers juggling IDEs, terminals, and browsers who hate dragging windows; tiling WM fans missing Niri's column flow on Apple Silicon; or keyboard warriors scripting Vim-like navigation without full compositor swaps. Skip if you need multi-monitor mastery or avoid Accessibility permissions.

Verdict

Try miri if you're on macOS 13+ and crave keyboard-first tiling—its 44 stars and 1.0% credibility score signal early alpha status with solid README but no tests yet. Promising for daily driving once polished, but test in a VM first.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.