# Install ccls with Homebrew, apk, apt, MacPorts, Nix, pacman, zypper C/C++/ObjC language server. Version 0.20250815.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:ccls ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install ccls ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install ccls ``` Evidence: MacPorts ports tree: devel/ccls/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add ccls ``` Evidence: Alpine Linux edge package indexes: ccls from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install ccls ``` Evidence: Debian stable package indexes: ccls from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#ccls ``` Evidence: nixpkgs package indexes: pkgs/by-name/cc/ccls/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S ccls ``` Evidence: Arch Linux sync databases: ccls from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install ccls ``` Evidence: openSUSE Tumbleweed package metadata: ccls from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:ccls - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.20250815.1 - **Source summary:** C/C++/ObjC language server - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - ccls (cli) - ccls (alias) ## Dependencies - llvm ## Build dependencies - cmake - rapidjson ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.20250815.1 - Local data: ok - Upstream repository: https://github.com/MaskRay/ccls - Upstream latest detected: 0.20250815.1 (current) - info: No package-manager update timestamp was available. ## Project history and usage ccls is a C, C++, and Objective-C language server. Its README says it originates from cquery and supports completion, cross references, hierarchies, formatting, diagnostics, semantic highlighting, and whole-project indexing. ### Project history The official GitHub repository was created in March 2018. The README explicitly frames ccls as originating from cquery, another C/C++ language-server project, and describes ccls' distinguishing emphasis on indexing the whole project while serving requests before indexing is complete. ### Adoption history The supplied package facts show ccls packaged broadly across Alpine, Homebrew, Debian, MacPorts, Nix, Arch, Ubuntu, and openSUSE. That spread reflects language-server adoption by editors and distributions after the Language Server Protocol became common infrastructure. ### How it is used A typical ccls setup gives the server a project-root compile_commands.json generated by the build system, or a project-root .ccls file containing compiler flags. Editors then speak LSP to ccls for code completion, navigation, references, diagnostics, and semantic highlighting. ### Why package nerds care ccls is significant because it packages a clang-based language server as a standalone system dependency instead of binding users to one editor extension. For package managers, it is the sort of developer-tool daemon that makes editor integrations reproducible across machines. ### Timeline - 2018: GitHub repository created. - 2018: README documents ccls as originating from cquery and able to index itself, FreeBSD, glibc, Linux, LLVM, and musl. - 2025: GitHub tags show continued dated releases. ### Related projects - The README names cquery as the origin project and relies on clang-style compilation databases such as compile_commands.json. ### Sources - - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: /compile_commands.json, /.ccls ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** ccls - **Version Scheme:** 0 - **Revision:** 1 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - ccls - 0.20241108-1: normalized package name match | Debian stable package indexes: ccls from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | C/C++/ObjC language server | https://github.com/MaskRay/ccls - Nix - ccls: normalized package name match | nixpkgs package indexes: pkgs/by-name/cc/ccls/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - ccls - 0.20240202-1: normalized package name match | Ubuntu 24.04 LTS package indexes: ccls from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | C/C++/ObjC language server | https://github.com/MaskRay/ccls - apk - ccls - 0.20250815.1-r1: normalized package name match | Alpine Linux edge package indexes: ccls from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | C/C++/Objective-C language server | https://github.com/MaskRay/ccls - pacman - ccls - 0.20250815.1-2: normalized package name match | Arch Linux sync databases: ccls from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | C/C++/ObjC language server supporting cross references, hierarchies, completion and semantic highlighting | https://github.com/MaskRay/ccls - zypper - ccls - 0.20250815.1-2.2: normalized package name match | openSUSE Tumbleweed package metadata: ccls from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | C/C++/ObjC language server | https://github.com/MaskRay/ccls - MacPorts - ccls: normalized package name match | MacPorts ports tree: devel/ccls/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [llvm](https://www.automicvault.com/pkg/brew/llvm/) - Runtime dependency declared by Homebrew. - [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew. - [purescript-language-server](https://www.automicvault.com/pkg/brew/purescript-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, language-server-protocol. - [sql-language-server](https://www.automicvault.com/pkg/brew/sql-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, language-server-protocol. - [yaml-language-server](https://www.automicvault.com/pkg/brew/yaml-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, language-server-protocol. - [aarch64-elf-gcc](https://www.automicvault.com/pkg/brew/aarch64-elf-gcc/) - Shares av.db curated category or tags: c, c-plus-plus, cli, developer-tools. - [ansible-language-server](https://www.automicvault.com/pkg/brew/ansible-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server. - [astyle](https://www.automicvault.com/pkg/brew/astyle/) - Shares av.db curated category or tags: c, c-plus-plus, cli, developer-tools. - [bash-language-server](https://www.automicvault.com/pkg/brew/bash-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server. - [build2](https://www.automicvault.com/pkg/brew/build2/) - Shares av.db curated category or tags: c, c-plus-plus, cli, developer-tools. - [crystalline](https://www.automicvault.com/pkg/brew/crystalline/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, developer, developer-tools, language, language-server. ## Combined YAML source View the package source record on GitHub. [combined/ccls.yml](https://github.com/automic-vault/db/blob/main/combined/ccls.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph