repowisesnowarch/inir

snowarch / inir

A Niri shell illogical-impulse based - with some modifications..

QML★ 1,766
Use in your agentAsk this codebase

github.com/snowarch/inirIndexed at dcba34eUp to date with upstream

What is inir?

iNiR is a complete desktop shell for Niri on Linux, providing the bar, dock, notifications, settings, wallpapers and other desktop interface elements. It consumes compositor and configuration inputs, then renders an integrated shell through Quickshell. iNiR is primarily written in QML, with shell, Python, JavaScript and Go code also present.

Written by a model from the README and the source

1,590 files and 2,407 symbols in 10 modules, led by Qml (1,236 files) and Shell (144).

Start reading

Code health

7.5out of 10Good

This codebase scores 7.5 out of 10 for code health, which we rate good. It also scores maintainability 9.4 and static performance 9.9 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 263 of 1,590 files are git hotspots, and they average 6.2 — which is where the fixes pay off most.

Full health report

Use snowarch/inir in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/snowarch/inir
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is inir put together?")
  • get_why("why is inir structured this way?")

Explore inir

Key features of inir

  • iNiR provides Material ii and Waffle panel families that can be switched with Super+Shift+W.
  • iNiR generates wallpaper-based colors with Material You and propagates them to supported desktop applications and tools.
  • iNiR supports configurable bars, sidebars, desktop widgets, notifications, quick toggles, media controls and system monitoring.
  • iNiR provides Niri-oriented workspace and dashboard interfaces.
  • iNiR supports video wallpapers, theme presets and configurable visual styles.

How snowarch/inir works

Applications interact with the iNiR shell, which provides bars, sidebars, docks, notifications and settings. Quickshell runs the QML interface, while Niri manages windows and rendering through Wayland. The modules directory holds the main QML components, including modules/background/Background.qml for wallpaper-layer content and modules/background/widgets/AbstractBackgroundWidget.qml for shared background widgets. modules/settings/Config.qml and modules/settings/BarConfig.qml define settings and bar configuration, while modules/common/Config.qml provides shared configuration. The scripts directory supplies installation, update and diagnostic behaviors, and the shell renders either the ii or waffle panel family.

The codebase has 1,590 files and 2,407 symbols in 10 modules, led by Qml, Shell and Python. Code health is 7.5 out of 10, rated good.

Getting started with inir

  1. Enter the repository directory.
    cd inir
  2. Run the interactive installer.
    ./setup install # interactive, asks before each step
  3. Start the shell after installation.
    inir run # launch the shell

Commands copied from the README

snowarch/inir FAQ

What is inir?

iNiR is a complete Linux desktop shell for Niri. It provides bars, docks, notifications, settings, wallpapers and other desktop interface elements through Quickshell.

How does inir work?

iNiR runs QML through Quickshell and connects the shell to Niri and Wayland. Its modules render panels, widgets, settings, wallpapers and desktop tools.

How do I install inir?

iNiR can be installed by cloning the repository, entering its directory and running ./setup install. The installer handles dependencies, system configuration and theming.

What language is inir written in?

iNiR is primarily written in QML. The repository also includes shell, Python, JavaScript and Go code.

How is the inir code organized?

iNiR organizes its main interface in modules, installation and maintenance logic in scripts, supporting processes in services, and configuration data in sdata.

When should I use inir?

Use iNiR when you want an integrated desktop shell for the Niri compositor. It is intended for Linux desktops with a compositor and supports configuration through its GUI or a JSON file.

What license does inir use?

iNiR uses the GPL-3.0 license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of snowarch/inir from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.