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 by keybindings-help skill).
  • Schema: {action: "key.chord"} with a documented action registry.
  • Precedence: user > managed > default. Live-reload on file change (via existing FileChanged hook).

Thanks for the great work on Claude Code!

View original on GitHub ↗