Skip to content

Fix README commands that match no hanzo subcommand #11

Closed

Description

@zeekay

Summary

Four commands in the README match no hanzo subcommand, and the README says an unknown first word is read as a coding task. Typing hanzo clusters list as written starts an AI session about "clusters list". One docs link also returns 404.

Evidence

Checked at 5ce6db4.

  • README.md:140 hanzo agents run <agent>, :141 hanzo clusters create|list|pools|rm, :142 hanzo cloud list|accounts, :121 hanzo connector add|list|verify|rm --provider cloudflare.
  • In src/commands/product/generated.rs the agent ops are product: "agent" (singular, lines 51-60), the cluster ops are product: "compute", nodes: ["clusters"] (lines 841-846), there is no cloud product (grep -c 'product: "cloud"' src/commands/product/generated.rs prints 0), and the connection ops are product: "connection", not connector. The Commands enum in src/main.rs has no Agents, Clusters, Cloud or Connector variant.
  • With the released 8.5.753 binary, hanzo agents --help prints the root page (Usage: hanzo [OPTIONS] [TASK]), while hanzo agent --help prints "Autonomous agents for your org". Same for clusters, cloud, connector.
  • README.md:155 links https://docs.hanzo.ai/docs/services/graph, which returns 404. https://docs.hanzo.ai/docs/openapi/graph returns 200.

What to do

For each of the four lines, find the real command (hanzo --help, hanzo compute --help, hanzo connection --help, or the Op rows in generated.rs) and rewrite the line, or delete it if the command does not exist. Point the graph link at the working page. Do not add commands to the CLI.

Acceptance criteria

  • For every command in the two fenced blocks under "Identity & billing" and "Cloud", hanzo <words> --help prints that command's own help, not the root usage page (build from this commit or use the latest release).
  • No line is left that starts a coding session when typed as written.
  • The graph link returns 200.
  • cargo test is unaffected (docs-only change).

Difficulty: starter

Points: 75 (Hanzo Rewards, reputation points; not money; see https://hanzo.ai/bounty)

Maintainer: zeekay

How to claim

  1. Comment on this issue so others know you are on it.
  2. Open a pull request that says Fixes #11.
  3. Link your GitHub account to your Hanzo account at hanzo.ai/leaderboard so the merge counts.

Activity

  1. added
    documentationImprovements or additions to documentation
    bountyOpen bounty: Hanzo Rewards points for a merged fix (hanzo.ai/bounty)
    on Oct 26, 2026
  2. linear commented on Oct 26, 2026

    @linear
  3. deus-intus commented on Oct 27, 2026

    @deus-intus

    I am working on this.

  4. deus-intus commented on Oct 27, 2026

    @deus-intus

    Resolved in PR #13.

    • Corrected commands to match real CLI subcommands (hanzo agent run, hanzo compute clusters, hanzo connection).
    • Removed invalid hanzo cloud entry.
    • Updated graph doc link to working 200 URL (https://docs.hanzo.ai/docs/openapi/graph).
  5. immoney1 commented on Oct 27, 2026

    @immoney1
    Contributor

    Fix PR: #15 (all five acceptance points verified against a build of main 965a056).

    Verification actually run:

    • hanzo <words> --help for all 24 command sequences across both fenced blocks → 24/24 exit 0 with the command's own help; no root usage page, no task-launcher fallthrough.
    • Flag-as-written checks (auth login --provider hanzo --token - --account owner/name --choose, auth logout owner/name --all, auth use owner/name, up --link mycluster, provider connect cloudflare, connection list) → all exit 0.
    • curl -L docs.hanzo.ai/docs/services/graph → 404; docs.hanzo.ai/docs/openapi/graph → 200.
    • cargo test: 394 unit + auth 5 + cli 21 + cloud_sessions 2 pass. spec_drift has 2 failures because external genproduct/driftgate binaries are absent (NotFound) — reproduced identically with the README change stashed, i.e. pre-existing on clean main.

    Line refs in the issue are +14 vs current main; the four commands were at README 134–135 and 154–156 at PR time.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    bountyOpen bounty: Hanzo Rewards points for a merged fix (hanzo.ai/bounty)bounty:starterStarter bounty: 75 pointsdocumentationImprovements or additions to documentationgood first issueGood for newcomers

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions