NIRI-WORKSPACES(1)

✨ NIRI-WORKSPACES — the glow-up your workspace setup deserved ✨

okay bestie, so this one lives in the niri-companion Manual, and honestly? it's giving personal assistant for your desktop 💅

---

🌸 NAME 🌸

niri-workspaces — the niri-companion workspace management tool. that's it, that's the girl 🫶

---

🦋 SYNOPSIS 🦋

niri-workspaces

yeah. no flags. no args. she just runs. iconic behaviour honestly ✨

---

💖 DESCRIPTION 💖

so niri-workspaces manages complex workspace layouts, which is a fancy way of saying it orchestrates the whole vibe for you 🔥

here's the tea: it pops up a list of workspaces through a dmenu-compatible picker (think rofi, bestie). then when you pick one? it triggers a whole sequence of commands that opens specific apps on specific workspaces. like a little choreography. main character energy ngl 👑

---

🎀 CONFIGURATION 🎀

everything lives in:

~/.config/niri-companion/settings.toml

[workspaces]

• dmenu_command — the picker command it uses. default is "rofi -dmenu", but you can swap in whatever dmenu-compatible cutie you want 💅
• task_delay — the default wait time, in seconds, between starting applications. this is the lil breather between each launch so nothing chokes 🌸

[workspaces.items]

this is where you define which workspaces show up in the picker. each item is a list of task objects. yes, a list — stack 'em up bestie 🍓

Task Object Fields

• workspace — the target workspace number. where is this task going? 🎯
• run — the shell command to execute. verbatim, exactly as you write it.
• task_delay — (optional) a specific delay just for this task. overrides the default, no cap 💜

---

🌈 EXAMPLES 🌈

Example Workspace Setup

[workspaces.items]
"dev" = [
  { workspace = 1, run = 'foot -e nvim' },
  { workspace = 2, run = 'brave --new-window github.com', task_delay = 1.5 }
]

Usage

running the tool:

niri-workspaces

and when you select "dev", here's the sequence it goes through, step by step:

1. open a terminal with nvim on workspace 1.
2. wait 0.8s (that's the default).
3. open Brave on workspace 2.
4. wait 1.5s (that's the specific override, bc that task said "no thank u, I need longer").

---

⭐ SEE ALSO ⭐

• niri-genconfig(1)
• niri-ipcext(1)

go read your siblings too, they're also slaying 💜

---

lowkey reminder: those task objects are lists, so the order you write them in is the order they fire. the delays are doing real work here, don't skip 'em 🙈

---

okay that's the whole page, mwah 💖 this was niri-workspaces 4.0.1, born May 2026, from the niri-companion girliesss — ily, go build ur dream layout, periodt 💅✨