feat: improve UX with contextual hints bar and revised keybindings

- Add contextual hints bar at bottom of chat window showing relevant
  keybindings for current panel (Bubble Tea style)
- Revise keybindings to follow Neovim conventions:
  - ]m/[m for message navigation, ]c/[c for code blocks
  - g prefix for toggles (gs, gh, gp, gr, gm, gl, gn, gd)
  - Single keys for actions (y, d, e, r, q)
- Add code block navigation with next/prev functions
- Restrict g-prefix keymaps to normal mode only (fixes typing issues)
- Remove <Esc> close binding to prevent accidental closes
- Add show_hints config option (default: true)
- Update README with new keybindings documentation

Author: jackMort

README.md

@@ -339,29 +339,42 @@ The `display` strategy shows the output in a float window.
 When using `ChatGPT` and `ChatGPTEditWithInstructions`, the following
 keybindings are available:
 
-- `<C-Enter>` [Both] to submit.
-- `<C-y>` [Both] to copy/yank last answer.
-- `<C-o>` [Both] Toggle settings window (read-only).
-- `<C-h>` [Both] Toggle help window.
-- `<Tab>` [Both] Cycle over windows.
-- `<C-f>` [Chat] Cycle over modes (center, stick to right).
-- `<C-c>` [Both] to close chat window.
-- `<C-p>` [Chat] Toggle sessions list.
-- `<C-u>` [Chat] scroll up chat window.
-- `<C-d>` [Chat] scroll down chat window.
-- `<C-k>` [Chat] to copy/yank code from last answer.
-- `<C-n>` [Chat] Start new session.
-- `<C-r>` [Chat] draft message (create message without submitting it to server)
-- `<C-r>` [Chat] switch role (switch between user and assistant role to define a workflow)
-- `<C-s>` [Both] Toggle system message window.
-- `<C-i>` [Edit Window] use response as input.
-- `<C-d>` [Edit Window] view the diff between left and right panes and use diff-mode
-  commands
-- `y` [Chat] Copy code block at cursor.
-- `za` [Chat] Toggle fold for code block.
-- `@` [Chat] Trigger context autocomplete (LSP definitions, project context).
-
-The settings window (`<C-o>`) displays current configuration (model, temperature,
+**Submitting and Closing:**
+- `<C-Enter>` / `<Enter>` Submit prompt
+- `q` Close chat window
+- `<C-c>` Stop generating response
+
+**Navigation:**
+- `]m` / `[m` Navigate to next/previous message
+- `]c` / `[c` Navigate to next/previous code block
+- `<C-u>` / `<C-d>` Scroll chat window up/down
+- `<Tab>` Cycle between windows
+
+**Toggles (g prefix):**
+- `gs` Toggle settings panel (read-only)
+- `gh` Toggle help panel
+- `gp` Toggle sessions panel
+- `gr` Toggle system role window
+- `gm` Toggle message role (user/assistant)
+- `gl` Cycle layout modes (center/right)
+- `gn` Start new session
+- `gd` Draft message (add without sending)
+
+**Actions:**
+- `y` Copy code block at cursor
+- `Y` Copy entire last answer
+- `d` Delete selected message
+- `e` Edit selected message
+- `r` Rename session (in sessions panel)
+- `za` Toggle fold for code block
+- `@` Trigger context autocomplete (LSP, project, file)
+
+**Edit Window specific:**
+- `<C-y>` Accept changes
+- `<C-d>` Toggle diff view
+- `<C-i>` Use response as input
+
+The settings window (`gs`) displays current configuration (model, temperature,
 max_tokens, session name). To change settings, modify your `setup()` configuration.
 
 ### Whichkey plugin mappings

lua/chatgpt.lua

@@ -50,6 +50,11 @@ M.setup = function(options)
   vim.api.nvim_set_hl(0, "ChatGPTSessionHeader", { fg = "#6c7086", bold = true, default = true })
   vim.api.nvim_set_hl(0, "ChatGPTSessionCursor", { fg = "#f9e2af", bold = true, default = true })
 
+  vim.api.nvim_set_hl(0, "ChatGPTHintsBar", { link = "Normal", default = true })
+  vim.api.nvim_set_hl(0, "ChatGPTHintsKey", { fg = "#f9e2af", bold = true, default = true })
+  vim.api.nvim_set_hl(0, "ChatGPTHintsText", { fg = "#6c7086", default = true })
+  vim.api.nvim_set_hl(0, "ChatGPTHintsSep", { fg = "#45475a", default = true })
+
   vim.cmd("highlight default link ChatGPTSelectedMessage ColorColumn")
 
   config.setup(options)

lua/chatgpt/config.lua

@@ -38,6 +38,7 @@ function M.defaults()
       welcome_message = WELCOME_MESSAGE,
       default_system_message = "",
       loading_text = "Loading, please wait ...",
+      show_hints = true,
       question_sign = "", -- 🙂
       answer_sign = "ﮧ", -- 🤖
       border_left_sign = "",
@@ -58,29 +59,30 @@ function M.defaults()
         },
       },
       keymaps = {
-        close = "<C-c>",
-        close_n = "<Esc>",
-        yank_last = "<C-y>",
-        yank_last_code = "<C-k>",
+        close = "q",
+        close_n = nil,
+        yank_last = "Y",
         scroll_up = "<C-u>",
         scroll_down = "<C-d>",
-        new_session = "<C-n>",
+        new_session = "gn",
         cycle_windows = "<Tab>",
-        cycle_modes = "<C-f>",
-        next_message = "<C-j>",
-        prev_message = "<C-k>",
-        select_session = "<Space>",
+        cycle_modes = "gl",
+        next_message = "]m",
+        prev_message = "[m",
+        next_code_block = "]c",
+        prev_code_block = "[c",
+        select_session = "<CR>",
         rename_session = "r",
         delete_session = "d",
-        draft_message = "<C-r>",
+        draft_message = "gd",
         edit_message = "e",
         delete_message = "d",
-        toggle_settings = "<C-o>",
-        toggle_sessions = "<C-p>",
-        toggle_help = "<C-h>",
-        toggle_message_role = "<C-r>",
-        toggle_system_role_open = "<C-s>",
-        stop_generating = "<C-x>",
+        toggle_settings = "gs",
+        toggle_sessions = "gp",
+        toggle_help = "gh",
+        toggle_message_role = "gm",
+        toggle_system_role_open = "gr",
+        stop_generating = "<C-c>",
         yank_code = "y",
         toggle_fold = "za",
       },