sliccy 6.97.0 → 6.99.0

package/README.md

@@ -183,6 +183,34 @@ Once the product makes sense, the ice-cream language is easier to enjoy: it maps
 
 Why the name? SLICC stands for **Self-Licking Ice Cream Cone**: a recursive system that can help build, extend, and operate itself. A browser agent running inside the browser: that's as self-recursive as tongue-out gelato.
 
+## Keyboard mode
+
+SLICC's main control is a text field, so it has no always-on shortcuts to collide with your typing. Instead it has a **mode**, like vim: press <kbd>Esc</kbd> to leave the composer and enter keyboard mode, and every key below is a bare letter. Press <kbd>Esc</kbd> again to leave (a second press is also what exits full screen — the first one belongs to the mode). While the mode is on, a pill above the composer says so.
+
+| Key                                        | Action                                                      |
+| ------------------------------------------ | ----------------------------------------------------------- |
+| <kbd>Esc</kbd>                             | Enter keyboard mode — press again to leave                  |
+| <kbd>1</kbd>…<kbd>9</kbd>                  | Switch to that agent in the tab strip (<kbd>9</kbd> = last) |
+| <kbd>d</kbd>                               | Next agent, looping                                         |
+| <kbd>c</kbd> or <kbd>⏎</kbd>               | Back to the composer                                        |
+| <kbd>n</kbd>                               | New conversation                                            |
+| <kbd>b</kbd>                               | Toggle the left rail                                        |
+| <kbd>x</kbd>                               | Toggle the right panel                                      |
+| <kbd>f</kbd>                               | File browser                                                |
+| <kbd>t</kbd>                               | Browser tabs                                                |
+| <kbd>e</kbd>                               | Terminal                                                    |
+| <kbd>m</kbd>                               | Memory                                                      |
+| <kbd>s</kbd>                               | Sprinkles, looping                                          |
+| <kbd>l</kbd>                               | Model picker                                                |
+| <kbd>a</kbd>                               | Accounts                                                    |
+| <kbd>h</kbd>, <kbd>?</kbd> or <kbd>/</kbd> | This list, in an overlay                                    |
+
+Every key you press shows up as a cap on the pill — dimmed if it was not bound to anything, so a mistyped key reads as "that did nothing" rather than as a dead keyboard. The strip clears after a moment of quiet.
+
+Keys that navigate, or toggle chrome (digits, <kbd>d</kbd>, <kbd>b</kbd>, <kbd>x</kbd>, <kbd>s</kbd>, help), keep the mode on; anything that hands focus to a surface leaves it, as does clicking into any text field. Outside the mode nothing is intercepted at all. The overlay is also in the avatar menu, under **Keyboard mode**.
+
+**Rebinding.** The keys live in `/etc/slicc/keys.json` in the VFS, written the first time SLICC starts and never touched again — edit it and reload the tab. Each entry maps a key to a command (`"q": "terminal"`) and several keys can share one command. The file is applied _over_ the built-in keymap, so `null` removes a binding while deleting the line just restores its default — which is also how you inherit any keys a later version adds. The file lists every command it accepts. <kbd>Esc</kbd> and the digits are reserved. A bad line is skipped with a warning rather than costing you the rest of the file, and the help overlay always shows what is actually bound.
+
 ## API Keys and Providers
 
 To use SLICC, you need an LLM provider. SLICC is very much a BYOT (bring your own tokens) affair. We have built-in support for many providers, and these have actually been tested.