Desktop Shell

Dependencies

# CLI for astal
ags

# Clipboard
wl-clipboard
cliphist
imagemagick

# OSD
brightnessctl

# Color generation (optional)
matugen

Prerequisites

Install npm packages (use preferred package manager):

bun install

Generate types:

ags types

Start Desktop Shell

ags run

[!NOTE] Contains code specific to niri (workspaces, window title)

Experimental config for Tailwind CSS v4 in tw4 branch