# Install chdig with Homebrew, scoop

Dig into ClickHouse with TUI interface. Version 26.7.1 via Homebrew; verified 2026-07-18. Also installable with scoop: scoop install extras/chdig.

## 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
- **Version:** 26.7.1
- **Source summary:** Dig into ClickHouse with TUI interface
- **Homepage:** <https://github.com/azat/chdig>
- **Repository:** <https://github.com/azat/chdig>
- **Last updated:** 2026-07-18T15:14:35Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- chdig (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 26.7.1
## 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

- <https://github.com/azat/chdig>
- <https://api.github.com/repos/azat/chdig>
- <https://api.github.com/repos/azat/chdig/releases>


## 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
## 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


## Combined YAML source

View the package source record on GitHub. [combined/chdig.yml](https://github.com/mxcl/pkgdb/blob/main/combined/chdig.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph