diff --git a/.changeset/cli-query-connections-patterns.md b/.changeset/cli-query-connections-patterns.md
new file mode 100644
index 00000000..2c7cfab2
--- /dev/null
+++ b/.changeset/cli-query-connections-patterns.md
@@ -0,0 +1,10 @@
+---
+"@hyperdx/cli": minor
+---
+
+Add `hdx query` and `hdx connections` commands for agentic ClickHouse workflows:
+
+- **`hdx connections`** — list ClickHouse connections (`id`, `name`, `host`) for the authenticated team. Supports `--json` for programmatic consumption.
+- **`hdx query --connection-id <id> --sql <query>`** — run raw SQL against a configured ClickHouse connection via the `/clickhouse-proxy`. Default `--format` is `JSONEachRow` (NDJSON); any ClickHouse format is accepted. Exit codes: `0` on success (empty stdout = zero rows), `1` on failure. On error, a lazy connection lookup distinguishes "unknown connection ID" from "bad SQL".
+- **`hdx query --patterns`** — post-process the result with the Drain algorithm (`@hyperdx/common-utils/dist/drain`) and emit one NDJSON pattern object per cluster, sorted by count desc: `{"pattern":"<template>","count":<n>,"sample":"<first sample>"}`. Use `--body-column <name>` to cluster a single column's string value; defaults to the whole row JSON-serialized so any SELECT shape works.
+- `--help` documents the exit-code contract and includes sampling guidance (`ORDER BY rand()` + selective WHERE warning) for mining over large tables.
diff --git a/packages/cli/src/api/client.ts b/packages/cli/src/api/client.ts
index af0303a2..04def1e5 100644
--- a/packages/cli/src/api/client.ts
+++ b/packages/cli/src/api/client.ts
@@ -345,7 +345,7 @@ export interface SourceResponse {
   sessionSourceId?: string;
 }
 
-export interface ConnectionResponse {
+interface ConnectionResponse {
   id: string;
   _id: string;
   name: string;