CLI Dongle

The dongle sits between your keyboard and computer. On the keyboard, press the trigger Ctrl, Shift, Ctrl, type a command, and press Enter (ESC aborts). The same commands work here — type them in the console, or use the buttons above.

• macro,<name>,<text> — define a macro; type <name>+Enter on the keyboard to expand it
• macro,list · macro,delete,<name> · macro,clear
• remap,<from>,<to> — e.g. remap,CapsLock,Escape
• remap,list · remap,delete,<key> · remap,clear
• wifi,scan · wifi,list · wifi,status · wifi,add,<ssid>,<pw> · wifi,connect,<ssid> · wifi,forget,<ssid>
• pw,<service>[,u|up] — type a saved credential (prompts for the master on the keyboard) · pw,lock
• ai,<question> — ask Gemini; the answer is typed out · ai,key,<k> · ai,status
• ait,add,<name>,<system prompt> — a template · ait,use,<name> (active) · ait,<name>,<question> (one-off) · ait,list · ait,none · ait,delete,<name>
• aimodel,add,<name>[,<url>] — a model (blank URL = Gemini) · aimodel,use,<name> · aimodel,list · aimodel,delete,<name>
• note,add,<name>,<text> — save a note (duplicate names get a -2, -3… suffix) · note,view,<name> (types it) · note,edit · note,delete · note,list. The Notes panel above does multi-line notes + view/edit.
• config,save — persist to flash (restored on boot) · config,load · config,reset
• Backup — the Config panel's Export / Import buttons save/restore all settings (a versioned .conf file; it contains your WiFi passwords and API key in the clear)
• help — command reference on the device

On the keyboard, Ctrl,Shift,Ctrl then Enter (no command) opens an interactive menu — do that in an empty editor.

Web Serial needs Chrome or Edge over https (or localhost). This page is hosted at davidkim-code.github.io/clidongle-web — just open it there. For local development you can instead run python3 -m http.server in this folder and open http://localhost:8000/.