Repository navigation
Closed
Labels
bountyOpen bounty: Hanzo Rewards points for a merged fix (hanzo.ai/bounty)Open bounty: Hanzo Rewards points for a merged fix (hanzo.ai/bounty)bounty:starterStarter bounty: 75 pointsStarter bounty: 75 pointsdocumentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers
Description
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:140hanzo agents run <agent>,:141hanzo clusters create|list|pools|rm,:142hanzo cloud list|accounts,:121hanzo connector add|list|verify|rm --provider cloudflare.- In
src/commands/product/generated.rsthe agent ops areproduct: "agent"(singular, lines 51-60), the cluster ops areproduct: "compute", nodes: ["clusters"](lines 841-846), there is nocloudproduct (grep -c 'product: "cloud"' src/commands/product/generated.rsprints0), and the connection ops areproduct: "connection", notconnector. TheCommandsenum insrc/main.rshas noAgents,Clusters,CloudorConnectorvariant. - With the released 8.5.753 binary,
hanzo agents --helpprints the root page (Usage: hanzo [OPTIONS] [TASK]), whilehanzo agent --helpprints "Autonomous agents for your org". Same forclusters,cloud,connector. README.md:155linkshttps://docs.hanzo.ai/docs/services/graph, which returns 404.https://docs.hanzo.ai/docs/openapi/graphreturns 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> --helpprints 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 testis unaffected (docs-only change).
Difficulty: starter
Points: 75 (Hanzo Rewards, reputation points; not money; see https://hanzo.ai/bounty)
Maintainer: zeekay
How to claim
- Comment on this issue so others know you are on it.
- Open a pull request that says
Fixes #11. - Link your GitHub account to your Hanzo account at hanzo.ai/leaderboard so the merge counts.
Metadata
Metadata
Assignees
Labels
bountyOpen bounty: Hanzo Rewards points for a merged fix (hanzo.ai/bounty)Open bounty: Hanzo Rewards points for a merged fix (hanzo.ai/bounty)bounty:starterStarter bounty: 75 pointsStarter bounty: 75 pointsdocumentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers
Activity
linear commentedon Oct 26, 2026
HAI-463
deus-intus commentedon Oct 27, 2026
I am working on this.
deus-intus commentedon Oct 27, 2026
Resolved in PR #13.
hanzo agent run,hanzo compute clusters,hanzo connection).hanzo cloudentry.immoney1 commentedon Oct 27, 2026
Fix PR: #15 (all five acceptance points verified against a build of
main965a056).Verification actually run:
hanzo <words> --helpfor 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.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_drifthas 2 failures because externalgenproduct/driftgatebinaries are absent (NotFound) — reproduced identically with the README change stashed, i.e. pre-existing on cleanmain.Line refs in the issue are +14 vs current
main; the four commands were at README 134–135 and 154–156 at PR time.