Skip to content

fix(title): Restructure the agent (scout) detail header#2919

Merged
Twixes merged 7 commits into
mainfrom
posthog-code/scout-detail-header-layout
Jun 25, 2026
Merged

fix(title): Restructure the agent (scout) detail header#2919
Twixes merged 7 commits into
mainfrom
posthog-code/scout-detail-header-layout

Conversation

@rubychilds

@rubychilds rubychilds commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

What

AI:
Reworks the header on the agent (scout) detail screen so it reads as a page header rather than a card, and tightens the loading + type hierarchy.

  • Dissolve the header card. The agent name now sits on the page-title row (under the "← Agents" breadcrumb) with the origin/dry-run badges, the skill link icon, and the cadence beside it, and the chat / settings / enable-toggle controls aligned to its right (toggle far right).
  • Stats under the title. The runs-window stats line ("Last 3 days: N runs · …") moved directly under the title, with the recent-runs boxes inlined onto the same row to save vertical space.
  • Description as plain text. The description renders as plain body text below the header instead of inside a card, and was dropped to the 12.5px body tier so it no longer competes with the 13px semibold "Signals"/"Runs" section headings.
  • Loading skeleton. Runs load from a separate query than the config that renders the title, so the stats line used to pop in late and shift the layout. The stats row now shows the app's standard animate-pulse skeleton while runs are pending, reserving the space.

Detail-page only — the fleet-list rows are unchanged. ScoutRowCard is reverted to its original fleet-list form (its ScoutChatButton is now exported for reuse), and the detail header lives in the new ScoutDetailHeader component.

Screenshot 2026-06-24 at 6 08 12 PM

This image shows how we have settings for the agent. If this expands we should place it elsewhere, but not a concern for now.

Screenshot 2026-06-24 at 6 10 36 PM

Files

  • packages/ui/src/features/scouts/components/ScoutDetailHeader.tsx (new) — the detail-page header.
  • packages/ui/src/features/scouts/components/ScoutDetailView.tsx — renders the new header; description as plain body text.
  • packages/ui/src/features/scouts/components/ScoutRowCard.tsx — reverted to fleet-list form; export ScoutChatButton.

Testing

  • pnpm --filter @posthog/ui typecheck (scout files clean) and Biome lint clean.
  • Verified live in the desktop app against an enrolled project: title row + badges + link + far-right toggle, stats under the title, description as plain text, run boxes inline, and the stats-row skeleton during a cold load.

Created with PostHog Code

Show the agent description as full text on the detail page instead of a
tooltip on the name, surface the runs-window stats directly under the
title (moved into the card), and move the enable/disable toggle to the far
right of the title row. Detail-only via the linkToDetail flag; fleet rows
are unchanged.

Generated-By: PostHog Code
Task-Id: 124dba4f-35df-4f39-a23a-52d2712767bf
Dissolve the header card on the scout detail screen. The agent name now
sits on the page-title row (under the Agents breadcrumb) with the origin
and dry-run badges, the skill link, and the cadence beside it, and the
chat/settings/enable controls aligned to its right. The runs-window stats
sit directly under the title, and the description renders as plain page
text instead of inside a card. ScoutRowCard is reverted to its fleet-list
form (its ScoutChatButton is now exported for reuse) and the detail header
lives in the new ScoutDetailHeader component.

Generated-By: PostHog Code
Task-Id: 124dba4f-35df-4f39-a23a-52d2712767bf
Put the recent-runs boxes on the same row as the runs-window stats text
instead of a row below, reducing vertical spacing in the detail header.

Generated-By: PostHog Code
Task-Id: 124dba4f-35df-4f39-a23a-52d2712767bf
The description was 13px — the same size as the Signals/Runs section
headings — which flattened the hierarchy. Move it to 12.5px so it reads as
body text below the semibold headings, matching the stats line and run
summaries.

Generated-By: PostHog Code
Task-Id: 124dba4f-35df-4f39-a23a-52d2712767bf
…load

The runs-window stats load from a separate query than the config that
renders the title, so the stats line popped in late and shifted the
layout. Show the app's standard animate-pulse skeleton in the stats row
while runs are pending, so the space is reserved and the stats swap in
without a jump.

Generated-By: PostHog Code
Task-Id: 124dba4f-35df-4f39-a23a-52d2712767bf
@github-actions

github-actions Bot commented Jun 24, 2026

Copy link
Copy Markdown

React Doctor found no issues in the changed files. 🎉

Reviewed by React Doctor for commit 4eeaed0.

@greptile-apps

greptile-apps Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Reviews (1): Last reviewed commit: "fix(scouts): reserve the detail stats ro..." | Re-trigger Greptile

Comment thread packages/ui/src/features/scouts/components/ScoutDetailHeader.tsx Outdated
@rubychilds rubychilds changed the title Restructure the agent (scout) detail header fix(title): Restructure the agent (scout) detail header Jun 24, 2026
rubychilds and others added 2 commits June 24, 2026 18:11
…rflowing

A flex item defaults to min-width:auto and won't shrink below its content
width, so the `truncate` on the title had no effect — a long agent name
overflowed the row. min-w-0 lets it shrink and ellipsise.

Generated-By: PostHog Code
Task-Id: 124dba4f-35df-4f39-a23a-52d2712767bf
@rubychilds rubychilds requested a review from a team June 24, 2026 22:15
@charlesvien charlesvien requested a review from a team June 25, 2026 02:41
@Twixes Twixes merged commit 6fd33f5 into main Jun 25, 2026
23 checks passed
@Twixes Twixes deleted the posthog-code/scout-detail-header-layout branch June 25, 2026 07:23
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.

3 participants