Skip to content
Back to search

clickhouse-monitor

SkillWorks with Claude CodeGitHub

Specialized assistance for the chmonitor dashboard - a real-time monitoring dashboard for ClickHouse clusters

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/chmonitor/chmonitor with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/chmonitor/chmonitor'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/duyet--clickhouse-monitoring/badge.svg)](/listings/duyet--clickhouse-monitoring)

HTML

<a href="/listings/duyet--clickhouse-monitoring"><img src="/api/listings/duyet--clickhouse-monitoring/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

One container, pointed at any reachable ClickHouse (OSS, Altinity, or ClickHouse Cloud):

docker run -d --name chmonitor -p 3000:3000 \
  -e CLICKHOUSE_HOST=https://clickhouse.example.com:8443 \
  -e CLICKHOUSE_USER=default \
  -e CLICKHOUSE_PASSWORD=change-me \
  ghcr.io/chmonitor/chmonitor:0.3.9

Open **http://localhost:3000**. Pin a version tag in production; use `:latest` only if you want the rolling tip. Image tags carry no `v` prefix. The release `v0.3.9` publishes `0.3.9`, plus `0.3` and `latest`.

[release]: https://github.com/chmonitor/chmonitor/releases/tag/v0.3.9

Want a look first? **[dash.chmonitor.dev](https://dash.chmonitor.dev/overview?host=0)** — no setup.

Install the CLI:

curl -sSf https://chmonitor.dev/install.sh | bash
chm doctor

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "clickhouse-monitor",
  3. "version": "1.0.0",
  4. "description": "Specialized assistance for the chmonitor dashboard - a real-time monitoring dashboard for ClickHouse clusters",
  5. "author": "duyet",
  6. "license": "MIT",
  7. "keywords": [
  8. "clickhouse",
  9. "monitoring",
  10. "dashboard",
  11. "database",
  12. "observability"
  13. ],
  14. "homepage": "https://github.com/chmonitor/chmonitor",
  15. "repository": {
  16. "type": "git",
  17. "url": "https://github.com/chmonitor/chmonitor.git"
  18. },
  19. "skills": ["."]
  20. }
