Skip to content

feat(tui): add keymap debug inspector#20794

Merged
fcoury-oai merged 4 commits into
mainfrom
debug-keybinding
May 4, 2026
Merged

feat(tui): add keymap debug inspector#20794
fcoury-oai merged 4 commits into
mainfrom
debug-keybinding

Conversation

@fcoury-oai
Copy link
Copy Markdown
Contributor

@fcoury-oai fcoury-oai commented May 2, 2026

Why

We constantly get bug reports about keys not being recognized by Codex when the terminal is not handling the key press. Running /keymap debug or /keymap and going to the Debug tab, we can allow the user to either understand that the key being pressed is not being recognized or to check what it's being recognized as and report or reassign that key.

Menu Inspector Hint
CleanShot 2026-05-02 at 12 57 12 CleanShot 2026-05-02 at 12 56 36 CleanShot 2026-05-02 at 12 57 30

Summary

  • add a Debug tab to /keymap and support /keymap debug for direct access
  • show what key Codex receives, the config key representation, raw event details, and matching actions
  • add a progressive missing-key hint that escalates after a few seconds with no detected keypress

Validation

  • just fmt
  • cargo test -p codex-tui keymap_setup::tests::debug_view
  • cargo test -p codex-tui keymap_setup::tests
  • cargo test -p codex-tui slash_keymap
  • cargo test -p codex-tui (unit tests passed; integration test suite::model_availability_nux::resume_startup_does_not_consume_model_availability_nux_count failed locally by itself with codex resume exiting 1 and terminal probe escape output)
  • just fix -p codex-tui
  • just argument-comment-lint
  • cargo insta pending-snapshots
  • git diff --check
@fcoury-oai fcoury-oai merged commit 94800ec into main May 4, 2026
26 checks passed
@fcoury-oai fcoury-oai deleted the debug-keybinding branch May 4, 2026 17:40
@github-actions github-actions Bot locked and limited conversation to collaborators May 4, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

2 participants