{"id":13898371,"url":"https://github.com/sebdah/vim-delve","last_synced_at":"2025-04-05T21:11:43.928Z","repository":{"id":22484421,"uuid":"96383856","full_name":"sebdah/vim-delve","owner":"sebdah","description":"Neovim / Vim integration for Delve","archived":false,"fork":false,"pushed_at":"2022-12-13T10:09:48.000Z","size":8895,"stargazers_count":507,"open_issues_count":12,"forks_count":23,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-29T20:09:13.115Z","etag":null,"topics":["debugging","delve","go","golang","neovim","vim","vim-delve"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","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/sebdah.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-06T03:19:37.000Z","updated_at":"2025-03-25T06:00:08.000Z","dependencies_parsed_at":"2023-01-12T03:30:35.048Z","dependency_job_id":null,"html_url":"https://github.com/sebdah/vim-delve","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebdah%2Fvim-delve","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebdah%2Fvim-delve/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebdah%2Fvim-delve/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebdah%2Fvim-delve/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sebdah","download_url":"https://codeload.github.com/sebdah/vim-delve/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399886,"owners_count":20932880,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["debugging","delve","go","golang","neovim","vim","vim-delve"],"created_at":"2024-08-06T18:04:15.879Z","updated_at":"2025-04-05T21:11:43.899Z","avatar_url":"https://github.com/sebdah.png","language":"Vim Script","funding_links":[],"categories":["Vim Script"],"sub_categories":[],"readme":"vim-delve\n=========\n\nThis is a Neovim and Vim plugin for debugging [Go](https://golang.org)\napplications using [Delve](https://github.com/go-delve/delve). The project\nworks a lot nicer on Neovim with the built-in terminal, so that's what we\nrecommend. But it is decent to work with on Vim if you have\n[Shougo/vimshell.vim](https://github.com/Shougo/vimshell.vim) installed.\n\n*If you like this project, please star it. If you feel even more generous,\nplease follow [@sebdah](https://twitter.com/sebdah) on Twitter!*\n\nFeature highlights\n------------------\n\n- Go syntax highlighting of debug output (only Neovim)\n- Supports both breakpoints and tracepoints\n- Run the Delve debugger in a split view along side your code\n- Launches a Delve CLI, so all commands are supported in there\n- Leverages the Neovim terminal (only on Neovim)\n- Supports `main` as well as and non-`main` packages\n- Supports [vimux](https://github.com/benmills/vimux) optionally\n\n![animated example](https://github.com/sebdah/vim-delve/raw/master/vim-delve-demo.gif \"vim-delve demo\")\n\nRequirements\n------------\n\nFor Neovim and Vim 8, you really only need Delve to get started.\n\n- [Delve](https://github.com/go-delve/delve)\n\nIf you wish to use the vimux support, you'd need to have this plugin as well:\n\n- [benmills/vimux](https://github.com/benmills/vimux)\n\n### Requirements for Vim 7 and earlier\n\nIf you are on Vim versions older than 8, you'll also need the following two packages:\n\n- [Shougo/vimshell.vim](https://github.com/Shougo/vimshell.vim)\n- [Shougo/vimproc.vim](https://github.com/Shougo/vimproc.vim)\n\nInstallation\n------------\n\nUsing `vim-plug`, add the following to your `init.vim` if you're on Neovim or\n`.vimrc`, if you're on vim:\n\n`Plug 'sebdah/vim-delve'`\n\nThen reload neovim and run `PlugInstall`.\n\nCommands\n--------\n\n| Command                        | Comment\n|--------------------------------|-----------------------------------------------------------------------------------\n| `DlvAddBreakpoint`             | Add a breakpoint at the current line.\n| `DlvAddTracepoint`             | Add a tracepoint at the current line.\n| `DlvAttach \u003cpid\u003e [flags]`      | Attach `dlv` to a running process.\n| `DlvClearAll`                  | Clear all the breakpoints and tracepoints in the buffer.\n| `DlvCore \u003cbin\u003e \u003cdump\u003e [flags]` | Debug core dumps using `dlv core`.\n| `DlvConnect host:port [flags]` | Connect to a remote Delve server on the given host:port.\n| `DlvDebug [flags]`             | Run `dlv debug` for the current session. Use this to test `main` packages.\n| `DlvExec \u003cbin\u003e [flags]`        | Start `dlv` on a pre-built executable.\n| `DlvRemoveBreakpoint`          | Remove the breakpoint at the current line.\n| `DlvRemoveTracepoint`          | Remove the tracepoint at the current line.\n| `DlvTest [flags]`              | Run `dlv test` for the current session. Use this to debug non-`main` packages.\n| `DlvTestCurrent [flags]`     | Run `dlv test` for the current test or function. Use this to debug non-`main` packages.\n| `DlvToggleBreakpoint`          | Convenience method to toggle (add or remove) a breakpoint at the current line.\n| `DlvToggleTracepoint`          | Convenience method to toggle (add or remove) a tracepoint at the current line.\n| `DlvVersion`                   | Print the `dlv` version.\n\nConfiguration\n-------------\n\n| Setting                              | Default value                                         | Comment\n|--------------------------------------|-------------------------------------------------------|-----------------------\n| `g:delve_backend`                    | `default`                                             | Defines the backend to use with Delve. Please refer to the [Delve documentation](https://github.com/go-delve/delve/blob/master/Documentation/usage/dlv.md#options) for details on what you should set this value to.\n| `g:delve_sign_group`                 | `delve`                                               | Set the sign group.\n| `g:delve_sign_priority`              | 10                                                    | Set the sign priority.\n| `g:delve_breakpoint_sign_highlight`  | `WarningMsg`                                          | Set the color profile for the sign.\n| `g:delve_breakpoint_sign`            | `●`                                                   | Sets the sign to use to indicate breakpoints in the gutter.\n| `g:delve_tracepoint_sign_highlight`  | `WarningMsg`                                          | Set the color profile for the sign.\n| `g:delve_tracepoint_sign`            | `◆`                                                   | Sets the sign to use to indicate tracepoints in the gutter.\n| `g:delve_cache_path`                 | `$HOME . \"/.cache/\" . v:progname . \"/vim-delve\"`      | The path to where the instructions file for `dlv` is stored.\n| `g:delve_instructions_file`          | `g:delve_cache_path .\"/\". getpid() .\".\". localtime()` | The instructions file name.\n| `g:delve_enable_syntax_highlighting` | `1`                                                   | Turn syntax highlighting in the `dlv` output on or off.\n| `g:delve_enable_linenr_highlighting` | `0`                                                   | Turn line number highlighting on or off.\n| `g:delve_new_command`                | `vnew`                                                | Control if `dlv` should be opened in a vertical (`vnew`), horizontal (`new`), full screen window (`enew`) or full screen window in new tab(`tabnew`).\n| `g:delve_use_vimux      `            | `0`                                                   | Sets whether to use [benmills/vimux](https://github.com/benmills/vimux)].\n| `g:delve_project_root`               |                                                       | Override the path to use for setting breakpoints/tracepoints.\n\nThe settings above can be set in your `init.vim` like this:\n\n```\nlet g:delve_backend = \"native\"\n```\n\nFrequently Asked Questions\n--------------------------\n\n**Got an error about `lldb-server` on Mac OS X**\n\nIf you get a message like the one below on Mac OS X, try setting\n`g:delve_backend` to `native`.\n\n```\ncould not launch process: exec: \"lldb-server\": executa ble file not found in $PATH\n```\n\nExample: `let g:delve_backend = \"native\"`\n\nContributing to vim-delve\n-------------------------\n\nContributions to the project is most welcome. I'd be happy to review and merge\npull requests. If you need any directions in your implementation we can always\ndiscuss that too.\n\n### What can I do to help?\n\nThere are many things that this project need, but some examples could be:\n\n- I don't know if this works on Windows. If you could try it out and or make it\n    work that would be great.\n- I haven't tested the project thoroughly on Vim, if you could do that it'd be\n    wonderful.\n- Answer [questions from users](https://github.com/sebdah/vim-delve/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)\n- Or implement [new features](https://github.com/sebdah/vim-delve/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement)\n\nLicense\n-------\n\nMIT Licensed software.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebdah%2Fvim-delve","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsebdah%2Fvim-delve","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebdah%2Fvim-delve/lists"}