Mitishell

Mitishell (MY-ti-shell) is a personal Hyprland desktop shell built with QuickShell. It uses the Cinder Grove visual language and targets Arch Linux.

It provides a configurable bar, launcher, quick settings, notifications, power controls, clipboard history, reminders, weather, and focused overlays for common desktop tasks. Optional integrations stay out of the way when their supporting tools are unavailable.

User installation, configuration, feature guides, and optional dependency details live in the Mitishell wiki.

Build requirements

• Hyprland
• hyprshutdown
• QuickShell 0.3.0
• Go 1.26 or newer
• Qt 6 QML tooling
• Node.js
• GNU Make
• A Nerd Font for shell and OSD glyphs

Build from source

git clone https://github.com/aileks/mitishell.git
cd mitishell
make build
make run

make run builds the Go CLI and starts the shell directly from the checkout. It sets the paths needed for the development binary and QuickShell source tree.

To install the current checkout for your user:

make install
quickshell -n -p ~/.local/share/mitishell/shell

Nix

The flake provides an installable package and a development shell for x86_64-linux and aarch64-linux.

nix develop
make check
make run

Build or run the packaged shell directly:

nix build .#mitishell
./result/bin/mitishell-shell

# Or build and run in one step.
nix run .

The package can also be used from a NixOS or Home Manager flake:

inputs.mitishell.url = "github:aileks/mitishell";

# Use this in environment.systemPackages or home.packages.
inputs.mitishell.packages.${pkgs.stdenv.hostPlatform.system}.default

The package supplies QuickShell, hyprshutdown, and the default Nerd Font. Hyprland and optional integrations remain part of the host system.

Development

Set MITISHELL_QS_PATH to the repository's shell directory when using CLI commands that talk to a development instance outside make run.

make test   # Go, race, JavaScript, and QML tests
make check  # tests, formatting, vet, QML linting, and whitespace checks

License

Mitishell is licensed under the GPLv3 or later. See LICENSE.

The prebuilt binary includes third-party software. See THIRD_PARTY_LICENSES.md.