README.md · README · 210 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset=".github/logo.png">
  4. <img src=".github/logo.png" alt="chmonitor" width="120" height="120">
  5. </picture>
  6. </p>
  7. <h1 align="center">chmonitor</h1>
  8. <p align="center"><strong>The operational advisor for ClickHouse</strong></p>
  9. [![Build and Test](https://github.com/chmonitor/chmonitor/actions/workflows/ci.yml/badge.svg)](https://github.com/chmonitor/chmonitor/actions/workflows/ci.yml)
  10. [![GitHub stars](https://img.shields.io/github/stars/chmonitor/chmonitor?style=flat&logo=github&label=stars)](https://github.com/chmonitor/chmonitor/stargazers)
  11. [![Latest release](https://img.shields.io/github/v/release/chmonitor/chmonitor?sort=semver&label=release)](https://github.com/chmonitor/chmonitor/releases)
  12. [![Docker image](https://img.shields.io/badge/ghcr.io-chmonitor%2Fchmonitor-2496ED?logo=docker&logoColor=white)](https://github.com/chmonitor/chmonitor/pkgs/container/chmonitor)
  13. [![License](https://img.shields.io/github/license/chmonitor/chmonitor)](LICENSE)
  14. <p align="center">
  15. <a href="https://dash.chmonitor.dev/overview?host=0"><strong>Live demo</strong></a>
  16. · <a href="https://chmonitor.dev/">Website</a>
  17. · <a href="https://docs.chmonitor.dev">Docs</a>
  18. · <a href="https://docs.chmonitor.dev/guide/getting-started">Getting started</a>
  19. · <a href="#quick-start">Quick start</a>
  20. </p>
  21. <p align="center">
  22. <img alt="chmonitor v0.3 launch film" src=".github/videos/launch-v0-3.gif">
  23. </p>
  24. <p align="center">
  25. <a href="https://chmonitor.dev/watch/v0-3"><strong>Watch the v0.3 launch film</strong></a>
  26. </p>
  27. **chmonitor** is a dashboard and advisor for ClickHouse. It reads `system.*`
  28. tables and shows what the cluster is doing — queries, merges, replication,
  29. storage, health — then recommends what to change next.
  30. It does **not** apply DDL for you. Recommendations stay recommendations.
  31. Runs the same way on Docker, Kubernetes, bare metal, or ClickHouse Cloud.
  32. Self-host it free (GPL-3.0), or use the [hosted demo](https://dash.chmonitor.dev/overview?host=0).
  33. <!-- x-release-please-start-version -->
  34. Current release: **[v0.3.11][release]**.
  35. Upgrading from v0.2? See [Migrate to v0.3](https://docs.chmonitor.dev/reference/migrating/v0-3).
  36. ---
  37. ## What it does
  38. | You need | chmonitor |
  39. |---|---|
  40. | See the cluster | Overview, topology, health checks, 30+ charts |
  41. | Catch expensive work | Running, slow, failed, and historical queries |
  42. | Understand data | Explorer, table size, parts, compression, TTLs |
  43. | Keep replicas healthy | Merges, mutations, replication queue, Keeper |
  44. | Get a second opinion | AI advisor: projections, skip indexes, PREWHERE, MVs |
  45. | Ask in English | Built-in AI agent + [MCP](https://docs.chmonitor.dev/reference/mcp-clients) for Claude / Cursor |
  46. | Work from a terminal | [`chm` CLI](https://chmonitor.dev/cli) — live TUI and `chm doctor` |
  47. Works with **multiple ClickHouse hosts** from one dashboard (`?host=0`).
  48. More detail: [docs](https://docs.chmonitor.dev) · [AI agent](https://docs.chmonitor.dev/guide/ai-agent) · [editions](https://docs.chmonitor.dev/operate/advanced/editions)
  49. ---
  50. ## Quick start
  51. One container, pointed at any reachable ClickHouse (OSS, Altinity, or ClickHouse Cloud):
  52. ```bash
  53. docker run -d --name chmonitor -p 3000:3000 \
  54. -e CLICKHOUSE_HOST=https://clickhouse.example.com:8443 \
  55. -e CLICKHOUSE_USER=default \
  56. -e CLICKHOUSE_PASSWORD=change-me \
  57. ghcr.io/chmonitor/chmonitor:0.3.11
  58. ```
  59. Open **http://localhost:3000**. Pin a version tag in production; use `:latest` only if you want the rolling tip.
  60. Image tags carry no `v` prefix. The release `v0.3.11` publishes
  61. `0.3.11`, plus `0.3` and `latest`.
  62. [release]: https://github.com/chmonitor/chmonitor/releases/tag/v0.3.11
  63. <!-- x-release-please-end -->
  64. Want a look first? **[dash.chmonitor.dev](https://dash.chmonitor.dev/overview?host=0)** — no setup.
  65. Install the CLI:
  66. ```bash
  67. curl -sSf https://chmonitor.dev/install.sh | bash
  68. chm doctor
  69. ```
  70. ---
  71. ## Deploy
  72. Same `CLICKHOUSE_HOST` / `CLICKHOUSE_USER` / `CLICKHOUSE_PASSWORD` everywhere.
  73. | Target | Guide |
  74. |---|---|
  75. | Docker | [docs/operate/deploy/docker](https://docs.chmonitor.dev/operate/deploy/docker) |
  76. | Kubernetes (Helm) | [docs/operate/deploy/k8s](https://docs.chmonitor.dev/operate/deploy/k8s) |
  77. | Cloudflare Workers | [docs/operate/deploy](https://docs.chmonitor.dev/operate/deploy) |
  78. | Railway / Render / Fly | [One-click](https://docs.chmonitor.dev/operate/deploy/one-click) |
  79. | Local development | [Getting started](https://docs.chmonitor.dev/guide/getting-started/local) |
  80. Release artifacts (Docker image, Node standalone, Workers archive) are on the
  81. [GitHub Releases](https://github.com/chmonitor/chmonitor/releases) page.
  82. ---
  83. ## Editions
  84. chmonitor is **GPL-3.0**: self-host every feature, unlimited hosts, no payment, no
  85. key. A commercial license is optional and buys paper, not features — an invoice
  86. and named vendor, priority email support for the paid term, and an opt-in listing.
  87. Same binary either way.
  88. | License | Hosts | Yearly | Lifetime |
  89. |---|---|---|---|
  90. | Personal Self Hosted | Unlimited | Free | Free |
  91. | Team | 3 | $499 | $1,349 |
  92. | Unlimited | Unlimited | $999 | $2,999 |
  93. You do not get extra dashboard features versus the free build today. A **host**
  94. is one monitored connection; replicas in the same shard are not counted.
  95. Details: [Editions](https://docs.chmonitor.dev/operate/advanced/editions) ·
  96. [Commercial license](https://docs.chmonitor.dev/operate/advanced/commercial-license) ·
  97. [Buy](https://chmonitor.dev/license).
  98. ---
  99. ## Sponsors
  100. Self-hosting is free under GPL-3.0. Sponsorship is not a license — it buys no
  101. features, no support window, and no key. It funds the free build, and it earns a
  102. listing.
  103. | Tier | One-off | You get |
  104. |---|---|---|
  105. | Supporter | $19 | Your name on the sponsors page |
  106. | Backer | $59 | Your name and a link to your site on the sponsors page |
  107. | Hero | $99 | Your logo and link under the homepage hero, plus the sponsors page |
  108. | Partner | $199 | A larger hero slot, plus a short line about you on the sponsors page |
  109. Want to support the free build? **[Start sponsoring](https://chmonitor.dev/license#sponsor)** —
  110. from $19 one-off, or $99 to put your logo under the homepage hero.
  111. The wall: [chmonitor.dev/sponsors](https://chmonitor.dev/sponsors). A commercial
  112. license is a separate thing — see [Editions](#editions).
  113. ---
  114. ## Screenshots
  115. <picture>
  116. <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/overview-with-charts-dark-with-bg.jpeg">
  117. <img alt="Overview charts: query count, duration, and data written over time" src=".github/screenshots/overview-with-charts-dark-with-bg.jpeg">
  118. </picture>
  119. <picture>
  120. <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/cluster-topology-dark.png">
  121. <img alt="Cluster topology: nodes, shards, replicas, and Keeper quorum" src=".github/screenshots/cluster-topology-light.png">
  122. </picture>
  123. <picture>
  124. <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/cluster-insights-dark.png">
  125. <img alt="Cluster insights: findings, record-breaking queries, storage stats" src=".github/screenshots/cluster-insights-light.png">
  126. </picture>
  127. <picture>
  128. <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/ai-agent-dark.png">
  129. <img alt="AI agent: ask about schema, storage, queries, and health" src=".github/screenshots/ai-agent-light.png">
  130. </picture>
  131. <picture>
  132. <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/sql-console-dark.png">
  133. <img alt="SQL console: read-only SQL with history and EXPLAIN" src=".github/screenshots/sql-console-light.png">
  134. </picture>
  135. ---
  136. ## Docs
  137. - [Getting started](https://docs.chmonitor.dev/guide/getting-started) — ClickHouse user, system tables, first run
  138. - [Deploy](https://docs.chmonitor.dev/operate/deploy) — Docker, Kubernetes, Workers, one-click
  139. - [AI agent](https://docs.chmonitor.dev/guide/ai-agent) — tools, skills, env
  140. - [MCP clients](https://docs.chmonitor.dev/reference/mcp-clients) — Claude, Cursor, and other clients
  141. - [Editions](https://docs.chmonitor.dev/operate/advanced/editions) — what a license does and does not unlock
  142. - [Commercial license](https://docs.chmonitor.dev/operate/advanced/commercial-license) — SKUs, prices, `CHM_LICENSE_KEY`
  143. - [Sponsors](https://chmonitor.dev/sponsors) — the sponsor wall and the ladder
  144. - [Environment variables](https://docs.chmonitor.dev/reference/environment-variables)
  145. - [Connection errors](https://docs.chmonitor.dev/guide/guides/connection-errors)
  146. - [Migrate to v0.3](https://docs.chmonitor.dev/reference/migrating/v0-3)
  147. - Source in this repo: [`docs/content/`](docs/content/) · live site: [docs.chmonitor.dev](https://docs.chmonitor.dev)
  148. ---
  149. ## Contribute
  150. Issues and pull requests are welcome. Agent instructions live in [`AGENTS.md`](AGENTS.md)
  151. (`CLAUDE.md` includes that file).
  152. ## License
  153. [GPL-3.0](LICENSE)
  154. ---
  155. ![Repo activity](https://repobeats.axiom.co/api/embed/830f9ce7ba9e7a42f93630e2581506ca34c84067.svg 'Repobeats analytics image')
.agents/skills/media-use/scripts/lib/probe.mjs · Bundled script · 39 lines · 1 finding marked
  1. import { execFileSync } from "node:child_process";
  2. import { extname } from "node:path";
  3. const IMAGE_EXT = new Set([".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg", ".ico"]);
  4. export function probe(filePath) {
  5. const ext = extname(filePath).toLowerCase();
  6. if (ext === ".svg") return { width: null, height: null, duration: null, codec: "svg" };
  7. try {
  8. // execFileSync (no shell) so a hostile filename like `"; rm -rf ~; ".png`
    • Note: Quoted as data in code: Runs `rm -rf` against a root or home-directory path
    • Line 11 on GitHub
  9. // can't break out of the quoting — filePath is passed as a literal argv entry.
  10. const raw = execFileSync(
  11. "ffprobe",
  12. ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", filePath],
  13. { encoding: "utf8", timeout: 5000 },
  14. );
  15. const info = JSON.parse(raw);
  16. const stream = info.streams?.[0];
  17. const format = info.format;
  18. const isImage = IMAGE_EXT.has(ext);
  19. const duration = isImage
  20. ? null
  21. : parseFloat(format?.duration) || parseFloat(stream?.duration) || null;
  22. const width = parseInt(stream?.width, 10) || null;
  23. const height = parseInt(stream?.height, 10) || null;
  24. const codec = stream?.codec_name || null;
  25. return {
  26. duration: duration != null ? Math.round(duration * 10) / 10 : null,
  27. width,
  28. height,
  29. codec,
  30. };
  31. } catch {
  32. return { duration: null, width: null, height: null, codec: null };
  33. }
  34. }

Version history

  • v1.0.010/27/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.