---
title: "What's new in clickhousectl v0.3.0"
description: "clickhousectl v0.3.0 adds improvements aimed at agentic workflows, additional installation methods, OAuth for Cloud service queries, and custom configuration files for local servers. It detects coding-agent environments and defaults to JSON on stdout, uses gh-style exit codes, reads CLICKHOUSE_ credentials from a working-directory .env file, and hides deprecated API fields from CLI output. Cloud service queries can authenticate with OAuth without provisioning a Query Endpoint; idled services wake automatically, while stopped services fail with a start hint. For local development, selected versions resolve from installed binaries before network lookup, local use can put ClickHouse on PATH, and named XML, YAML, or YML files overlay built-in defaults. The release also adds Python installation options and extends local init with a postgres/ tree alongside clickhouse/."
---

# What's new in clickhousectl v0.3.0

[Clickhouse](https://yomu.fyi/company/clickhouse) · Jun 9, 2026

**Type:** Announcement

## Summary

clickhousectl v0.3.0 adds improvements aimed at agentic workflows, additional installation methods, OAuth for Cloud service queries, and custom configuration files for local servers. It detects coding-agent environments and defaults to JSON on stdout, uses gh-style exit codes, reads CLICKHOUSE\_ credentials from a working-directory .env file, and hides deprecated API fields from CLI output. Cloud service queries can authenticate with OAuth without provisioning a Query Endpoint; idled services wake automatically, while stopped services fail with a start hint. For local development, selected versions resolve from installed binaries before network lookup, local use can put ClickHouse on PATH, and named XML, YAML, or YML files overlay built-in defaults. The release also adds Python installation options and extends local init with a postgres/ tree alongside clickhouse/.

## Context

The release is motivated by improving the agentic experience of clickhousectl, supporting more installation paths, querying Cloud services with OAuth, and allowing local-server settings to be changed without reproducing a full built-in configuration.

## Approach / What changed

The release adds agent-environment detection, structured output defaults, gh-style exit codes, .env credential loading, OAuth authentication for cloud service queries, named configuration overlays for local servers, Python packaging options, local version lookup, PATH installation, and PostgreSQL project scaffolding.

## Takeaways

- Agent-oriented exit codes distinguish success, general errors, cancellation, and authentication requirements; JSON becomes the default stdout format when clickhousectl detects a coding-agent environment.
- OAuth lets cloud service query run SQL without first provisioning a Query Endpoint. Queries wake an idled service automatically, but a stopped service fails and suggests running cloud service start.
- Local server configuration files in ~/.clickhouse/configs/ may be XML, YAML, or YML and are overlaid on built-in defaults, so they only need to define changed settings.

**Tags:** [Authentication](https://yomu.fyi/topic/authentication), [Developer Experience](https://yomu.fyi/topic/developer-experience), [Postgres](https://yomu.fyi/topic/postgres)

- Source: [Clickhouse](https://clickhouse.com/blog/clickhousectl-v0-3-0)
- Source URL: https://clickhouse.com/blog/clickhousectl-v0-3-0
- Ingested by Yomu: 2026-08-29T01:34:35.183Z

[Read original post](https://clickhouse.com/blog/clickhousectl-v0-3-0)