# Install chdig with Homebrew, scoop Dig into ClickHouse with TUI interface. Version 26.6.1 via Homebrew; verified 2026-06-17. ## Install ```sh sudo av install brew:chdig ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install chdig ``` Evidence: local Homebrew formula metadata ### Windows - Scoop (92%): ```sh scoop install extras/chdig ``` Evidence: Scoop official bucket manifest trees: bucket/chdig.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:chdig - **Package manager:** Homebrew - **Package manager page:** - **Version:** 26.6.1 - **Source summary:** Dig into ClickHouse with TUI interface - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-17T00:03:02Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - chdig (cli) - chdig (alias) ## Build dependencies - rust ## 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: 26.6.1 - Package-manager updated: 2026-06-17 - Local data: ok - Upstream repository: https://github.com/azat/chdig - Upstream latest detected: v26.6.1 (current) ## Project history and usage chdig is a Rust terminal UI for inspecting ClickHouse systems, positioned by its README as a ClickHouse-oriented cousin of top or csysdig for database introspection. ### Project history The repository was created in January 2023 by Azat Khuzhin. The README traces the idea to everyday ClickHouse debugging work and to a 2022 "Know Your ClickHouse" presentation that collected ClickHouse introspection tools before the project became an interactive TUI. ### Adoption history The project remains niche and ClickHouse-specific, but its own README documents standalone Linux and macOS binaries, deb/rpm/tar.gz artifacts, AUR packages, Scoop, Homebrew, and availability through ClickHouse as `clickhouse chdig`. ### How it is used Users run chdig against ClickHouse to browse server and query state, use flamegraph and Perfetto-oriented views, inspect logs and query pipelines, and optionally aggregate across a cluster or include historical system log tables. ### Why package nerds care For package-manager people, chdig is interesting because it packages a database-specific operational TUI as both a standalone formula and a ClickHouse subcommand, with release artifacts spanning Linux, macOS, Arch/AUR, Scoop, and Homebrew. ### Timeline - 2022: Project motivation documented through a Know Your ClickHouse presentation. - 2023: GitHub repository created. - 2023: v0.2.0 release published. - 2024: v24.x releases align the versioning with ClickHouse-era release numbers. ### Related projects - ClickHouse is the database being inspected. - csysdig is cited by the README as a closer model than top for the interface. - flamelens, Perfetto, speedscope, pastila.nl, and viz.js are referenced as related tooling for flamegraph, trace, sharing, and query-pipeline workflows. ### Sources - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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: ./clickhouse-client.[xml|yaml|yml], $XDG_CONFIG_HOME/clickhouse/config.[xml|yaml|yml], ~/.config/clickhouse/config.[xml|yaml|yml], ~/.clickhouse-client/config.[xml|yaml|yml], /etc/clickhouse-client/config.[xml|yaml|yml], path set by CLICKHOUSE_CONFIG, --config ## Credential files - Unix: ./clickhouse-client.[xml|yaml|yml], $XDG_CONFIG_HOME/clickhouse/config.[xml|yaml|yml], ~/.config/clickhouse/config.[xml|yaml|yml], ~/.clickhouse-client/config.[xml|yaml|yml], /etc/clickhouse-client/config.[xml|yaml|yml], path set by CLICKHOUSE_CONFIG, --config ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** chdig - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Scoop - extras/chdig: normalized package name match | Scoop official bucket manifest trees: bucket/chdig.json from https://api.github.com/repos/ScoopInstaller/Extras/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. - [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. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [cargo-careful](https://www.automicvault.com/pkg/brew/cargo-careful/) - Shares av.db curated category or tags: cli, debugging, developer-tools. - [cdebug](https://www.automicvault.com/pkg/brew/cdebug/) - Shares av.db curated category or tags: cli, debugging, developer-tools. - [crash](https://www.automicvault.com/pkg/brew/crash/) - Shares av.db curated category or tags: cli, debugging, developer-tools. - [dbhash](https://www.automicvault.com/pkg/brew/dbhash/) - Shares av.db curated category or tags: cli, database, developer-tools. - [dblab](https://www.automicvault.com/pkg/brew/dblab/) - Shares av.db curated category or tags: cli, database, developer-tools, tui. - [ddd](https://www.automicvault.com/pkg/brew/ddd/) - Shares av.db curated category or tags: cli, debugging, developer-tools. - [delve](https://www.automicvault.com/pkg/brew/delve/) - Shares av.db curated category or tags: cli, debugging, developer-tools. - [demumble](https://www.automicvault.com/pkg/brew/demumble/) - Shares av.db curated category or tags: cli, debugging, developer-tools. - [jet](https://www.automicvault.com/pkg/brew/jet/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, database, developer, developer-tools, query. - [sqlcmd](https://www.automicvault.com/pkg/brew/sqlcmd/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, database, developer, developer-tools, interface. ## Combined YAML source View the package source record on GitHub. [combined/chdig.yml](https://github.com/automic-vault/db/blob/main/combined/chdig.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