plugin-quickshell
| Version | 2026.243.1500 |
| Repo | box/github.com/opencharly/plugin-quickshell:v2026.243.1500 |
| Plugin | yes — see the plugin reference |
OUT-OF-TREE charly plugin serving the quickshell live-deployment check verb — a
standalone Go module driving the IPC channel of a Quickshell desktop shell over
go-plugin gRPC via the charly plugin SDK. charly’s loader fetches this candy’s repo,
go-builds the provider binary on the HOST, and serves it OUT-OF-PROCESS, so the
quickshell: verb dispatches through the provider registry exactly like a built-in.
.
WHY IT IS A VERB AND NOT A command: STEP. Quickshell’s qs ipc reports IPC-level
failures — “Target not found.”, “Function not found.”, argument-count errors — on
STDOUT while exiting ZERO. A command: step asserting “the menu opened” therefore
passes against a shell with no menu plugin loaded, against a typo in the target
name, and against an IPC surface that changed underneath it: green, asserting
nothing. This verb reads those responses and fails on them, which is the entire
difference between the two.
.
DESKTOP-AGNOSTIC BY CONSTRUCTION. It speaks Quickshell’s IPC, not any one desktop’s
vocabulary: config: names the shell directory and target:/function: name
whatever that shell’s QML exposes. Omarchy is one caller; the failure strings the
verb keys on live in the quickshell binary itself.
Acceptance plan
Section titled “Acceptance plan”This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.
| Intent | Step |
|---|---|
check |
the quickshell verb dispatches through the provider registry and reaches a live shell |