NousResearch/hermes-agent

Fix Alt key shortcut crashes in CLI prompt_toolkit

Cluster 74169 · hermes cli. Data as of 2026-10-25 11:21 UTC

Nothing open on GitHub. Fix merged in #86768 on 15 Aug 2026. Check it covers your case.

open issues

open PRs

items grouped

Known?: Yes. 4 related items grouped here, 1 issue already closed.
Fix event: A fix was merged to main in PR #86768. Check it covers your case. No release data is tracked.
Tracker: The maintainers' tracker marks this resolved, deciding PR #86768. That is separate from the fix event.
Still open: Nothing open on GitHub.

Next step: read #86768, then check it covers your case.

Read #86768 Pick up a Lab task

These issues and fixes address CLI startup crashes and broken shortcuts caused by prompt_toolkit rejecting Alt key bindings in an unsupported string format. The fixes convert Alt key definitions to accepted escape sequence or tuple formats.

Open issues0

No open issues.

Open PRs0

No open pull requests.

Fixes on record

Merged to main. A stamp counts the issues a fix is linked to.

#86768 fix(tui,cli): salvage editing shortcuts — paste/copy/word-delete, CLI multiline defaults, Alt-shortcut prompt_toolkit crash

merged to main

files: cli.py, contributors/emails/[redacted:email], hermes_cli/config_defaults.py, hermes_cli/voice.py, tests/cli/test_cli_init.py, tests/cli/test_ctrl_enter_newline.py, tests/hermes_cli/test_voice_wrapper.py, ui-tui/src/__tests__/inputSelectionClipboard.test.ts, ui-tui/src/__tests__/textInputCut.test.ts, ui-tui/src/__tests__/textInputWordDelete.test.ts, ui-tui/src/app/inputSelectionStore.ts, ui-tui/src/app/useInputHandlers.ts, ui-tui/src/components/textInput.tsx, web/src/lib/pty-keyboard-shortcuts.test.ts, web/src/lib/pty-keyboard-shortcuts.ts, web/src/pages/ChatPage.tsx, website/docs/user-guide/cli.md, website/docs/user-guide/configuration.md

2 PRs closed without merging

From the close comments: done elsewhere 1 · merged via another change 1

#74184 fix(cli): bind alt voice.record_key as an escape sequence so startup doesn't crash (#74169) · done elsewhere → fef9c53, #74169
#74257 fix(cli): convert Alt key shortcuts to sequence tuple for prompt_toolkit · merged via another change → #86768

Closed issues · 1

Closed#74169CLI crash on startup when voice.record_key uses alt (e.g. alt+v): prompt_toolkit rejects 'a-v' key format

How this cluster was grouped

Link evidence (structural links throughout): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
Pairwise link density 0.50: the share of item pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. 1.00 means every pair is linked.

Pick up a Lab task

Check whether a fix covers the open issues here, with your own agent. Bring back evidence for maintainers.

Open the Lab

At a glance

Subsystem: hermes cli
Merged PRs: #86768
Closed issues: 1
Attempts: 2 PRs closed without merging
Fix link checked: 15 Aug 2026

For your agent

The same facts, typed.

cluster/74169.json
cluster/74169.md