clice README

README проекта с github.com/clice-io/clice. Одним файлом markdown: README.md.

clice

clice

C++ Standard GitHub license CI Documentation Discord

A C/C++ language server written in modern C++, and more than a language server. Like clangd and ccls it is built on LLVM/Clang, but it is redesigned from the ground up to solve the problems their architecture has left unsolved for years. See What is clice?

The story behind clice and how it was built: clice v1.0 Released: Welcome to Modern C++.

Language Server

Command Line

The same engine answers from the command line:

Built with Modern C++

Getting Started

Install

Download the latest binary from the releases page, or build from source.

Platforms: Linux (x64, ARM64), macOS (x64, ARM64), Windows (x64, ARM64)

Release channels:

Channel Version Where to get it
Stable even minor, e.g. v1.0.0 releases page + VS Code Marketplace + Open VSX
Nightly odd minor, e.g. v1.1.2026112002 GitHub pre-releases + Marketplace and Open VSX pre-release channel (Switch to Pre-Release Version on the extension page)
Per-commit untagged artifacts on the latest green main CI runs

The versioning rule is the VS Code Marketplace convention: even minor = stable, odd minor = pre-release. Nightly patch numbers encode the UTC build time as YYYYMMDDHH (year, month, day, hour — e.g. 2026071902 is 2026-07-19 02:00 UTC), so newer is always higher; a nightly is published only when main gained commits, and only the newest 25 nightlies, none older than 30 days, are kept, besides the one Neovim's Mason registry installs. Every published binary is the exact one that passed the full test suites — releases promote CI builds rather than rebuilding.

For the freshest bits, every green main CI run attaches installable artifacts (binaries and platform vsix) to its run page, so a fix can be tried the moment it merges (GitHub login required for artifact downloads).

Each release also ships *.symbols packages: if clice crashes, attach the newest server log to an issue and the matching symbols let us reconstruct the exact stack. The log location is printed at startup in your editor's clice output panel (Session log directory: — by default under <workspace>/.clice/logs/).

Editor Setup

Editor Setup
VS Code Install the clice extension from the Marketplace
Cursor, VSCodium, Windsurf Install the clice extension from Open VSX
Neovim With nvim-lspconfig on Neovim 0.11 or later: vim.lsp.enable('clice')
Zed Load editors/zed as a local extension
Other Any LSP client works — point it at clice serve

Project Setup

clice reads a compilation database to understand your project. For CMake:

cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON

By default clice loads every compile_commands.json in the project root and its immediate subdirectories (e.g. build/). See project setup for other build systems, and the configuration guide for databases elsewhere and files without one.

[!NOTE] clice 1.0 is its first stable release. Bug reports via issues are welcome.

Documentation

Full docs at docs.clice.io/clice: the guide and configuration, every language feature and command, and the design.

Contributing

See building from source or join our Discord.

bazel build //:dist   # clice and the unit tests
pixi run test         # the unit tests and the cases

clice (clice-io/clice)

Ищем в базе…

1.8K ·GitHub
Что это такое?clice — это языковой сервер для C, C++, Objective-C и CUDA, построенный на Clang и LLVM. Он написан на современном C++ и также включает инструмент командной строки, который использует тот же движок.
Это плагин для редактора или инструмент командной строки?И то, и другое. Редакторы подключаются к нему как к языковому серверу, а тот же движок запускается и из командной строки, чтобы индексировать, искать, проверять линтером, форматировать и рефакторить целые проекты.
Как это запустить?Скачайте бинарный файл со страницы релизов или установите расширение clice из VS Code Marketplace или Open VSX. В Neovim 0.11+ с nvim-lspconfig вызовите vim.lsp.enable('clice'). Другие LSP-клиенты могут использовать 'clice serve'.
Нужно ли что-то особенное от моего проекта?Обычно нужен только compilecommands.json. По умолчанию загружаются все файлы compilecommands.json из корня проекта и его непосредственных подкаталогов, например build/.
Он уже стабилен?Да, 1.0 — первый стабильный релиз. Чётные минорные версии, например v1.0.0, стабильны, а нечётные, например v1.1.x, — это ночные предрелизы. Сообщения об ошибках принимаются через GitHub issues.
Какие операционные системы и процессоры поддерживаются?Linux, macOS и Windows, для x64 и ARM64.
Чем он отличается от clangd и ccls?Его переработали с нуля, чтобы изолировать сбои. Компиляция выполняется в пуле рабочих процессов, поэтому сбой стоит одного процесса, а не всего сервера. Также добавлена поддержка именованных модулей C++20 и контекстов компиляции для заголовочных файлов.
Поддерживает ли он модули C++20?Да. Он поддерживает полные именованные модули C++20 из compilecommands.json, сканирует зависимости и собирает нужные модули по требованию, а также повторно использует кэши PCH и PCM между сессиями.
Что ещё умеет CLI помимо работы с редактором?clice index заранее строит индекс проекта, query возвращает определения, ссылки и графы вызовов в виде JSON, а refactor переименовывает символы во всём проекте. analyze и modularize помогают переносить код в модули C++20.
Зачем автор его создал?Автор говорит, что clangd и ccls годами не решали архитектурных проблем, поэтому clice переписали с нуля на LLVM и Clang, чтобы их устранить.
Какие есть похожие проекты?YouCompleteMe, cppinsights, zenc-lang, compiler, scriptc, emscripten, rust-analyzer, cvise
Автор
clice-io
Размер
25.8 MB
Звёзды
1.8K
Возраст
2 г
Коммиты · 90 дней