C/C++/ObjC language server supporting cross references, hierarchies, completion and semantic highlighting
Go to file
2018-09-20 01:08:31 -07:00
ci Use clang_File_tryGetRealPathName 2018-04-07 16:46:22 -07:00
clang_archive_hashes cmake: for -DSYSTEM_CLANG=off, 6.0.0 -> 6.0.1 2018-07-29 18:02:37 -07:00
cmake Fix compile on Windows + MSYS2-MinGW64 (#46) 2018-08-08 00:25:46 -07:00
index_tests Make $ccls/inheritanceHierarchy and textDocument/typeDefinition find declarations if definitions do not exist; spelling ranges of operator= 2018-09-13 14:55:24 -07:00
src Simplify pipeline and fix race 2018-09-20 01:08:31 -07:00
third_party rapidjson url (#43) 2018-08-03 09:37:31 -07:00
.clang-format First draft: replace libclang indexer with clangIndex 2018-07-07 15:43:05 -07:00
.gitignore . 2018-03-31 00:53:39 -07:00
.gitmodules rapidjson url (#43) 2018-08-03 09:37:31 -07:00
CMakeLists.txt Rename hierarchies to $ccls/{call,inheritance,member} 2018-09-13 14:55:27 -07:00
README.md README 2018-09-02 14:01:28 -07:00

ccls

Telegram Gitter

ccls, which originates from cquery, is a C/C++/Objective-C language server.

It has a global view of the code base and support a lot of cross reference features, see wiki/FAQ. It starts indexing the whole project (including subprojects if exist) parallelly when you open the first file, while the main thread can serve requests before the indexing is complete. Saving files will incrementally update the index.

Compared with cquery, it makes use of C++17 features, has less third-party dependencies and slimmed-down code base. It leverages Clang C++ API as clangd does, which provides better support for code completion and diagnostics. Refactoring and formatting are non-goals as they can be provided by clang-format, clang-include-fixer and other Clang based tools.

The comparison with cquery as noted on 2018-07-15:

cquery ccls
third_party more fewer
C++ C++14 C++17
clang API libclang (C) clang/llvm C++
Filesystem AbsolutePath + custom routines llvm/Support
index libclang clangIndex, some enhancement
pipeline index merge+id remapping simpler and more robust

cquery has system include path detection (through running the compiler driver) while ccls uses clangDriver.

>>> Getting started (CLICK HERE) <<<

ccls can index itself (~180MiB RSS when ide, noted on 2018-09-01), FreeBSD, glibc, Linux, LLVM (~1800MiB RSS), musl (~60MiB RSS), ... with decent memory footprint. See wiki/compile_commands.json for examples.