From 75a111e8f3e21de775d83087cf3b9e289f7c8276 Mon Sep 17 00:00:00 2001 From: Joshua Lambert <25085430+lambertjosh@users.noreply.github.com> Date: Wed, 1 Apr 2026 02:35:58 -0400 Subject: [PATCH] fix(kilo-docs): correct Agent Manager keyboard shortcuts and claims (#7958) * fix(kilo-docs): correct Agent Manager keyboard shortcuts and claims - Fix 8 of 12 keyboard shortcuts in the table: Cmd+N = new worktree (not Cmd+Shift+W) Cmd+Shift+W = close worktree (not new) Cmd+T = new tab (not Cmd+N) Cmd+Alt+Up/Down = prev/next worktree (not bracket keys) Cmd+Alt+Left/Right = prev/next tab (not comma/period) Cmd+/ = show terminal (not Cmd+Alt+T) Cmd+D = toggle diff (not Cmd+Alt+D) Cmd+Shift+/ = show shortcuts (not Cmd+Alt+?) - Add missing shortcuts: Cmd+Shift+N (advanced worktree), Cmd+T (new tab) - Fix body text referencing wrong shortcuts (lines 36, 66, 74) - Remove false .env auto-copy claim (it's a commented-out example in the setup script template, not automatic) - Remove non-existent error message from troubleshooting Validated against package.json keybinding definitions. * Update packages/kilo-docs/pages/automate/agent-manager.md Co-authored-by: kilo-code-bot[bot] <240665456+kilo-code-bot[bot]@users.noreply.github.com> * fix(kilo-docs): add Windows/Linux keybindings to Agent Manager docs --------- Co-authored-by: kilo-code-bot[bot] <240665456+kilo-code-bot[bot]@users.noreply.github.com> --- .../kilo-docs/pages/automate/agent-manager.md | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/packages/kilo-docs/pages/automate/agent-manager.md b/packages/kilo-docs/pages/automate/agent-manager.md index 17162a67172..36f4d816539 100644 --- a/packages/kilo-docs/pages/automate/agent-manager.md +++ b/packages/kilo-docs/pages/automate/agent-manager.md @@ -33,7 +33,7 @@ Each Agent Manager session runs in an isolated git worktree on a separate branch ### Creating a New Worktree Session -1. Click **New Worktree** or press `Cmd+Shift+W` to create a new worktree +1. Click **New Worktree** or press `Cmd+N` (macOS) / `Ctrl+N` (Windows/Linux) to create a new worktree 2. Enter a branch name (or let Kilo generate one) 3. Type your first message to start the agent @@ -63,7 +63,7 @@ You can run up to 4 parallel implementations of the same prompt across separate ## Diff / Review Panel -Press `Cmd+Alt+D` to toggle the diff panel. It shows a live-updating diff between the worktree and its parent branch. +Press `Cmd+D` (macOS) / `Ctrl+D` (Windows/Linux) to toggle the diff panel. It shows a live-updating diff between the worktree and its parent branch. - Select files and click **Apply to Main Branch** to merge changes - Conflicts are surfaced with a resolution dialog @@ -71,11 +71,11 @@ Press `Cmd+Alt+D` to toggle the diff panel. It shows a live-updating diff betwee ## Terminals -Each session has a dedicated integrated terminal. Press `Cmd+Alt+T` to focus the terminal for the active session. +Each session has a dedicated integrated terminal. Press `Cmd+/` (macOS) / `Ctrl+/` (Windows/Linux) to focus the terminal for the active session. ## Setup Scripts -Place an executable script at `.kilo/setup-script` in your project root. It runs automatically whenever a new worktree is created (useful for `npm install`, env setup, etc.). `.env` files are also auto-copied from the main repo. +Place an executable script at `.kilo/setup-script` in your project root. It runs automatically whenever a new worktree is created (useful for `npm install`, env setup, etc.). Root-level `.env` and `.env.*` files are also auto-copied from the main repo before the setup script runs. ## Session State and Persistence @@ -83,26 +83,26 @@ Agent Manager state is persisted in `.kilo/agent-manager.json`. Sessions, worktr ## Keyboard Shortcuts (Agent Manager Panel) -| Shortcut | Action | -| ----------------- | --------------------------------- | -| `Cmd+Shift+M` | Open Agent Manager | -| `Cmd+Shift+W` | New worktree | -| `Cmd+Shift+O` | Import/open worktree | -| `Cmd+Shift+X` | Close current worktree | -| `Cmd+N` | New tab (session) in worktree | -| `Cmd+W` | Close current tab | -| `Cmd+Alt+[` / `]` | Previous / next worktree | -| `Cmd+Alt+,` / `.` | Previous / next tab in worktree | -| `Cmd+Alt+T` | Show terminal for current session | -| `Cmd+Alt+D` | Toggle diff panel | -| `Cmd+Alt+?` | Show keyboard shortcuts | -| `Cmd+1` … `Cmd+9` | Jump to worktree/session by index | +| Shortcut (macOS) | Shortcut (Windows/Linux) | Action | +| ------------------------ | ------------------------- | --------------------------------- | +| `Cmd+Shift+M` | `Ctrl+Shift+M` | Open Agent Manager | +| `Cmd+N` | `Ctrl+N` | New worktree | +| `Cmd+Shift+N` | `Ctrl+Shift+N` | New worktree (advanced options) | +| `Cmd+Shift+O` | `Ctrl+Shift+O` | Import/open worktree | +| `Cmd+Shift+W` | `Ctrl+Shift+W` | Close current worktree | +| `Cmd+T` | `Ctrl+T` | New tab (session) in worktree | +| `Cmd+W` | `Ctrl+W` | Close current tab | +| `Cmd+Alt+Up` / `Down` | `Ctrl+Alt+Up` / `Down` | Previous / next worktree | +| `Cmd+Alt+Left` / `Right` | `Ctrl+Alt+Left` / `Right` | Previous / next tab in worktree | +| `Cmd+/` | `Ctrl+/` | Show terminal for current session | +| `Cmd+D` | `Ctrl+D` | Toggle diff panel | +| `Cmd+Shift+/` | `Ctrl+Shift+/` | Show keyboard shortcuts | +| `Cmd+1` … `Cmd+9` | `Ctrl+1` … `Ctrl+9` | Jump to worktree/session by index | ## Troubleshooting - **"Please open a folder…" error** — the Agent Manager requires a VS Code workspace folder -- **"Cannot use parallel mode from within a git worktree"** — open the main repository (where `.git` is a directory), not a worktree checkout -- **Worktree creation fails** — ensure Git is installed and the workspace is a valid git repository +- **Worktree creation fails** — ensure Git is installed and the workspace is a valid git repository. Open the main repository (where `.git` is a directory), not an existing worktree checkout. {% /tab %} {% tab label="VSCode (Legacy)" %}