# Install compiledb with Homebrew, Nix

Generate a Clang compilation database for Make-based build systems. Version 0.10.7 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:compiledb
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install compiledb
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#compiledb
```

  Evidence: nixpkgs package indexes: pkgs/by-name/co/compiledb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:compiledb
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/compiledb>
- **Version:** 0.10.7
- **Source summary:** Generate a Clang compilation database for Make-based build systems
- **Homepage:** <https://github.com/nickdiego/compiledb>
- **Repository:** <https://github.com/nickdiego/compiledb>
- **Upstream docs:** <https://github.com/nickdiego/compiledb#readme>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://files.pythonhosted.org/packages/0e/62/d0fc807871757841c32e6fbe433ebad422528a468336a0cf82fea226f41d/compiledb-0.10.7.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- compiledb (cli)
- compiledb (alias)

## Dependencies

- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.10.7
- Local data: ok
- Upstream repository: https://github.com/nickdiego/compiledb
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

compiledb is a Python CLI for generating Clang JSON compilation databases for GNU Make-based build systems.

### Project history

The official README says compiledb was written to index Android Open Source Project modules after the author found existing tools unsatisfactory. It reworked ideas from YCM-Generator and aimed to produce `compile_commands.json` quickly without always requiring a clean build, using Make dry-run and keep-going behavior to extract compile commands.

### Adoption history

PyPI records public compiledb releases starting in 2018. The Homebrew input records both Homebrew and Nix packaging, reflecting its role as a small command-line bridge between traditional Make projects and Clang-aware editor or language-server tooling.

### How it is used

compiledb can wrap `make`, parse build logs or stdin, and write Clang's `compile_commands.json` in arguments-list or command-string form. Its main audience is non-CMake projects that still want editor indexing, static analysis, or language-server support.

### Why package nerds care

The package is significant because `compile_commands.json` became a de facto interchange file for C and C++ tooling. compiledb gives Make-based projects a lightweight way to participate in that ecosystem without migrating their build system.

### Timeline

- 2018: PyPI records the first public compiledb release.
- 2025: PyPI and GitHub releases record 0.10.x releases.

### Related projects

- compiledb is related to Clang's JSON Compilation Database format, Bear, YCM-Generator, cquery, ccls, and editor tooling such as YouCompleteMe.

### Sources

- <https://github.com/nickdiego/compiledb>
- <https://raw.githubusercontent.com/nickdiego/compiledb/master/README.md>
- <https://pypi.org/pypi/compiledb/json>
- <https://clang.llvm.org/docs/JSONCompilationDatabase.html>


## Security Notes

broad file, network, media, or database tool signal. generalized runtime or code generation signal.

- **Geiger risk:** yellow / medium
- broad file, network, media, or database tool signal
- generalized runtime or code generation signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** compiledb
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - compiledb: normalized package name match | nixpkgs package indexes: pkgs/by-name/co/compiledb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/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.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [colormake](https://www.automicvault.com/pkg/brew/colormake/) - Shares av.db curated category or tags: build-tools, cli, developer-tools, make.
- [bmake](https://www.automicvault.com/pkg/brew/bmake/) - Shares av.db curated category or tags: build-tools, cli, developer-tools, make.
- [ccache](https://www.automicvault.com/pkg/brew/ccache/) - Shares av.db curated category or tags: build-tools, clang, cli, developer-tools.
- [clang-build-analyzer](https://www.automicvault.com/pkg/brew/clang-build-analyzer/) - Shares av.db curated category or tags: build-tools, clang, cli, developer-tools.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Shares av.db curated category or tags: build-tools, cli, developer-tools, make.
- [crosstool-ng](https://www.automicvault.com/pkg/brew/crosstool-ng/) - Shares av.db curated category or tags: build-tools, cli, developer-tools.
- [fobis](https://www.automicvault.com/pkg/brew/fobis/) - Shares av.db curated category or tags: build-tools, cli, developer-tools, python.
- [fypp](https://www.automicvault.com/pkg/brew/fypp/) - Shares av.db curated category or tags: build-tools, cli, developer-tools, python.
- [distcc](https://www.automicvault.com/pkg/brew/distcc/) - Both packages touch the same language runtime or ecosystem. Shared terms: build, build-tools, cli, compilation, developer.
- [python-build](https://www.automicvault.com/pkg/brew/python-build/) - Both packages touch the same language runtime or ecosystem. Shared terms: build, build-tools, cli, developer, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/compiledb.yml](https://github.com/automic-vault/db/blob/main/combined/compiledb.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- 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
