Skip to content

fix(desktop): stop tip-wrapping obvious chrome - #73062

Merged
OutThisLife merged 7 commits into
mainfrom
bb/sane-tooltips
Jul 28, 2026
Merged

fix(desktop): stop tip-wrapping obvious chrome#73062
OutThisLife merged 7 commits into
mainfrom
bb/sane-tooltips

Conversation

@OutThisLife

@OutThisLife OutThisLife commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

Desktop tip tax got out of hand. A DESIGN rule that every icon button needed a <Tip> produced tautological hover text on kebabs, close buttons, and statusbar chrome. Tips should only teach something hover can't already see.

Removed tips

Kebab / menu triggers

Surface Was
Session row ⋯ "Actions for ${title}"
Project menu ⋯ "Project actions"
Workspace / worktree lane ⋯ "Project actions"
Panel row ⋯ (Cron, Profiles, Webhooks, …) "Actions" (or caller label)
Credential / env-var ⋯ "Credential actions"

Close / dismiss X

Surface Was
Dialog close "Close"
Overlay close (settings, cron, …) "Close settings" / etc.
Find-in-page close "Close"
Master-detail pane close "Close"
Review pane + selected-file close review close label

Statusbar / titlebar lectures

Surface Was
Connection chip "Connected … · click to manage"
Gateway (when healthy) "Hermes inference gateway status"
Turn / session timers "Current turn elapsed" / "Runtime session elapsed"
Context meter "Open context usage breakdown"
Cron / Webhooks "Open cron jobs" / "Open webhooks"
Titlebar flip panes paraphrase of "Swap sidebar sides"

Aria + copy

  • Kebab aria-labels shortened to "Session actions" / "Actions" (no "Actions for <name>")
  • Toast fallback "The response is ready." → empty (body already has response text when present)
  • Settings: turn-failed description, enable-all desc, gateway / appearance / notifications / plugins intros trimmed
  • YOLO tip strings: drop "click to…" filler; keep Shift+click global note
  • Dead credentialActions i18n string removed
  • ActionsMenu / SessionActionsMenu tooltip prop removed

Left alone (still useful)

Keybind hints, truncated paths / cwd tip, handoff platform badge, appearance icon grid, load-more / new-worktree / share import-export, icon-only titlebar/statusbar (Command Center, terminal), gateway tip when there's a real status reason, layout-editor tip (⌘-click reset).

Test plan

  • Session / project / panel / credential ⋯ — no tip; menu still opens
  • Dialog and settings overlay X — no tip; still closes
  • Statusbar connection / timers / context / cron — no tip noise; gateway tip only when status has a reason
  • Titlebar flip — tip is label + keybind, not a paraphrase
  • Native "response ready" notification — no empty/echo body when response text exists
  • npx vitest run dialog / sidebar / panel / toolset-config tests

Drop the blanket "every icon* button needs a Tip" rule — it produced
tautological kebab tips like "Actions for <row title>". Menu triggers keep
aria-label; tips stay for unlabeled discovery chrome and keybind hints.
Remove the ActionsMenu tooltip prop and Tip wrappers on session, project,
workspace, panel, and credential ⋯ menus. aria-label stays for a11y; drop
the unused credentialActions string.
Flip the #67500 structure tests that required tooltip-trigger on menu
kebabs; keep coverage that the menus still open on click.
@OutThisLife

Copy link
Copy Markdown
Collaborator Author

@ethernet8023 — heads up: this revises the DESIGN tip rule from #65204 (every icon* button → Tip). That blanket rule is what led to kebab tips like "Actions for …" / "Project actions". Menu triggers keep aria-label; tips stay for real discovery chrome + keybind hints.

@alt-glitch alt-glitch added type/bug Something isn't working comp/desktop Electron desktop app (apps/desktop/*) area/i18n Localization, locales, translations P3 Low — cosmetic, nice to have needs-decision Awaiting maintainer decision before any implementation labels Jul 28, 2026
@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

૮ >ﻌ< ა ci review

ran on 015353d

ℹ️ Info

Desktop E2E visual evidence · View test artifacts · View job

1 visual diff.

inline evidence upload failed.

Failed to upload diff-665a0833239e-onboarding-overlay-diff.png with gh image (exit code 1): Error uploading /home/runner/work/_temp/e2e-evidence/diff-665a0833239e-onboarding-overlay-diff.png: step 0 (get upload token): uploadToken not found on repo page — do you have write access to NousResearch/hermes-agent? (or, if NousResearch enforces SAML SSO, authorize at https://github.com/orgs/NousResearch/sso)

Extend the tip rule past kebabs — no tip on dismiss X, and no tips that
only paraphrase a visible label or say "click to…".
Drop tips on dialog/overlay/find-bar/review/master-detail close buttons.
Stop tip-wrapping connection/gateway/timer/context/cron/webhook chrome
that already names itself on screen; keep tip only when there's a real
gateway reason. Drop the titlebar swap paraphrase.
Use short static labels (Session actions / Actions) instead of
Actions for <name>. Trim toast fallback, settings echoes, YOLO click
lectures, and fat gateway/appearance/notifications intros.
@OutThisLife OutThisLife changed the title fix(desktop): stop tip-wrapping kebab menu triggers fix(desktop): stop tip-wrapping obvious chrome Jul 28, 2026
@OutThisLife
OutThisLife merged commit 9ed212e into main Jul 28, 2026
34 checks passed
@OutThisLife
OutThisLife deleted the bb/sane-tooltips branch July 28, 2026 03:16
randlee pushed a commit to randlee/hermes-agent that referenced this pull request Aug 11, 2026
fix(desktop): stop tip-wrapping kebab menu triggers
33hodl pushed a commit to 33hodl/hermes-agent that referenced this pull request Aug 12, 2026
fix(desktop): stop tip-wrapping kebab menu triggers
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/i18n Localization, locales, translations comp/desktop Electron desktop app (apps/desktop/*) needs-decision Awaiting maintainer decision before any implementation P3 Low — cosmetic, nice to have type/bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants