refactor: move diff keymaps to LazyVim spec configuration

- Remove hardcoded keymaps from diff.lua
- Add diff keymaps to LazyVim specs in README.md and dev-config.lua
- Update documentation to reflect LazyVim spec configuration approach
- Provide clear examples for customizing diff keymaps
- Maintain backward compatibility with default <leader>da and <leader>dq

This allows users to easily customize or disable diff keymaps by modifying
their LazyVim plugin configuration instead of needing to override hardcoded
keymaps.

Co-authored-by: ThomasK33 <[email protected]>
Signed-off-by: Thomas Kosiewski <[email protected]>

Author: blink-so[bot]

README.md

@@ -61,6 +61,9 @@ Using [lazy.nvim](https://github.com/folke/lazy.nvim):
       desc = "Add file",
       ft = { "NvimTree", "neo-tree", "oil" },
     },
+    -- Diff management
+    { "<leader>da", "<cmd>ClaudeCodeDiffAccept<cr>", desc = "Accept diff" },
+    { "<leader>dq", "<cmd>ClaudeCodeDiffDeny<cr>", desc = "Deny diff" },
   },
 }
 ```
@@ -139,7 +142,7 @@ When Claude proposes changes to your files, the plugin opens a native Neovim dif
 ### Accepting Changes
 
 - **`:w` (save)** - Accept the changes and apply them to your file
-- **`<leader>da`** - Accept the changes using the dedicated keymap
+- **`<leader>da`** - Accept the changes using the dedicated keymap (configured in LazyVim spec)
 
 You can edit the proposed changes in the right-hand diff buffer before accepting them. This allows you to modify Claude's suggestions or make additional tweaks before applying the final version to your file.
 
@@ -148,7 +151,7 @@ Both methods signal Claude Code to apply the changes to your file, after which t
 ### Rejecting Changes
 
 - **`:q` or `:close`** - Close the diff view to reject the changes
-- **`<leader>dq`** - Reject changes using the dedicated keymap
+- **`<leader>dq`** - Reject changes using the dedicated keymap (configured in LazyVim spec)
 - **`:bdelete` or `:bwipeout`** - Delete the diff buffer to reject changes
 
 When you reject changes, the diff view closes and the original file remains unchanged.
@@ -159,12 +162,22 @@ You can also navigate to the Claude Code terminal window and accept or reject di
 
 ### Customizing Diff Keymaps
 
-The default keymaps (`<leader>da` and `<leader>dq`) can be customized by remapping them to the underlying commands:
+The diff keymaps are configured in the LazyVim spec and can be customized by modifying the `keys` table:
 
 ```lua
--- Example: Use different keymaps for diff handling
-vim.keymap.set('n', '<leader>ya', '<cmd>ClaudeCodeDiffAccept<cr>', { desc = 'Accept diff' })
-vim.keymap.set('n', '<leader>yn', '<cmd>ClaudeCodeDiffDeny<cr>', { desc = 'Deny diff' })
+{
+  "coder/claudecode.nvim",
+  config = true,
+  keys = {
+    -- ... other keymaps ...
+    
+    -- Customize diff keymaps to avoid conflicts (e.g., with debugger)
+    { "<leader>ya", "<cmd>ClaudeCodeDiffAccept<cr>", desc = "Accept diff" },
+    { "<leader>yn", "<cmd>ClaudeCodeDiffDeny<cr>", desc = "Deny diff" },
+    
+    -- Or disable them entirely by omitting them from the keys table
+  },
+}
 ```
 
 The commands `ClaudeCodeDiffAccept` and `ClaudeCodeDiffDeny` work only in diff buffers created by the plugin and will show a warning if used elsewhere.

dev-config.lua

@@ -31,6 +31,10 @@ return {
     { "<leader>ai", "<cmd>ClaudeCodeStatus<cr>", desc = "Claude Status" },
     { "<leader>aS", "<cmd>ClaudeCodeStart<cr>", desc = "Start Claude Server" },
     { "<leader>aQ", "<cmd>ClaudeCodeStop<cr>", desc = "Stop Claude Server" },
+
+    -- Diff management (buffer-local, only active in diff buffers)
+    { "<leader>da", "<cmd>ClaudeCodeDiffAccept<cr>", desc = "Accept diff" },
+    { "<leader>dq", "<cmd>ClaudeCodeDiffDeny<cr>", desc = "Deny diff" },
   },
 
   -- Development configuration - all options shown with defaults commented out

lua/claudecode/diff.lua

@@ -583,11 +583,10 @@ function M._create_diff_view_from_window(target_window, old_file_path, new_buffe
   vim.b[new_buffer].claudecode_diff_new_win = new_win
   vim.b[new_buffer].claudecode_diff_target_win = target_window
 
-  local keymap_opts = { buffer = new_buffer, silent = true }
-
-  -- Use the new user commands instead of inline functions
-  vim.keymap.set("n", "<leader>da", "<cmd>ClaudeCodeDiffAccept<cr>", keymap_opts)
-  vim.keymap.set("n", "<leader>dq", "<cmd>ClaudeCodeDiffDeny<cr>", keymap_opts)
+  -- Note: Keymaps for diff accept/deny are now configured in the LazyVim spec
+  -- Users can customize them by adding to their plugin configuration:
+  -- { "<leader>da", "<cmd>ClaudeCodeDiffAccept<cr>", desc = "Accept diff", buffer = true }
+  -- { "<leader>dq", "<cmd>ClaudeCodeDiffDeny<cr>", desc = "Deny diff", buffer = true }
 
   -- Return window information for later storage
   return {