Skip to content

feat(cli): name Postgres in root help, typical flows and search (#1493) - #1494

Open
sdairs wants to merge 1 commit into
deps/1474-jiff-apifrom
claude/postgres-cli-discovery-12da2e
Open

sdairs wants to merge 1 commit into
deps/1474-jiff-apifrom
claude/postgres-cli-discovery-12da2e

Conversation

@sdairs

@sdairs sdairs commented Nov 17, 2026 •

Copy link
Copy Markdown
Member

Fixes #1493

Why

Every "Typical flow" and "Next:" line in help routes an agent to ClickHouse, and the root help never names a Postgres command, so agents rarely consider it. An experiment for 0.6.0.

What

  • Root description, Cargo and npm descriptions and the README intro name Postgres.
  • Root agent block: a Postgres routing line replaces "Create account" (signup is already in the flow line), placed first; the skills line names Postgres. Still 8 lines.
  • local, local init and cloud flows name the Postgres commands.
  • search: oltp, transactional, relational and postgresql reach the Postgres commands.

Help text only, apart from the search synonyms.

QA

cargo fmt; clippy for the CLI (default and --no-default-features); cargo test -p clickhousectl. One new search test. local_postgres_client_input_test failed one test (a different one each time, Docker connect error) in two full parallel runs and passed on three reruns alone; this change does not touch it.

🤖 Generated with Claude Code


Note

Low Risk
Documentation, help text, and search synonym mapping only; no command execution or auth paths change.

Overview
Positions Postgres alongside ClickHouse in packaging copy (README, Cargo, npm) and the root CLI about string so the tool is described as covering both databases.

Agent-oriented help now routes to Postgres explicitly: the root context block leads with local/cloud Postgres commands, local/cloud/local init typical flows include Postgres steps, and the skills line names Postgres. One root line swaps from a standalone signup hint to this Postgres routing (signup remains in the cloud flow line).

Search maps purpose vocabulary (oltp, transactional, relational, postgresql) to postgres, with a test ensuring those queries surface postgres-related commands.

Reviewed by Cursor Bugbot for commit 223e1a9. Bugbot is set up for automated code reviews on this repo. Configure here.

Every typical flow and next-step line in help led to ClickHouse, and the
root help named no Postgres command. The root description and agent
context, the local, local init and cloud flows, and the package
descriptions now name Postgres, and search maps oltp, transactional,
relational and postgresql to the Postgres commands.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@sdairs
sdairs requested a review from iskakaushik as a code owner November 17, 2026 22:43
@sdairs sdairs added this to the v0.6.0 milestone Nov 17, 2026
@sdairs
sdairs added this pull request to stack #1483 November 17, 2026 22:43

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Make Postgres discoverable from help: root description, agent context, typical flows and search

1 participant