@sma1lboy/kobe 0.5.15 → 0.5.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -46,8 +46,8 @@ Or run without installing:
46
46
  bunx @sma1lboy/kobe
47
47
  ```
48
48
 
49
- The first launch drops you into an empty sidebar — press `ctrl+n` to create
50
- your first task. kobe will ask for a repo path and a base branch, then spin
49
+ The first launch drops you into an empty sidebar — press `n` to create your
50
+ first task. kobe will ask for a repo path and a base branch, then spin
51
51
  up a worktree at `<repo>/.claude/worktrees/<task-id>/` and a chat pane
52
52
  talking to a fresh `claude` session inside it.
53
53
 
@@ -63,18 +63,17 @@ Once you're in, the keys you'll use most:
63
63
 
64
64
  | Key | What it does |
65
65
  | ------------------ | -------------------------------------------------------------- |
66
- | `ctrl+n` | New task (any pane, any time) |
67
- | `ctrl+1` / `2` / `3` / `4` | Jump straight to a pane (sidebar, workspace, files, terminal) |
66
+ | `ctrl+h` / `ctrl+j` / `ctrl+k` / `ctrl+l` | Jump straight to a pane (sidebar, workspace, files, terminal) |
68
67
  | `tab` | Cycle focus to the next pane |
69
68
  | `ctrl+q` | Detach back to the sidebar (your task keeps streaming) |
70
69
  | `ctrl+o` | Open the active task's worktree in your editor |
71
- | `?` | Show the full keybinding help dialog |
72
- | `,` or `ctrl+,` | Open Settings (theme, transparent background, dev reset) |
70
+ | `F1` | Show the full keybinding help dialog |
71
+ | `ctrl+,` | Open Settings (theme, transparent background, dev reset) |
73
72
  | `q` | Quit (with confirm) |
74
73
 
75
- Inside the sidebar, with a task highlighted: `j/k` to move, `enter` to open,
76
- `r` to rename, `a` to archive, `d` to delete, `[` / `]` to switch between the
77
- working session and the archives view.
74
+ Inside the sidebar, with a task highlighted: `n` creates a task, `j/k` moves,
75
+ `enter` opens, `r` renames, `a` archives, `d` deletes, `s` opens Settings, and
76
+ `[` / `]` switches between the working session and the archives view.
78
77
 
79
78
  Inside the chat composer:
80
79
 
@@ -149,6 +148,21 @@ kobe's renderer requires Bun ≥ 1.0; it does not run under Node.
149
148
 
150
149
  **The terminal pane is blank** — kobe starts your `$SHELL` through Bun's native PTY. Confirm `$SHELL` points at an installed shell, your Bun version supports `Bun.spawn({ terminal })`, and the active task's worktree path still exists. `KOBE_TERMINAL_BACKEND=pipe` is available only as a fallback.
151
150
 
151
+ **Some shortcuts do not work inside tmux** — kobe asks opentui to enable the
152
+ kitty / CSI-u keyboard protocol, but tmux must pass those extended key
153
+ sequences through. Add this to `~/.tmux.conf`, then restart tmux:
154
+
155
+ ```tmux
156
+ set -g extended-keys on
157
+ set -as terminal-features ',xterm*:extkeys'
158
+ set -as terminal-features ',tmux*:extkeys'
159
+ ```
160
+
161
+ Your outer terminal still has to send the sequences. For iTerm2, enable
162
+ profile-level CSI-u key reporting. Terminal-app or macOS-level shortcuts can
163
+ still intercept Option/Cmd chords before tmux sees them; no tmux setting can
164
+ pass through a shortcut the terminal never forwards.
165
+
152
166
  **`posix_spawnp failed` when running `bun run test:behavior`** — on macOS arm64,
153
167
  Bun's installer occasionally ships `node-pty`'s prebuilt `spawn-helper` without
154
168
  an exec bit. The behavior-test driver fixes it lazily on first spawn (see