chmonitor

Name: chmonitor
Author: chmonitor

Verified

Open-source operational advisor for ClickHouse — real-time monitoring plus AI-driven index/partition/materialized-view recommendations.

285stars

44forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/chmonitor/chmonitor

Getting Started

Guides for using ai agents skills like chmonitor.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 7/17/2026

{
  "issues": [
    {
      "file": ".agents/skills/embedded-captions/SKILL.md",
      "line": 3,
      "type": "hidden-content",
      "message": "Opaque base64 blob in an instruction file",
      "severity": "low"
    },
    {
      "file": ".agents/skills/media-use/SKILL.md",
      "line": 119,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://static.heygen.ai/cli/install.sh | bash\"",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-07-17T06:14:30.817Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is chmonitor?

chmonitor is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by chmonitor. Open-source operational advisor for ClickHouse — real-time monitoring plus AI-driven index/partition/materialized-view recommendations. It has 285 GitHub stars.

Is chmonitor safe to use?

Yes. chmonitor passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install chmonitor?

Clone the repository with "git clone https://github.com/chmonitor/chmonitor" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is chmonitor written in?

chmonitor is primarily written in TypeScript. It is open-source under chmonitor on GitHub, so you can review or fork the full source.

Are there alternatives to chmonitor?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh chmonitor against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

244,413

walrus cyclomatic-complexity-skill

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

chmonitor is a dashboard and advisor for ClickHouse. It reads system.* tables and shows what the cluster is doing — queries, merges, replication, storage, health — then recommends what to change next.

It does not apply DDL for you. Recommendations stay recommendations.

Runs the same way on Docker, Kubernetes, bare metal, or ClickHouse Cloud. Self-host it free (GPL-3.0), or use the hosted demo.

Current release: v0.3.0. Upgrading from v0.2? See Migrate to v0.3.

What it does

You need	chmonitor
See the cluster	Overview, topology, health checks, 30+ charts
Catch expensive work	Running, slow, failed, and historical queries
Understand data	Explorer, table size, parts, compression, TTLs
Keep replicas healthy	Merges, mutations, replication queue, Keeper
Get a second opinion	AI advisor: projections, skip indexes, PREWHERE, MVs
Ask in English	Built-in AI agent + MCP for Claude / Cursor
Work from a terminal	`chm` CLI — live TUI and `chm doctor`

Works with multiple ClickHouse hosts from one dashboard (?host=0).

More detail: docs · AI agent · editions

Quick start

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:v0.3.0

Open http://localhost:3000. Pin a version tag in production; use :latest only if you want the rolling tip.

Want a look first? dash.chmonitor.dev — no setup.

Install the CLI:

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

Deploy

Same CLICKHOUSE_HOST / CLICKHOUSE_USER / CLICKHOUSE_PASSWORD everywhere.

Target	Guide
Docker	docs/operate/deploy/docker
Kubernetes (Helm)	docs/operate/deploy/k8s
Cloudflare Workers	docs/operate/deploy
Railway / Render / Fly	One-click
Local development	Getting started

Release artifacts (Docker image, Node standalone, Workers archive) are on the GitHub Releases page.

Editions

One codebase. Community is free forever (GPL-3.0). An optional license unlocks enterprise gates — same binary.

	Community	Enterprise
Cost	Free, GPL-3.0	Priced by host count
Where it runs	Your infra	Same
ClickHouse hosts	Unlimited	Personal · Team 3 · Unlimited
AI advisor, agent, MCP	Included	Same, plus enterprise gates

Details: Editions.

Screenshots

Docs

Getting started — ClickHouse user, system tables, first run
Deploy — Docker, Kubernetes, Workers, one-click
AI agent — tools, skills, env
MCP clients — Claude, Cursor, and other clients
Environment variables
Connection errors
Migrate to v0.3
Source in this repo: docs/content/ · live site: docs.chmonitor.dev

Contribute

Issues and pull requests are welcome. Agent instructions live in AGENTS.md (CLAUDE.md includes that file).

License

GPL-3.0

Repo activity