hrsh7th
nvim-gtd
Lua

LSP's Go to definition plugin for neovim.

Last updated Mar 31, 2026
46
Stars
5
Forks
1
Issues
0
Stars/day
Attention Score
6
Language breakdown
No language data available.
โ–ธ Files click to expand
README

nvim-gtd

LSP's Go To Definition plugin for neovim.

This plugin is highly experimental. The breaking changes will be applied without notice.

Concept

  • Run textDocument/definition and gf in one mapping.
  • Open the path as much as possible

Usage

---@class gtd.kit.App.Config.Schema
---@field public sources { name: string, option?: table }[] # Specify the source that will be used to search for the definition
---@field public getbufferpath fun(): string # Specify the function to get the current buffer path. It's useful for searching path from terminal buffer etc.
---@field public on_event fun(event: gtd.Event)
---@field public on_context fun(context: gtd.Context) # Modify context on user-land.
---@field public on_cancel fun(params: gtd.Params)
---@field public on_nothing fun(params: gtd.Params)
---@field public on_location fun(params: gtd.Params, location: gtd.kit.LSP.LocationLink)
---@field public on_locations fun(params: gtd.Params, locations: gtd.kit.LSP.LocationLink[])

-- The findup and lsp source are enabled by default (at the moment). require('gtd').setup { ... gtd.kit.App.Config.Schema ... }

vim.keymap.set('n', 'gf<CR>', function() require('gtd').exec({ command = 'edit' }) end) vim.keymap.set('n', 'gfs', function() require('gtd').exec({ command = 'split' }) end) vim.keymap.set('n', 'gfv', function() require('gtd').exec({ command = 'vsplit' }) end)

Sources

The following sources are built-in.

lsp_definition

(Default: enabled)

Find definitions via LSP textDocument/definition.

lsptypedefinition

(Default: enabled)

Find definitions via LSP textDocument/typeDefinition.

lsp_implementation

(Default: enabled)

Find definitions via LSP textDocument/implementation.

findup

(Default: enabled)

Find definitions via vim.fn.findfile with ; flag.

walk

(Default: disabled)

Traverse all filepaths under project.

|option-name|type|description| |-----------|----|-----------| |root_markers|string[]|Specify root markers like { '.git', 'tsconfig.json' }.| |ignorepatterns|string[]|Specify ignore patterns like { '/nodemodules', '/.git' }|

๐Ÿ”— More in this category

ยฉ 2026 GitRepoTrend ยท hrsh7th/nvim-gtd ยท Updated daily from GitHub