clickhousectl (aliased as chctl) is a CLI tool that unifies local ClickHouse version management and ClickHouse Cloud operations. The guide covers installation, project scaffolding with a standard directory layout, running multiple named local servers on different ClickHouse versions for upgrade testing, connecting to ClickHouse Cloud with OAuth or API key auth, creating and scaling cloud services, integrating AI agent skills for Claude Code, and setting up GitHub Actions CI/CD pipelines for schema validation.
Table of contents
Bootstrap a project #Manage local dev servers #Connect to ClickHouse Cloud #Develop with an AI agent #Use clickhousectl in CI/CD #What's next #Sort: