Lift is a standalone command palette for Halley. It talks to the compositor over Halley's
existing IPC APIs, so a single launcher can search apps, running nodes, clusters, actions,
and config — and even assemble clusters — without leaving the field.
Install
Get Lift
Lift ships as its own halley-lift package for users who only want the palette.
It is also included in the halley-full bundle.
lift package
yay -S halley-lift
paru -S halley-lift
Run it with no arguments, or seed an initial query to open straight into a mode.
run
halley-lift
seeded query
halley-lift cluster release
Search modes
One field, every provider
Lift searches everything by default. Prefixing a query with a provider name filters the
results without turning the text into a badge, so the full query stays visible and editable.
appInstalled applications from .desktop entries.
clusterClusters, plus staging apps and nodes into a draft.
nodeRunning windows and nodes across the field.
actionCompositor actions exposed over IPC.
configJump into config values by name.
termRun a command in your terminal through $SHELL.
term runs the typed command line in your configured terminal through your
interactive $SHELL, so aliases, pipes, and && all work; the shell
stays open afterward.
Cluster drafts
Build clusters as you search
In cluster searches, Space stages or unstages the selected app or
running node — side-effect-free. Once something is staged, Ctrl+Enter hands the
draft to Halley's existing Cluster Finalize popup with a name hint and the selected node IDs.
Staged apps launch only during that handoff, and the compositor auto-selects matching
newly-appearing nodes while the finalize prompt is active. Lift never persists clusters
itself — the finalize popup owns naming, confirmation, and creation.
Pins & icons
It follows Halley's state
Lift keeps no favorites database of its own. Field/Bearings-pinned nodes come straight from
Halley and rank above ordinary matches. App icons are read from .desktop entries
and resolved lazily from XDG icon paths — PNG, JPEG, and SVG — with glyph fallbacks.
Config
Configure Lift
Lift reads a Rune config from the path below. On first launch it writes a documented default
template there if none exists; existing files are never overwritten.
config path
~/.config/halley/lift.rune
The config covers placeholder text, width, result counts, icons, terminal, positioning,
rounding, colors, borders, cursor, and the enabled modes/providers.