Command reference

Every command, from the program itself.

Command reference

Generated from the usage text in src/Main.bx (bootstrap/gen-docs.sh rewrites it). Every command accepts --json; commands that change the system print a plan and need --yes, and --dry-run shows the plan and exits 0. See the command contract for exit codes and details.

bxcachy ai

bxcachy ai list | default [ID] [--yes] | launch [ID] [--dry-run] | session ... | models ... | shell [toggle|status] [--backend=hyprland|yakuake] [--dry-run] [--json]

bxcachy ai

bxcachy ai models list | ps | pull NAME | rm NAME --yes | status | enable [--yes] [--json]

bxcachy ai

bxcachy ai session start [ID] [--name=N] [--dir=PATH] [--dry-run] | list | attach NAME | stop NAME --yes [--json]

bxcachy airplay

bxcachy airplay on|off|status [--json]

bxcachy apps

bxcachy apps | apps list [--json]

bxcachy assets

bxcachy assets list | install [--yes] [--dry-run] [--json]

bxcachy boxlang

bxcachy boxlang status | use VERSION | matchbox use VERSION | modules list|search TEXT|install SLUG...|installed|outdated|update | vscode | links | welcome [--json]

bxcachy catalog

bxcachy catalog list [--group=G] [--category=C] [--tier=default|optional] [--kind=K] [--source=S] [--json] | show ID | groups | check | version

bxcachy clipboard

bxcachy clipboard pick | clear [--yes] | status [--json]

bxcachy cloud

bxcachy cloud remotes | configure | mount NAME [--path=DIR] [--yes] | unmount NAME [--yes] | status [--json]

bxcachy config

bxcachy config list|diff NAME|apply NAME|restore NAME ID|history [NAME] [--yes] [--dry-run] [--force] [--json]

bxcachy config

bxcachy config restore NAME ID --yes

bxcachy containers

bxcachy containers doctor | socket enable [--yes] | docker-compat [--yes] [--json]

bxcachy default

bxcachy default show | browser ID | terminal ID | filemanager ID [--yes] [--dry-run] [--json]

bxcachy dictation

bxcachy dictation setup [superwhisper|voxtype] [--yes] [--dry-run] | status | key [ENGINE] [--json]

bxcachy dolphin

bxcachy dolphin doctor [--fix] [--json]

bxcachy editor

bxcachy editor lazyvim [--yes] [--json]

bxcachy gpu

bxcachy gpu doctor [--json]

bxcachy init

bxcachy init [--from=FILE] [--fresh | --rerun] | init --answers=FILE [--yes] [--dry-run] [--json] | init --print-answers [--from-system] [--json] | init --export=FILE [--force]

bxcachy input

bxcachy input doctor | gestures [--yes] [--dry-run] [--json]

bxcachy keys

bxcachy keys show | mac [on|off|status] [--yes] | set ID KEYS [--yes] [--force] | reset ID [--yes] | conflicts | render xremap|hyprland|plasma | check | apply [--yes] [--dry-run] [--force] [--json]

bxcachy layout

bxcachy layout [toggle|float|tile|status] [--dry-run] [--json]

bxcachy menu

bxcachy menu | menu items [--json]

bxcachy nightshift

bxcachy nightshift [on|off|toggle|status] [--location=LAT,LON] [--json]

bxcachy notify

bxcachy notify dnd on|off|toggle|status | snooze [30m|2h|90s|off] | clear [--history] [--json]

bxcachy plasma

bxcachy plasma panels apply [--agenda] [--without-weather] [--desktops=N] [--preset=NAME] | undo | status [--yes] [--dry-run] [--json]  |  plasma desktops N [--yes]

bxcachy qr

bxcachy qr TEXT [--out=FILE.png] [--json]

bxcachy quicklook

bxcachy quicklook [PATH] [--dry-run] [--json]

bxcachy record

bxcachy record [toggle|start|stop|status] [--region] [--dry-run] [--json]

bxcachy screenshot

bxcachy screenshot screen|region|window [--edit] | ocr | qr | menu [--dry-run] [--json]

bxcachy secrets

bxcachy secrets status | setup [--keyring=kwallet|gnome-keyring|none] [--yes] | list [--type=ai|other] | set NAME [--from-file=F] [--type=ai|other] [--provider=ID] | get NAME [--show] | unset NAME --yes | apply [--yes] | global on NAME --yes|off NAME|show | unlock | lock | export FILE [--plain] [--force] --yes | import FILE [--overwrite] --yes | env [NAMES...] | run [NAMES...] [--strict] -- COMMAND [ARGS...] [--json]

bxcachy session

bxcachy session show | set hyprland|plasma [--yes] [--dry-run] [--json]

bxcachy settings

bxcachy settings export FILE.tar.gz [--force] | import FILE.tar.gz [--yes] [--json]

bxcachy setup

bxcachy setup plasma [--keys | --undo-keys] | hyprland [--terminal=ghostty|kitty|alacritty|foot|konsole] [--layout=dwindle|master|scrolling|floating] [--workspaces=N] [--natural-scroll] [--layouts=us-intl,es] [--theme=dark|light|auto] [--wallpaper=box|grid|aurora|minimal] | terminal [--default=ghostty] [--also=a,b] | shell [--shell=zsh|fish|bash] | keyboard [--layouts=us-intl,es] | xremap [--build=hypr|kde] | undo plasma|hyprland|xremap | status [--yes] [--dry-run] [--json]

bxcachy skills

bxcachy skills list [--tag=T] | search TEXT | show OWNER/REPO/SLUG | install [bxcachy|boxlang|matchbox|OWNER/REPO/SLUG]... [--yes] | installed | update [--yes] | remove NAME [--yes] | status | link [--json]

bxcachy ssh

bxcachy ssh key [--email=ADDRESS] [--yes] [--dry-run] [--json]

bxcachy status

bxcachy status [--json]

bxcachy strata

bxcachy strata integrations [--dry-run] [--json]

bxcachy system

bxcachy system update [--yes] [--json]

bxcachy tiling

bxcachy tiling on|off|status | layout [dwindle|master|monocle|scrolling|stage] [--json]

bxcachy toolchain

bxcachy toolchain node [--yes] [--dry-run] [--json]   (Bun and Deno: bxcachy install bun deno)

bxcachy update

bxcachy update check [--notify] | apply [--yes] | channel [stable|beta] | notifications on|off|status [--json]

bxcachy vpn

bxcachy vpn nordvpn setup [--yes] [--json]

bxcachy web

bxcachy web add [NAME URL] [--browser=brave|chromium|google-chrome|edge|firefox] [--yes] | list | rm NAME [--yes] | install google|microsoft|apple|boxlang|all [--yes] [--dry-run] [--json]

bxcachy window

bxcachy window minimize|restore

bxcachy wizard

bxcachy wizard --demo [--out=FILE] | --pages=FILE [--out=FILE] [--answers=FILE]