Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AhmedSaadi0/NibrasShell/llms.txt

Use this file to discover all available pages before exploring further.

NibrasShell is a modern Hyprland desktop shell built with passion — combining the speed of Quickshell and the power of AI to deliver a beautiful, intelligent, and fully customizable Linux desktop experience. From autonomous system monitoring to dynamic Material 3 color generation, every component is designed to stay out of your way while keeping the information you need at your fingertips.

Installation

Install NibrasShell on Arch, Fedora, or Void Linux using the automated installer script.

Quickstart

Get your shell configured and running with AI, themes, and services in minutes.

UI Components

Explore the Top Bar, Smart Capsule, Left Menu, Desktop, and every UI component.

Theming

Choose from Dracula, Catppuccin, Nord, Gruvbox, and more — or generate colors from your wallpaper.

AI & Services

Learn how the AI daemon monitors your system and delivers intelligent, context-aware insights.

Configuration

Customize every aspect of NibrasShell through the visual Settings App or the config file.

​
What makes NibrasShell different

NibrasShell goes beyond a typical shell. It integrates AI deeply into the desktop experience — not as a chatbot overlay, but as a silent background intelligence that monitors your system, summarizes weather, comments on your music, and alerts you only when it matters.
1

Clone and install

Run the automated installer to set up all dependencies and copy config files.
git clone --depth 1 https://github.com/AhmedSaadi0/NibrasShell.git
cd NibrasShell/nibras_installer
python main.py
2

Configure your identity

Edit ~/.nibrasshell.json or open the built-in Settings App to set your name, location, and AI provider keys.
3

Choose your theme

Pick from six built-in themes or let Material You generate a color palette automatically from your wallpaper.
4

Explore your shell

Open the Cheatsheet overlay to discover all available shortcuts and features.
NibrasShell requires Hyprland and Quickshell. The installer handles dependencies for Arch, Fedora, and Void Linux automatically. For other distributions, follow the manual installation guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us