coc-clangd

clangd

clangd extension for coc.nvim

Installation CommandVim prompt

:CocInstall coc-clangd

GitHub owner

clangd

Version

v0.33.0

npm package

coc-clangd

Requirements

coc ^0.0.80

License

Apache-2.0 WITH LLVM-exception

Repository

GitHub

npm latest published 2026-05-11Registry checked 2026-08-23Registry summary

Published Package Summary

coc-clangd

This extension connects coc.nvim to the clangd language server.

Quick Start

install Node.js. coc.nvim and coc-clangd run on Node.js.
install coc.nvim. Instructions using vim-plug (check out coc.nvim Wiki other options):
- add to .vimrc: vim Plug 'neoclide/coc.nvim', {'branch': 'release'}
- in vim, run :PlugInstall
in vim, run :CocInstall coc-clangd
coc-clangd will try to find clangd from your $PATH, if not found, you can run :CocCommand clangd.install to install the latest release from GitHub
follow Project setup to generate compile_commands.json for your project

Note: If you've configured clangd as a languageServer in coc-settings.json, you should remove it to avoid running clangd twice!

Protocol extensions

clangd supports some extensions that are not in the official Language Server Protocol specification.

coc-clangd adds support for:

Switching between header and implementation file: :CocCommand clangd.switchSourceHeader
- You can open in split buffer by :CocCommand clangd.switchSourceHeader vsplit
File status monitor, shows on NeoVim statusline
Describe symbol under the cursor: :CocCommand clangd.symbolInfo
Completions that adjust text near the cursor (e.g. correcting . to ->)

Configurations

:CocConfig opens your global coc-settings.json. :CocLocalConfig opens local configuration for your project ($PROJECTROOT/.vim/coc-settings.json)

Configurations	Description	Default
clangd.enabled	enable `coc-clangd`	`true`
clangd.arguments	arguments for `clangd` server	`[]`
clangd.checkUpdates	check for clangd language server updates on startup	`false`
clangd.disableCompletion	disable completion source from clangd	`false`
clangd.disableDiagnostics	disable diagnostics from clangd	`false`
clangd.disableSnippetCompletion	disable completion snippet from clangd	`false`
clangd.disableProgressNotifications	disable indexing progress notifications from clangd	`false`
clangd.compilationDatabasePath	specifies the directory containing the compilation database	`''`
clangd.compilationDatabaseCandidates	specifies directories that may contain the compilation database, you can use `${workspaceFolder}` variables https://code.visualstudio.com/docs/editor/variables-reference	`[]`
clangd.fallbackFlags	extra clang flags used to parse files when no compilation database is found	`[]`
clangd.path	path to `clangd` executable	`clangd`

Note:

Semantic highlighting is disabled by default in coc.nvim, you can enable it with semanticTokens.enable.

License

Apache 2.0 with LLVM Exception

This is the standard LLVM license.

This extension is built with create-coc-extension

Read the complete README

clangd extension for coc.nvim

Activation Events

onLanguage:c
onLanguage:cpp
onLanguage:cuda
onLanguage:objc
onLanguage:objcpp
onLanguage:opencl
onLanguage:objective-c
onLanguage:objective-cpp

Developer Resources

Want to build, test, or contribute to coc.nvim extensions? Explore our official SDK and testing toolkits.

Open Developer Guide

This published npm package does not include a history.md or changelog.md file. Browse its npm versions or repository releases for available release information.

All contributes.commands entries from the published package manifest for coc-clangd@0.33.0.

Command (:CocCommand)	Description
clangd.ast	Show AST
clangd.switchSourceHeader	Switch between source/header
clangd.symbolInfo	Resolve symbol info under the cursor
clangd.memoryUsage	Show memory usage
clangd.projectConfig	Open project configuration file
clangd.userConfig	Open user configuration file
clangd.install	Install latest clangd language server binary release
clangd.update	Check for updates to clangd language server

All contributes.configuration entries from the published package manifest, including each raw property schema for coc-settings.json.

clangd.pathstring

The path to clangd executable, e.g.: /usr/bin/clangd

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "The path to clangd executable, e.g.: /usr/bin/clangd"
}

clangd.enabledboolean

Enable coc-clangd extension

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Enable coc-clangd extension"
}

clangd.argumentsarray

Arguments for clangd server

Default: []

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "string"
  },
  "default": [],
  "description": "Arguments for clangd server"
}

clangd.trace.filestring

Names a file that clangd should log a performance trace to, in chrome trace-viewer JSON format, can be loaded in `chrome://tracing`.

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "Names a file that clangd should log a performance trace to, in chrome trace-viewer JSON format, can be loaded in `chrome://tracing`."
}

clangd.checkUpdatesboolean

Check for clangd language server updates on startup.

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Check for clangd language server updates on startup."
}

clangd.trace.serverstring

Trace requests to clangd

Default: "off"

Raw JSON Schema

{
  "enum": [
    "off",
    "messages",
    "verbose"
  ],
  "type": "string",
  "default": "off",
  "description": "Trace requests to clangd"
}

clangd.fallbackFlagsarray

Extra clang flags used to parse files when no compilation database is found.

Default: []

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "string"
  },
  "default": [],
  "description": "Extra clang flags used to parse files when no compilation database is found."
}

clangd.disableCompletionboolean

Disable completion source from clangd

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Disable completion source from clangd"
}

clangd.disableFileStatusboolean

Disable fileStatus from clangd

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Disable fileStatus from clangd"
}

clangd.disableDiagnosticsboolean

Disable diagnostics from clangd

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Disable diagnostics from clangd"
}

clangd.compilationDatabasePathstring

Specifies the directory containing the compilation database

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "Specifies the directory containing the compilation database"
}

clangd.disableSnippetCompletionboolean

Disable completion snippet from clangd

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Disable completion snippet from clangd"
}

clangd.showDBChangedNotificationboolean

Show notifications while DB files changed

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Show notifications while DB files changed"
}

clangd.disableProgressNotificationsboolean

Disable indexing progress notifications from clangd

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Disable indexing progress notifications from clangd"
}

clangd.compilationDatabaseCandidatesarray

Specifies the directories that may contain a compilation database

Default: []

Raw JSON Schema

{
  "type": "array",
  "default": [],
  "description": "Specifies the directories that may contain a compilation database"
}

coc-clangd

Published Package Summary

coc-clangd

Quick Start

Protocol extensions

Configurations

License

Version History

Contributed Commands

Configuration Schema