niri

Automates window and workspace control for the Niri Wayland compositor via IPC.

6|Updated Jun 12, 2021
One-click install
npx skills add https://github.com/rwaltr/dotfiles --skill niri-rwaltr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: niri
Source: https://github.com/rwaltr/dotfiles/tree/main/home/dot_config/private_pi/agent/skills/niri
Command: npx skills add https://github.com/rwaltr/dotfiles --skill niri-rwaltr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

IPC-based management of the Niri Wayland compositor enables precise window and workspace control from containerized environments, removing manual steps and enabling reproducible layouts.

Core Features & Use Cases

  • Window management (focus, move, resize, float/tile)
  • Workspace operations (create, name, navigate, organize)
  • Output configuration (resolution, scale, position, VRR)
  • Real-time state queries and IPC automation
  • Container-safe orchestration using distrobox-host-exec wrapper

Quick Start

Ask me to focus a window and move it to workspace 2 using Niri IPC.

Frequently Asked Questions about niri

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate window management in Niri Wayland from a container?

You can automate Niri window management from a container by utilizing IPC commands through the distrobox-host-exec wrapper. This enables precise control over window focus, tiling, and workspace organization directly from containerized environments.

What do I need to query and adjust Niri compositor state via IPC?

Querying and adjusting Niri compositor state via IPC requires Niri 25.11+ with full IPC support enabled. If executing from a container, the distrobox-host-exec wrapper is also required to bridge the environment.

Can I use IPC to move windows between workspaces in Niri?

Yes, IPC allows you to move windows between workspaces in Niri. The interface supports focusing, resizing, and toggling float or tile states for windows, as well as creating, naming, and navigating workspaces programmatically.

Does Niri IPC support output configuration like resolution and VRR?

Yes, Niri IPC supports output configuration including resolution, scale, position, and VRR. This enables automated display adjustments alongside real-time state queries and workspace orchestration within the Wayland environment.

Why do I need the distrobox-host-exec wrapper for Wayland workspace automation?

The distrobox-host-exec wrapper is needed for Wayland workspace automation to execute IPC commands on the host system from within a container. It bridges the containerized environment to the host's Niri compositor for accurate control.