Cmd. /keymap
Inspect and remap TUI keyboard shortcuts.
Key takeaways
/keymapedits TUI shortcut bindings by context and action, persisting custom bindings totui.keymapinconfig.toml.- Use it to resolve conflicts with tmux, SSH, VS Code terminal, or JetBrains terminal default bindings.
/keymap debuginspects terminal key events, and modal Vim composer contexts arrived around the 0.129.0 changelog.- Configurable keymaps were added around the 0.128.0 line; key names and contexts can expand by CLI version, so document observed values.
Original Command Declaration
/keymapOfficial Summary
/keymap edits TUI shortcut bindings by context and action, then persists custom bindings to
tui.keymap in config.toml.
Usage
/keymapGood Examples
- Use
/keymapwhen tmux, SSH, VS Code terminal, or JetBrains terminal conflicts with default bindings. - Use
/keymap debugto inspect terminal key events when the changelog-supported debug flow is available. - Review Vim composer contexts before standardizing modal editing shortcuts.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/keymap | Remaps shortcuts | Input or navigation shortcuts conflict |
/statusline | Changes footer items | Visibility fields need adjustment |
/title | Changes terminal title items | Window identification needs adjustment |
Use Cases
- Resolving terminal-specific shortcut conflicts.
- Creating a team keymap convention.
- Auditing modal Vim composer key contexts.
Recent Changes
- Configurable TUI keymaps were added around the 0.128.0 line.
- The 0.129.0 changelog mentions modal Vim composer contexts and
/keymap debug. /keymapis listed in the official slash command table.
Cautions
- Key names and contexts can expand by CLI version; document values observed in the UI.
- Avoid forcing personal preferences as team defaults unless they solve a real conflict.
Release Basis
- Judgment: confirmed addition
- First evidence version:
rust-v0.128.0 - Date (UTC): 2026-04-30
- Release link: https://developers.openai.com/codex/changelog
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex config reference: https://developers.openai.com/codex/config-reference
- Codex changelog: https://developers.openai.com/codex/changelog