{"id":28780163,"url":"https://github.com/romus204/referencer.nvim","last_synced_at":"2026-02-15T19:30:35.124Z","repository":{"id":298167790,"uuid":"999095006","full_name":"romus204/referencer.nvim","owner":"romus204","description":"Lightweight, asynchronous Neovim plugin that uses the LSP to show references to functions, methods, types and other","archived":false,"fork":false,"pushed_at":"2025-11-19T06:25:28.000Z","size":23,"stargazers_count":22,"open_issues_count":1,"forks_count":4,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-11-19T08:20:35.651Z","etag":null,"topics":["neovim","neovim-plugin"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/romus204.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-09T18:20:42.000Z","updated_at":"2025-11-19T06:23:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"fcb921f7-b286-4b16-bd4c-6831df960aa0","html_url":"https://github.com/romus204/referencer.nvim","commit_stats":null,"previous_names":["romus204/referencer.nvim"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/romus204/referencer.nvim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romus204%2Freferencer.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romus204%2Freferencer.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romus204%2Freferencer.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romus204%2Freferencer.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/romus204","download_url":"https://codeload.github.com/romus204/referencer.nvim/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romus204%2Freferencer.nvim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29487448,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T19:29:10.908Z","status":"ssl_error","status_checked_at":"2026-02-15T19:29:10.419Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["neovim","neovim-plugin"],"created_at":"2025-06-17T18:02:46.270Z","updated_at":"2026-02-15T19:30:35.119Z","avatar_url":"https://github.com/romus204.png","language":"Lua","readme":"# referencer.nvim\n\n`referencer.nvim` is a lightweight, asynchronous Neovim plugin written in Lua that uses the built-in LSP to show the number of references to functions, methods, types, or other symbols directly in the buffer using virtual text.\n\nThis is especially useful for quickly understanding code usage without manually invoking LSP commands.\n\n---\n## Preview\n\nhttps://github.com/user-attachments/assets/1b6351c8-407b-4ed4-846e-dc6cef817219\n\n---\n\n## Features\n\n- ✨ **Asynchronous**: non-blocking usage count queries using built-in LSP.\n- 👁️ Displays number of references next to functions, methods, structs, etc.\n- ⚖️ Fully configurable highlight groups and colors.\n- 💪 Works with any LSP that supports `textDocument/references` and `textDocument/documentSymbol`.\n- ⚖️ On-demand or auto-triggered via `LspAttach` event.\n\n---\n\n## Installation\n\nWith [lazy.nvim](https://github.com/folke/lazy.nvim):\n\n```lua\n{\n    \"romus204/referencer.nvim\",\n    config = function()\n        require(\"referencer\").setup()\n    end\n}\n```\n\nWith [packer.nvim](https://github.com/wbthomason/packer.nvim):\n\n```lua\nuse {\n    \"romus204/referencer.nvim\",\n    config = function()\n        require(\"referencer\").setup()\n    end\n}\n```\n\n---\n\n## Default configuration\n\n```lua\nrequire(\"referencer\").setup({\n    enable = false,                      -- enable after LSP attach\n    format = \"  %d reference(s)\",       -- format string for reference count\n    show_no_reference = true,            -- show if refs count = 0\n    kinds = { 5, 6, 8, 12, 13, 14, 23, } -- LSP SymbolKinds to show references for\n    hl_group = \"Comment\",                -- default highlight group\n    color = nil,                         -- optional custom color (overrides hl_group)\n    virt_text_pos = \"eol\",               -- virtual text position (eol | overlay | right_align)\n    pattern = nil,                       -- pattern for LspAttach autocmd to auto-enable\n    lsp_servers = {}                     -- list of servers for which this plugin will be active. nil or {} is ALL LSP clients\n\n})\n```\n\n## Configuration example\n\n```lua\nrequire(\"referencer\").setup({\n    enable = true,\n    format = \"  %d ref\",\n    show_no_reference = true,\n    kinds = { 12, 6, 5, 23, 8 },\n    hl_group = \"Comment\",\n    color = \"#FFA500\",\n    virt_text_pos = \"eol\",\n    pattern = {\"*.go\", \"*.py\"},\n    lsp_servers = {'gopls', 'pyright'}\n\n})\n```\n\n### `kinds`\n\nA list of LSP `SymbolKind` numeric values. Some common kinds:\n\n\tFile = 1;\n\tModule = 2;\n\tNamespace = 3;\n\tPackage = 4;\n\tClass = 5;\n\tMethod = 6;\n\tProperty = 7;\n\tField = 8;\n\tConstructor = 9;\n\tEnum = 10;\n\tInterface = 11;\n\tFunction = 12;\n\tVariable = 13;\n\tConstant = 14;\n\tString = 15;\n\tNumber = 16;\n\tBoolean = 17;\n\tArray = 18;\n\tObject = 19;\n\tKey = 20;\n\tNull = 21;\n\tEnumMember = 22;\n\tStruct = 23;\n\tEvent = 24;\n\tOperator = 25;\n\tTypeParameter = 26;\n\n\nFull list: [LSP Specification - SymbolKind](https://microsoft.github.io/language-server-protocol/specifications/specification-current/#symbolkind)\n\n---\n\n## Commands\n\n| Command             | Description                         |\n| ------------------- | ----------------------------------- |\n| `:ReferencerToggle` | Toggle reference display on/off         |\n| `:ReferencerUpdate` | Force refresh reference information in current buffer  |\n","funding_links":[],"categories":["LSP"],"sub_categories":["(requires Neovim 0.5)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fromus204%2Freferencer.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fromus204%2Freferencer.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fromus204%2Freferencer.nvim/lists"}