Skip to content

fix(agent-manager): preserve explicit branch names and expose naming settings - #13860

Merged
marius-kilocode merged 3 commits into
mainfrom
agent-branch-settings
Sep 7, 2026
Merged

marius-kilocode merged 3 commits into
mainfrom
agent-branch-settings

Conversation

@marius-kilocode

@marius-kilocode marius-kilocode commented Sep 7, 2026

Copy link
Copy Markdown
Collaborator

What Problem This Solves

Agent Manager rewrites explicit Git branch names, including slash-separated names such as feature/task. The existing automatic branch naming settings are available in VS Code settings but missing from the Agent Manager settings page.

Addresses the branch naming request in #13833. Existing-worktree targeting and ephemeral worktrees are outside this PR.

Why This Change Was Made

Keep the Git ref separate from its filesystem directory name. Validate explicit refs with Git, preserve valid names, and derive a safe directory name only where needed. A stable hash distinguishes refs that produce the same shortened slug. Automatic naming and collision/version suffix behavior remain unchanged.

User Impact

Explicit names retain slashes, case, and punctuation. Invalid names are rejected before the dialog clears the draft. Display names still produce automatic slugs, and existing-branch directory collisions preserve unrelated worktrees and uncommitted files. Agent Manager settings now expose the existing automatic naming toggle and branch prefix through the normal Save/Discard flow. No new setting keys or defaults are introduced.

Evidence

Real-Git regression tests cover exact names, unsafe directory characters, invalid refs, and collisions. The full extension unit suite passed (5,049 passed, one skipped). Build, typechecks, lint, and Knip passed. In isolated VS Code, Save wrote the existing application settings, Discard restored the previous value, and saved values survived a window reload.

Branch prefix control in Agent Manager settings

@kilo-code-bot

kilo-code-bot Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Code Review Summary

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
packages/kilo-vscode/webview-ui/agent-manager/new-worktree-branch.ts 4 validBranch allows @, which Git rejects as a branch name
Files Reviewed (2 files)
  • packages/kilo-vscode/tests/unit/kilo-provider-indexing-refresh.test.ts
  • packages/kilo-vscode/webview-ui/agent-manager/new-worktree-branch.ts - 1 issue

Fix these issues in Kilo Cloud

Previous Review Summaries (2 snapshots, latest commit a2d40c6)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit a2d40c6)

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
packages/kilo-vscode/webview-ui/agent-manager/new-worktree-branch.ts 4 validBranch allows @, which Git rejects as a branch name
Files Reviewed (28 files)
  • packages/kilo-vscode/src/agent-manager/WorktreeManager.ts
  • packages/kilo-vscode/src/agent-manager/provider-multi-version.ts
  • packages/kilo-vscode/tests/unit/new-worktree-branch.test.ts
  • packages/kilo-vscode/tests/unit/provider-multi-version.test.ts
  • packages/kilo-vscode/tests/unit/worktree-manager.test.ts
  • packages/kilo-vscode/webview-ui/agent-manager/NewWorktreeDialog.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/new-worktree-branch.ts - 1 issue
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ar.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/br.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/bs.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/da.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/de.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/en.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/es.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/fa.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/fr.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/it.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ja.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ko.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/nl.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/no.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/pl.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ru.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/th.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/tr.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/uk.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/zh.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/zht.ts

Fix these issues in Kilo Cloud

Previous review (commit 18e1ac4)

Status: No Issues Found | Recommendation: Merge

Files Reviewed (33 files)
  • .changeset/preserve-agent-manager-branches.md
  • packages/kilo-vscode/src/KiloProvider.ts
  • packages/kilo-vscode/src/agent-manager/WorktreeManager.ts
  • packages/kilo-vscode/src/agent-manager/tool-start.ts
  • packages/kilo-vscode/src/kilo-provider/config-snapshot.ts
  • packages/kilo-vscode/tests/unit/agent-manager-settings.test.ts
  • packages/kilo-vscode/tests/unit/agent-manager-tool-start.test.ts
  • packages/kilo-vscode/tests/unit/kilo-provider-indexing-refresh.test.ts
  • packages/kilo-vscode/tests/unit/worktree-manager.test.ts
  • packages/kilo-vscode/webview-ui/agent-manager/NewWorktreeDialog.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ar.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/br.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/bs.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/da.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/de.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/en.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/es.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/fa.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/fr.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/it.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ja.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ko.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/nl.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/no.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/pl.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ru.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/th.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/tr.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/uk.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/zh.ts
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/zht.ts
  • packages/kilo-vscode/webview-ui/src/components/settings/Settings.tsx
  • packages/opencode/src/kilocode/tool/agent-manager.txt

Reviewed by grok-4.6 · Input: 145.6K · Output: 5.9K · Cached: 137.6K

Review guidance: REVIEW.md from base branch main

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants