Feature request: user-configurable TUI keybindings (~/.claude/keybindings.json)
Open 💬 0 comments Opened Jul 2, 2026 by chirag127
Problem
TUI keybindings are largely fixed. Slash commands help, but there is no user-config layer for TUI actions like scroll, focus, session-switch, plan-toggle, model-cycle, etc. Ref search: no existing "keybindings config" issue found (2026-07-02).
What OpenCode has
~/.config/opencode/tui.json with a leader-key (default ctrl+x, 2000ms timeout) and ~100 documented actions across app/session/model/agent/messages/input/dialog scopes. Ref: https://opencode.ai/docs/keybinds/
Why it matters
Users bounce between CC and other TUIs (tmux, neovim, k9s) with existing muscle memory. Fixed bindings force context switching. Power users (multi-hour sessions) hit action-space friction daily.
Suggested shape
- New
~/.claude/keybindings.json(already stub-referenced bykeybindings-helpskill). - Schema:
{action: "key.chord"}with a documented action registry. - Precedence: user > managed > default. Live-reload on file change (via existing
FileChangedhook).
Thanks for the great work on Claude Code!