feat(tui): nudge toward /agents dashboard when delegation starts - #34704
Merged
kshitijk4poor merged 1 commit intoMay 30, 2026
Merged
Conversation
alt-glitch
added
type/feature
kshitijk4poor
force-pushed
the
feat/tui-agents-nudge
branch
from
May 30, 2026 06:51
341407b to
6804191
Compare
The TUI already ships a rich /agents spawn-tree dashboard (live tree,
timeline, per-child tokens/cost/files/tools, kill/pause), but nothing
surfaced it — during delegation the transcript stayed quiet and users
had to already know to type /agents.
Drop a one-time transient activity hint ("subagents working · /agents
to watch live") the first time a turn starts delegating, matching the
existing "· /logs to inspect" house style. Guards keep it unobtrusive:
- fires at most once per turn (resets on message.start)
- silent when the /agents overlay is already open
- gated by display.tui_agents_nudge (default true)
Hooked on subagent.start, not subagent.spawn_requested: the delegate
progress callback in tools/delegate_tool.py only relays start/complete
to the gateway and drops spawn_requested, so start is the first
delegation event the TUI reliably receives. spawn_requested is wired
too for the future case, guarded once-per-turn.
Adds the display.tui_agents_nudge config default and gatewayTypes entry.
kshitijk4poor
force-pushed
the
feat/tui-agents-nudge
branch
from
May 30, 2026 06:56
6804191 to
5a72e82
Compare
1 task
alt-glitch
pushed a commit
that referenced
this pull request
Jun 14, 2026
feat(tui): nudge toward /agents dashboard when delegation starts
T02200059
pushed a commit
to T02200059/hermes-agent
that referenced
this pull request
Jun 18, 2026
…nts-nudge feat(tui): nudge toward /agents dashboard when delegation starts
waefrebeorn
pushed a commit
to waefrebeorn/slermes
that referenced
this pull request
Jul 2, 2026
…nts-nudge feat(tui): nudge toward /agents dashboard when delegation starts
santhreal
pushed a commit
to santhreal/hermes-agent
that referenced
this pull request
Jul 13, 2026
…nts-nudge feat(tui): nudge toward /agents dashboard when delegation starts
Gravezzz
pushed a commit
to Gravezzz/hermes-agent
that referenced
this pull request
Jul 21, 2026
…nts-nudge feat(tui): nudge toward /agents dashboard when delegation starts
leewenjie
pushed a commit
to leewenjie/hermes-agent
that referenced
this pull request
Aug 7, 2026
…nts-nudge feat(tui): nudge toward /agents dashboard when delegation starts
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The TUI already ships a capable
/agentsspawn-tree dashboard (live tree, Gantt timeline, per-child tokens/cost/files/tool calls, kill/pause controls, history replay) — but nothing surfaced it. While a turn delegates, the transcript stays quiet and the user has to already know to type/agents.This adds a one-time, transient activity hint the first time a turn starts delegating:
It matches the existing
· /logs to inspecthouse style and points at the dashboard without hijacking the screen.Behavior
message.start)./agentsoverlay is already open (nothing to advertise).display.tui_agents_nudge(default true). Disable withhermes config set display.tui_agents_nudge false.Why hook
subagent.startand notspawn_requestedThe delegate progress callback in
tools/delegate_tool.pyonly relayssubagent.startandsubagent.completeto the gateway —subagent.spawn_requestedfalls through its event normalizer and is dropped, so it never reaches the TUI in the CLI→gateway path.subagent.startis the first delegation event the TUI reliably receives. The handler hooks both (thespawn_requestedcase is wired for the future, also once-per-turn guarded), so the nudge fires regardless of which path emits first.Changes
ui-tui/src/app/createGatewayEventHandler.ts— nudge logic (config-gated, once-per-turn, silent-when-open), hooked onsubagent.start+subagent.spawn_requested, reset onmessage.start. Config flag fetched eagerly via existingconfig.get fullpattern.ui-tui/src/gatewayTypes.ts—tui_agents_nudgeonConfigDisplayConfig.hermes_cli/config.py—display.tui_agents_nudgedefault (True).spawn_requested, fires onstart, once-per-turn + resets next turn, silent when overlay open, disabled by config flag.Test plan
npx vitest run src/__tests__/createGatewayEventHandler.test.ts→ 48 passedui-tuisuite → only the pre-existing unrelatedvirtualHeights.test.tsfailure remains (present on basemain)npx eslintclean on touched filestui_agents_nudgeresolves toTrueviaload_config()→ flows throughconfig.get full