Skip to content

feat(agent-manager): add inline worktree introduction - #13734

Merged
marius-kilocode merged 5 commits into
mainfrom
improve-agent-manager-welcome-screen
Sep 3, 2026
Merged

feat(agent-manager): add inline worktree introduction#13734
marius-kilocode merged 5 commits into
mainfrom
improve-agent-manager-welcome-screen

Conversation

@marius-kilocode

Copy link
Copy Markdown
Collaborator

What Problem This Solves

Agent Manager reused the generic assistant welcome, leaving new users to discover what worktrees isolate, how parallel tasks relate to a repository, and how work becomes a pull request.

Why This Change Was Made

Explain the workflow where a new session starts, using two example worktree cards rendered by the real card component. The previews show branches, changes, and PR status without creating worktrees, querying GitHub, or exposing active card controls.

The introduction components, state, and styling live in webview-ui/agent-manager/intro/. Shared chat changes are limited to empty-state composition and layout hooks; normal history rendering and the central Agent Manager provider remain unchanged.

User Impact

  • New and empty sessions show the introduction by default. Existing conversations are not replaced.
  • Skip restores the normal welcome, recent-session history, and Feedback & Support. A small “How Agent Manager works” control enables the introduction again inline, without a modal or losing the draft.
  • The preference persists across sessions and reloads. Re-enabling keeps the introduction visible in new sessions until Skip is selected again.
  • Larger panes show guidance inline; smaller panes use compact help popovers. The copy explains repository ownership, PR detection, and avoiding shared Git stashes.

Evidence

Verified in isolated VS Code: initial inline display, normal and narrow layouts, Skip, re-enable, new sessions, persistence after reload, and draft preservation. The preview is illustrative; no Git operation or model request is started by viewing it.

Introduction enabled

Agent Manager introduction with two worktree card previews, branches, PR badges, and workflow help

After Skip

Normal welcome in a fresh test workspace, with the control to enable the introduction again. Existing recent-session history remains part of the shared welcome component.

Normal welcome after skipping the introduction, with Feedback and Support and a How Agent Manager works button

Comment thread packages/kilo-vscode/webview-ui/agent-manager/i18n/ar.ts Outdated
Comment thread packages/kilo-vscode/webview-ui/agent-manager/intro/AgentManagerIntro.tsx Outdated
@kilo-code-bot

kilo-code-bot Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (42 files)
  • .changeset/agent-manager-intro-screen.md
  • packages/kilo-docs/public/img/screenshot-tests/kilo-vscode/visual-regression/agentmanager/introduction-chromium-linux.png
  • packages/kilo-docs/public/img/screenshot-tests/kilo-vscode/visual-regression/agentmanager/introduction-skipped-chromium-linux.png
  • packages/kilo-docs/source-links.md
  • packages/kilo-vscode/src/agent-manager/vscode-host.ts
  • packages/kilo-vscode/src/utils.ts
  • packages/kilo-vscode/tests/unit/agent-manager-arch.test.ts
  • packages/kilo-vscode/tests/unit/agent-manager-i18n-split.test.ts
  • packages/kilo-vscode/webview-ui/agent-manager/AgentManagerApp.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/ProjectList.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/SidebarBody.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/WorktreeItem.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/WorktreeSectionActions.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/agent-manager/intro/AgentManagerIntro.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/intro/IntroGraph.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/intro/intro.css
  • packages/kilo-vscode/webview-ui/src/components/chat/ChatView.tsx
  • packages/kilo-vscode/webview-ui/src/components/chat/MessageList.tsx
  • packages/kilo-vscode/webview-ui/src/components/chat/WelcomeEmptyState.tsx
  • packages/kilo-vscode/webview-ui/src/stories/agent-manager.stories.tsx
  • packages/kilo-vscode/webview-ui/src/types/messages/webview-messages.ts
Previous Review Summaries (3 snapshots, latest commit 928253a)

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

Previous review (commit 928253a)

Status: No Issues Found | Recommendation: Merge

Files Reviewed (20 files)
  • packages/kilo-docs/public/img/screenshot-tests/kilo-vscode/visual-regression/agentmanager/introduction-chromium-linux.png
  • packages/kilo-docs/public/img/screenshot-tests/kilo-vscode/visual-regression/agentmanager/introduction-skipped-chromium-linux.png
  • packages/kilo-vscode/tests/unit/agent-manager-i18n-split.test.ts
  • packages/kilo-vscode/webview-ui/agent-manager/AgentManagerApp.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/fa.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/stories/agent-manager.stories.tsx

Previous review (commit d95e20d)

The review did not run because the selected model is no longer available.

Choose another model in Kilo Code review settings: https://app.kilo.ai/code-reviews

Previous review (commit d95e20d)

Status: 2 Issues Found | Recommendation: Address before merge

Overview

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

WARNING

File Line Issue
packages/kilo-vscode/webview-ui/agent-manager/i18n/ar.ts 275 Intro copy is stale and still contains untranslated English

SUGGESTION

File Line Issue
packages/kilo-vscode/webview-ui/agent-manager/intro/AgentManagerIntro.tsx 46 Add a Storybook story for this introduction
Files Reviewed (39 files)
  • .changeset/agent-manager-intro-screen.md
  • packages/kilo-docs/source-links.md
  • packages/kilo-vscode/src/agent-manager/vscode-host.ts
  • packages/kilo-vscode/src/utils.ts
  • packages/kilo-vscode/tests/unit/agent-manager-arch.test.ts
  • packages/kilo-vscode/webview-ui/agent-manager/AgentManagerApp.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/ProjectList.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/SidebarBody.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/WorktreeItem.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/WorktreeSectionActions.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/i18n/ar.ts - 1 issue
  • 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/agent-manager/intro/AgentManagerIntro.tsx - 1 issue
  • packages/kilo-vscode/webview-ui/agent-manager/intro/IntroGraph.tsx
  • packages/kilo-vscode/webview-ui/agent-manager/intro/intro.css
  • packages/kilo-vscode/webview-ui/src/components/chat/ChatView.tsx
  • packages/kilo-vscode/webview-ui/src/components/chat/MessageList.tsx
  • packages/kilo-vscode/webview-ui/src/components/chat/WelcomeEmptyState.tsx
  • packages/kilo-vscode/webview-ui/src/stories/agent-manager.stories.tsx
  • packages/kilo-vscode/webview-ui/src/types/messages/webview-messages.ts

Fix these issues in Kilo Cloud


Reviewed by grok-4.6 · Input: 177.4K · Output: 23.3K · Cached: 1.3M

Review guidance: REVIEW.md from base branch main

@marius-kilocode
marius-kilocode force-pushed the improve-agent-manager-welcome-screen branch from 928253a to 1414543 Compare September 3, 2026 11:11
@marius-kilocode
marius-kilocode merged commit 6f0e43b into main Sep 3, 2026
27 checks passed
@marius-kilocode
marius-kilocode deleted the improve-agent-manager-welcome-screen branch September 3, 2026 13:11
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