infra-clickhouse

SKILL.md

ClickHouse with clickhousectl

clickhousectl manages ClickHouse in two environments:

Local — ClickHouse installed and running on the user's machine, for development.

Cloud — managed ClickHouse Cloud services, for production: fully managed, automatic scaling, backups, and upgrades.

This file routes to the right reference. The step-by-step workflows live in ref/local.md and ref/cloud.md — read the one that matches the user's situation before running commands.

Which reference to use

The user wants to...
Read

Build an app with ClickHouse, develop or prototype locally, no cloud account needed
ref/local.md

Go to production, host a managed ClickHouse, or use ClickHouse Cloud explicitly
ref/cloud.md

Operate an existing cloud service (schemas, users, queries against it)
ref/cloud.md

Develop locally now, ship to production later
Start with ref/local.md; it points to ref/cloud.md when it's time to go to prod

If it's genuinely ambiguous (e.g. "set up ClickHouse for my app"), default to local for development tasks and ask before creating anything in the cloud — cloud services cost money.