lowkey / lowkey
lowkeyctl
Control a saved site from Terminal
Install the command
Install lowkey 0.1.1 or later in /Applications, then run the commands below. The script only links the bundled helper. It does not need sudo or change your shell configuration.
curl -fsSLo install-lowkey-cli.sh https://bobuk.io/apps/lowkey/install-cli.sh && sh install-lowkey-cli.sh
command -v lowkeyctl
lowkeyctl --helpThe script uses ~/.local/bin, ~/bin or ~/.bin if already on PATH. Otherwise it creates the link in ~/.local/bin and prints the PATH setting. Updating the app in place preserves the link. To uninstall the command, remove only the link printed by the script.
Command reference
Use lowkeyctl ALIAS COMMAND. Replace HA with your saved alias. Quote labels containing spaces.
| Command | Result |
|---|---|
| open | Show or create the site window. |
| hide | Hide without closing. |
| toggle | Hide the frontmost window; otherwise show it. |
| rewind | Show the window and load the configured start URL. |
| status [--json] | Read the window state without raising it. |
| inspect [--json] | List control types and labels, not entered values. |
| wait [LABEL] [--timeout SECONDS] | Wait for DOM readiness or one visible enabled control. Default: 10 seconds; range: 1–300. |
| click LABEL | Click one button or link. |
| fill FIELD VALUE | Set text in a labelled field; password fields are excluded. |
| select FIELD VALUE | Select one option by its display text. |
| upload FILE [--field LABEL] | Attach one file (up to 8 MiB). Specify the field if there is more than one file input. |
Working with a page
Open the site before using page commands. Labels match exactly after whitespace normalization, in the main document and open shadow roots on the saved origin. Missing or ambiguous matches fail. A click returning success means it was dispatched. Upload does not submit the form, but the site may send the file immediately.
Available starting with lowkey 0.1.2: View → Save as PDF… (⌘⇧S), or lowkeyctl HA save-pdf ~/Desktop/page.pdf. Prints the whole current document to A4 PDF using print styles, not just the viewport. Does not load lazy content or expand virtualized lists. The command requires an open page on the saved origin and never overwrites an existing file; the menu opens a save dialog. Save as PDF… is also in the page context menu.
lowkeyctl HA open
lowkeyctl HA inspect --json
lowkeyctl HA wait "Refresh list" --timeout 20 && lowkeyctl HA click "Refresh list"