# 使用 Homebrew, scoop 安装 chdig

查看 chdig 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:chdig
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install chdig
```

  证据: local Homebrew formula metadata

### Windows

- Scoop (92%):

```sh
scoop install extras/chdig
```

  证据: Scoop official bucket manifest trees: bucket/chdig.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:chdig
- **软件包管理器:** Homebrew
- **版本:** 26.7.1
- **来源摘要:** Dig into ClickHouse with TUI interface
- **主页:** <https://github.com/azat/chdig>
- **仓库:** <https://github.com/azat/chdig>
- **最后更新:** 2026-07-18T15:14:35Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- chdig (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 26.7.1
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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`.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

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

### 来源

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


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- 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
## 其他软件包管理器记录

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


## 来源

- 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