cmux NEXT Home: the import suggestion is one glass row on the Chief's front page, never over the chat

Merged
TE
15d ago
+423-316

On nightly 331e2e9 Home's import cards ("Bring your stuff to cmux" with Show All, then a Claude Code card and a Codex card, each with Show Chats / Not Now) floated over the Chief's transcript. ImportCardsStripView pinned them to the column's top at a hard-coded 80 pt, above the conversation's views, so the chat showed through and around them and the heading ran into message text.

Now the suggestion is one compact row on the Chief's front page, the empty Chief chat's first-run panel. It sits in the panel's own layout under the action rows (Start an agent, Open a terminal, Show Chief Pet), so it can't cover a message and doesn't depend on the header's height (#23796 removes the header).

  • ImportSuggestionRowView (new) is a 40 pt row on the sidebar cards' glass veil (CardSurfaceView), not an opaque card. It shows the first Home card's app icon, name and facts ("Claude Code", "1,002 sessions"), its button in the theme accent (Palette.accent) and Not Now. Show All (Settings › Import) appears only when there's more than one suggestion. A running import shows its status in place of the facts, with a 2 pt accent progress line. The row hides when there's nothing to suggest.
  • HomeFirstRunView.accessory is a new host-supplied row, placed under the action rows at the panel's column width. Its height counts when the panel fits its rows, and it leaves the layout while hidden. HomeHostView installs the row through HomeNativeTranscriptView.setFirstRunAccessory(_:).
  • Removed: ImportCardsStripView (the floating strip and its cards) and ColumnTopOverlays, which only the strip used, along with the transcript's top-overlay offset for the first-run panel.

Takes back #22710: its Home strip floated the import cards over the Chief's conversation (Leo 2026-10-21, nightly 331e2e9). Home gets one row on the Chief's front page instead; #22710's New Tab and Settings › Import cards stay.

Product call: the floating strip isn't worth keeping behind a toggle, because covering the chat is the bug. Debug Settings › Browser Import's suggestion cards switch (browserImport.suggestionCards, on by default) still turns every suggestion off. The New Tab cards and Settings › Import are unchanged.

Regression test

cmux-ci run --class light --script scripts/ci/package-test-lane.sh --arg=suite --arg=Packages/macOS/CmuxNext --arg=HomeImportSuggestionRowTests,HomeChiefFrontPageTests --env CMUX_CI_XCODE_APP=/Applications/Xcode_26.6.app --ref <sha>

Capture

Steps: launch, raise two cookie suggestions with cmux action run import.suggest, then home.show on an empty Chief.

Before (base 4320f182612, the floating strip over the Chief column):

Capture steps-9c982ab4a2 at 4320f1826120 (fleet build, capture mini, text checked for private data)

LightDark
lightdark

After (head):

Capture steps-9c982ab4a2 at 9cc677e37000 (fleet build, capture mini, text checked for private data)

LightDark
lightdark

Observed / Not run

Observed: cmux-ci compile-check --ref 9cc677e --app passed (job 9d78bc042b93286c7dc4ecc8). The focused suites failed at the test commit and passed at the head, as above. Real-app captures of base and head came from a capture mini. prepush-gate.py reported no new violations. An independent review subagent posted SHIP at the head.

Not run: the full CmuxNextAppTests target, and a capture of a running import's progress line. I also didn't capture the row at Home pane widths under about 330 pt; the review notes its constraints get tight there, and that's a follow-up.

Changelog

Fixed: Home's import suggestion is one dismissible row on the Chief's front page instead of cards floating over the Chief's chat.

Agent session: cosmic-gray

🤖 Generated with Claude Code