Omahub
← All plugins
Z

Stage

by zzwong

Mission Control-style workspace overview: zoomed-out live window previews, click to jump.

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
6c8d3a3
Scanned
5 days ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
6c8d3a3
Reviewed
5 days ago

The plugin is a well-structured QML overlay that only reads user settings and dispatches validated Hyprland commands. Input validation and defensive coding prevent injection, and no obfuscation, persistence, or destructive actions were found.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/zzwong/omarchy-stage --enable
Desktop #Hyprland #quickshell #workspaces

Stage

version lint license: MIT marketplace

Mission Control for Omarchy. Open a live overview of the workspaces on your focused monitor, switch between them, and manage their windows.

Stage carousel

Stage grid

Install

omarchy plugin add https://github.com/zzwong/omarchy-stage --enable

Add a keybind to ~/.config/hypr/bindings.lua. This example uses Super+` because Omarchy already uses Super+Tab:

o.bind("SUPER + GRAVE", "Stage", "omarchy-shell shell toggle zzwong.stage")

For touchpad gestures and optional Super+Tab cycling, see Settings and keybindings.

Use

Input Action
← → or Tab Shift-Tab Select a workspace; in pane mode, select a window
↑ / ↓ Move between grid, carousel, and window panes
Enter Open the selected workspace or focus the selected window
1–9 Jump to a workspace
Click a slice or window thumbnail Select or open it
Drag a thumbnail in grid view Move the window to another workspace or the + slot
X in pane mode, or × on a thumbnail or title pill Request a window close
Shift + arrow in pane mode Swap with a neighbouring tiled window
Ctrl-Shift + ← / → in pane mode Move the window to the previous or next workspace shown
+ slot Create the next workspace
Esc or click outside Close Stage

Two-finger horizontal swipes browse the carousel or, when zoomed in, its windows. Window title pills below the carousel show media controls when available. Stage stays open while you close or move windows.

See Window management for drag, close, and keyboard movement behavior and limitations.

Settings

Settings are optional. Copy the example to override the defaults:

cp ~/.config/omarchy/plugins/zzwong.stage/settings.example.json \
   ~/.config/omarchy/plugins/zzwong.stage/settings.json

settings.json is re-read each time Stage opens. It supports style (picker or cards), view (auto, carousel, or grid), badgeStyle, and keybindMode (toggle or cycle). See Settings and keybindings for values and examples.

Stage shows regular workspaces on the focused monitor and uses the current Omarchy theme. Window actions require Omarchy's default Hyprland Lua config.

Uninstall

omarchy plugin remove zzwong.stage

Remove any keybinds or gestures you added.

License

MIT