Skip to content

feat(tui): add a mini help menu when u write ? in the input field#18043

Merged
ethernet8023 merged 1 commit into
mainfrom
feat/help-ui
Apr 30, 2026
Merged

feat(tui): add a mini help menu when u write ? in the input field#18043
ethernet8023 merged 1 commit into
mainfrom
feat/help-ui

Conversation

@ethernet8023

@ethernet8023 ethernet8023 commented Apr 30, 2026

Copy link
Copy Markdown
Collaborator

Adds a non-intrusive mini help popup to the TUI composer. When the user types ? into the empty input field, a small floating panel appears above the composer showing common slash commands and a preview of keyboard hotkeys. The popup does not steal focus, includes a hint to type /help for the full help panel, and can be dismissed with backspace. This gives new (and forgetful) users a quick reference without leaving the chat flow or opening a full overlay.

Related Issue

Fixes #

Type of Change

  • 🐛 Bug fix (non-breaking change that fixes an issue)

  • ✨ New feature (non-breaking change that adds functionality)

  • 🔒 Security fix

  • 📝 Documentation update

  • ✅ Tests (adding or improving test coverage)

  • ♻️ Refactor (no behavior change)

  • 🎯 New skill (bundled or hub)

Changes Made

  • ui-tui/src/components/helpHint.tsx — new component: renders a positioned popup with COMMON_COMMANDS (6 frequently-used slash commands) and the first 8 entries from HOTKEYS, padded to align labels and descriptions. Uses position="absolute" + bottom="100%" so it floats above the composer without affecting layout or focus.

  • ui-tui/src/components/appLayout.tsx — imports HelpHint and conditionally renders it when composer.input === '?' && !composer.inputBuf.length.

How to Test

  1. Run hermes --tui (or the dashboard /chat which embeds the TUI).

  2. Focus the composer input and type ? and nothing else.

  3. Observe the rounded popup appears directly above the prompt, listing commands like /help, /clear, /resume, and hotkeys.

  4. Verify the popup does not intercept typing or arrow-key focus elsewhere.

  5. Press Backspace to remove ? and confirm the popup disappears instantly.

  6. Type additional characters after ? (e.g. ?h) and confirm the popup does not appear (guard requires !composer.inputBuf.length).

Checklist

Code

  • I've read the Contributing Guide
  • My commit messages follow Conventional Commits (fix(scope):, feat(scope):, etc.)
  • I searched for existing PRs to make sure this isn't a duplicate
  • My PR contains only changes related to this fix/feature (no unrelated commits)
  • I've run pytest tests/ -q and all tests pass
  • I've added tests for my changes (required for bug fixes, strongly encouraged for features)
  • I've tested on my platform:

Documentation & Housekeeping

  • I've updated relevant documentation (README, docs/, docstrings) — or N/A
  • I've updated cli-config.yaml.example if I added/changed config keys — or N/A
  • I've updated CONTRIBUTING.md or AGENTS.md if I changed architecture or workflows — or N/A
  • I've considered cross-platform impact (Windows, macOS) per the compatibility guide — or N/A
  • I've updated tool descriptions/schemas if I changed tool behavior — or N/A

Screenshots

image

it feels so nice :3 just a lil popup ! doesn't get in the way or take
any focus or anything, and directs users to /help for more info :3
@ethernet8023

Copy link
Copy Markdown
Collaborator Author
image

approved ;3

@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have comp/tui Terminal UI (ui-tui/ + tui_gateway/) labels Apr 30, 2026
@ethernet8023 ethernet8023 merged commit 8fbc9d7 into main Apr 30, 2026
8 of 9 checks passed
@ethernet8023 ethernet8023 deleted the feat/help-ui branch April 30, 2026 18:02
02356abc pushed a commit to 02356abc/hermes-agent that referenced this pull request May 14, 2026
feat(tui): add a mini help menu when u write ? in the input field
jsboige pushed a commit to jsboige/hermes-agent that referenced this pull request May 14, 2026
feat(tui): add a mini help menu when u write ? in the input field
dannyJ848 pushed a commit to dannyJ848/hermes-agent that referenced this pull request May 17, 2026
feat(tui): add a mini help menu when u write ? in the input field
gweeteve pushed a commit to gweeteve/hermes-agent that referenced this pull request Jun 2, 2026
feat(tui): add a mini help menu when u write ? in the input field
Egavasyug pushed a commit to Egavasyug/hermes-agent that referenced this pull request Jun 10, 2026
feat(tui): add a mini help menu when u write ? in the input field
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/tui Terminal UI (ui-tui/ + tui_gateway/) P3 Low — cosmetic, nice to have type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants