noctalia-plugins

These are plugins I built for my own Noctalia v5 setup, written with the help of AI tooling. There are two: a streaming Claude chat panel, and a niri workspace/taskbar widget. I use both daily and share them here in case they help you too.

Table of Contents

• Plugins
  • claude-launcher
  • niri-taskbar
• Host Requirements
• Install
• Development
• Credits
• License & Disclaimer

Plugins

claude-launcher

A streaming chat panel for Claude, backed by your own claude CLI login. It needs no API key; usage bills against your Pro/Max subscription.

Full README

niri-taskbar

A bar widget that combines niri workspaces and a taskbar. Stretchable idle chips expand on hover into a pill of real app-icon window tiles.

Full README

Host Requirements

Neither plugin needs a patched Noctalia anymore. Every host capability they use has merged upstream:

• claude-launcher: chat-style input submit, follow-scroll, and the ui.markdown node merged on 2026-07-30 as plugin API 21 (#3327).
• niri-taskbar: container onClick/onHover merged on 2026-07-21 (#3470).

claude-launcher declares plugin_api = 21 and refuses to load on older builds. niri-taskbar loads on older builds but degrades; its README documents how.

Install

As a plugin source. Noctalia clones and manages the repo itself; you need no local checkout.

noctalia msg plugins source add gegnep-plugins git https://github.com/gegnep/noctalia-plugins
noctalia msg plugins enable gegnep/claude-launcher
noctalia msg plugins enable gegnep/niri-taskbar

Symlink a single plugin into Noctalia's local plugin directory. Use this for local development, or if you'd rather manage the checkout yourself.

git clone https://github.com/gegnep/noctalia-plugins
cd noctalia-plugins
ln -sfn "$PWD/claude-launcher" ~/.local/share/noctalia/plugins/claude-launcher
ln -sfn "$PWD/niri-taskbar" ~/.local/share/noctalia/plugins/niri-taskbar

Development

nix develop   # or let direnv load it automatically

The devshell provides luau, jq, fd, and ripgrep: everything each plugin's fixture harness needs. No running Noctalia instance is required.

noctalia plugins lint   # lint all plugin manifests and Luau sources

Each plugin has its own offline fixture harness; see the plugin's README for what it covers. Run both from the repository root:

./claude-launcher/fixtures/dry-run.sh
./niri-taskbar/fixtures/dry-run.sh

catalog.toml is required for consuming this repo as a git plugin source. python3 tools/update-catalog.py generates it from */plugin.toml (CI also runs this on push to main). Don't edit it by hand.

Credits

Built on Noctalia by the noctalia-dev team.

License & Disclaimer

MIT.