@kolisachint/hoocode-agent 0.5.32 → 0.5.34

package/docs/keybindings.md

@@ -20,6 +20,11 @@ After editing `keybindings.json`, run `/reload` in hoocode to apply the changes
 
 Modifier combinations: `ctrl+shift+x`, `alt+ctrl+x`, `ctrl+shift+alt+x`, `ctrl+1`, etc.
 
+> **`alt` needs a cooperating terminal.** On macOS outside the Kitty keyboard
+> protocol, `Option` composes characters instead of sending `Alt` — `Option+M`
+> types `µ`. Some Linux terminals claim `Alt+<letter>` for menu mnemonics. See
+> [terminal-setup.md](terminal-setup.md#alt-keys) for the per-terminal setting.
+
 ## All Actions
 
 ### TUI Editor Cursor Movement

package/docs/terminal-setup.md

@@ -6,6 +6,57 @@ HooCode uses the [Kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keybo
 
 Work out of the box.
 
+## Alt keys
+
+37 actions are reachable only with `Alt` — the model selector (`Alt+M`), settings
+(`Alt+S`), the shortcut list (`Alt+K`), every picker verb, and the tree filters.
+A terminal that speaks the Kitty keyboard protocol reports `Alt` correctly and
+needs nothing here.
+
+Interrupt (`Esc`), clear (`Ctrl+C`), exit (`Ctrl+D`) and expand (`Ctrl+O`) are
+deliberately never on `Alt`, so a misconfigured terminal is recoverable.
+
+### macOS
+
+Outside the Kitty protocol, macOS treats `Option` as a compose key rather than
+`Alt`. `Option+M` produces `µ`, `Option+S` produces `ß`, and `Option+E`,
+`Option+U` and `Option+N` are dead keys that emit nothing at all. HooCode never
+sees a key chord, so it types the character into the prompt instead — or, for
+the dead keys, appears to ignore the press entirely.
+
+Ghostty, Kitty, WezTerm and iTerm2 negotiate the Kitty protocol and are
+unaffected. Terminal.app does not support it, so configure it explicitly:
+
+| Terminal | Setting |
+|---|---|
+| Terminal.app | Settings → Profiles → Keyboard → **Use Option as Meta Key** |
+| iTerm2 (protocol disabled) | Settings → Profiles → Keys → Left Option key → **Esc+** |
+| Ghostty | `macos-option-as-alt = true` |
+| Kitty | `macos_option_as_alt yes` |
+| VS Code | `"terminal.integrated.macOptionIsMeta": true` |
+
+### Linux
+
+GNOME Terminal and Konsole can claim `Alt+<letter>` for menu mnemonics before
+the application sees it — `Alt+F` for File, `Alt+E` for Edit, `Alt+S` for Search,
+`Alt+T` for Terminal, `Alt+H` for Help. Where those overlap, hoocode gets
+nothing.
+
+In GNOME Terminal, turn off Preferences → General → **Enable mnemonics**. In
+Konsole, Settings → Configure Keyboard Shortcuts.
+
+### Rebinding instead
+
+Any of these can be moved rather than configured around. See
+[keybindings.md](keybindings.md); for example, in `~/.hoocode/keybindings.json`:
+
+```json
+{
+  "app.hotkeys.open": "ctrl+q",
+  "app.settings.open": ["alt+s", "f2"]
+}
+```
+
 ## Ghostty
 
 Add to your Ghostty config (`~/Library/Application Support/com.mitchellh.ghostty/config` on macOS, `~/.config/ghostty/config` on Linux):

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-custom-provider-anthropic",
 	"private": true,
-	"version": "0.3.32",
+	"version": "0.3.34",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-custom-provider-gitlab-duo",
 	"private": true,
-	"version": "0.3.32",
+	"version": "0.3.34",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-sandbox",
 	"private": true,
-	"version": "0.3.32",
+	"version": "0.3.34",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-with-deps",
 	"private": true,
-	"version": "0.3.32",
+	"version": "0.3.34",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kolisachint/hoocode-agent",
-	"version": "0.5.32",
+	"version": "0.5.34",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"hoocodeConfig": {
@@ -50,9 +50,9 @@
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"dependencies": {
-		"@kolisachint/hoocode-agent-core": "^0.5.32",
-		"@kolisachint/hoocode-ai": "^0.5.32",
-		"@kolisachint/hoocode-tui": "^0.5.32",
+		"@kolisachint/hoocode-agent-core": "^0.5.34",
+		"@kolisachint/hoocode-ai": "^0.5.34",
+		"@kolisachint/hoocode-tui": "^0.5.34",
 		"@silvia-odwyer/photon-node": "^0.3.4",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",