macOS
Homebrewverified · 100%
brew install chdigprovider-native install command
brew / rank 5247
Install chdig with Homebrew
Dig into ClickHouse with TUI interface. Version 26.7.1 via Homebrew; verified 2026-07-18.
install
Additional install commands
overview
Package summary
Dig into ClickHouse with TUI interface
Project links
Commands and aliases
- chdig
history
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 posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
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
Config paths the tool may read or write during local use.
- 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
Credential-bearing paths to review before unattended agent runs.
- 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
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
chdig | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version26.7.1
manager updated2026-07-18
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:chdig |
|---|---|
| Version | 26.7.1 |
| Package manager | Homebrew |
| Homepage | https://github.com/azat/chdig |
| Repository | https://github.com/azat/chdig |
| Last updated | 2026-07-18T15:14:35Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation