From 06befe1e348bf540bb04a8c0cafe116616e71715 Mon Sep 17 00:00:00 2001
From: Yi Ming <ofseed@foxmail.com>
Date: Fri, 20 Mar 2026 01:47:52 +0800
Subject: [PATCH] feat(defaults): map "grx" to vim.lsp.codelens.run() #37689

Problem
Unlike inlay hints, code lenses are closely related to running commands;
a significant number of code lenses are used to execute a command (such
as running tests). Therefore, it is necessary to provide a default
mapping for them.

Solution
Add a new default mapping "grx" (mnemonic: "eXecute", like "gx").
---
 runtime/doc/lsp.txt                   | 3 ++-
 runtime/doc/news.txt                  | 1 +
 runtime/lua/vim/_core/defaults.lua    | 4 ++++
 test/functional/ex_cmds/help_spec.lua | 2 +-
 4 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/runtime/doc/lsp.txt b/runtime/doc/lsp.txt
index 56d89c2178..938e2df3b0 100644
--- a/runtime/doc/lsp.txt
+++ b/runtime/doc/lsp.txt
@@ -74,7 +74,7 @@ functionality and (2) the options are empty or were set by the builtin runtime
 (ftplugin) files. The options are not restored when the LSP client is stopped
 or detached.
 
-GLOBAL DEFAULTS                       *gra* *gri* *grn* *grr* *grt* *i_CTRL-S*
+GLOBAL DEFAULTS                       *gra* *gri* *grn* *grr* *grt* *grx* *i_CTRL-S*
 
 These GLOBAL keymaps are created unconditionally when Nvim starts:
 
@@ -83,6 +83,7 @@ These GLOBAL keymaps are created unconditionally when Nvim starts:
 - "grn" is mapped to |vim.lsp.buf.rename()|
 - "grr" is mapped to |vim.lsp.buf.references()|
 - "grt" is mapped to |vim.lsp.buf.type_definition()|
+- "grx" is mapped to |vim.lsp.codelens.run()|
 - "gO" is mapped to |vim.lsp.buf.document_symbol()|
 - CTRL-S (Insert mode) is mapped to |vim.lsp.buf.signature_help()|
 - |v_an| and |v_in| fall back to LSP |vim.lsp.buf.selection_range()| if
diff --git a/runtime/doc/news.txt b/runtime/doc/news.txt
index af2d9893cb..bf0363d4a4 100644
--- a/runtime/doc/news.txt
+++ b/runtime/doc/news.txt
@@ -199,6 +199,7 @@ DEFAULTS
   Unset 'exrc' to stop further search.
 • Mappings:
   • |grt| in Normal mode maps to |vim.lsp.buf.type_definition()|
+  • |grx| in Normal mode maps to |vim.lsp.codelens.run()|
 • 'shada' default now excludes "/tmp/" and "/private/" paths to reduce clutter in |:oldfiles|.
 • Enabled treesitter highlighting for Markdown files
 
diff --git a/runtime/lua/vim/_core/defaults.lua b/runtime/lua/vim/_core/defaults.lua
index b8c5daf09b..83fa8ed963 100644
--- a/runtime/lua/vim/_core/defaults.lua
+++ b/runtime/lua/vim/_core/defaults.lua
@@ -209,6 +209,10 @@ do
       vim.lsp.buf.code_action()
     end, { desc = 'vim.lsp.buf.code_action()' })
 
+    vim.keymap.set('n', 'grx', function()
+      vim.lsp.codelens.run()
+    end, { desc = 'vim.lsp.codelens.run()' })
+
     vim.keymap.set('n', 'grr', function()
       vim.lsp.buf.references()
     end, { desc = 'vim.lsp.buf.references()' })
diff --git a/test/functional/ex_cmds/help_spec.lua b/test/functional/ex_cmds/help_spec.lua
index c24a050116..1c55ddf3b0 100644
--- a/test/functional/ex_cmds/help_spec.lua
+++ b/test/functional/ex_cmds/help_spec.lua
@@ -273,7 +273,7 @@ describe(':help', function()
 
     n.command(':help lsp')
     n.feed('gg/codelens.run()|<cr>')
-    eq({ '|vim.lsp.codelens.run()|.', 'lsp.txt' }, buf_word())
+    eq({ '|vim.lsp.codelens.run()|', 'lsp.txt' }, buf_word())
     --             ^ cursor on "codelens"
     n.command(':help!')
     eq({ '*vim.lsp.codelens.run()*', 'lsp.txt' }, buf_word())