Restore CLI aliases and correct usage guidance - #667
Conversation
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: c542f160c7
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit c542f16. Configure here.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: fc71c8d5ae
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 6a09cb2871
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: a3d3e5be90
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 3eec3fd12e
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Restore
hud jobs <id>andhud trace <id>through small shims in their command modules, forwarding to the existing get handlers. Accept legacy[eval] remote = trueas hosted placement while preserving explicit runtime and CLI precedence and validation for unknown keys.Correct CLI, Compose, Harbor, cookbook, and environment configuration guidance. Local Python execution retains the current single-template-file requirement; multi-file execution remains unresolved.
Validation: 147 relevant CLI tests passed. Ruff lint, formatting, ty, and diff checks passed. Runtime, environment, and core CLI infrastructure code match the PR base. Hosted deployment was not exercised.
Note
Medium Risk
CLI routing and eval placement resolution affect everyday workflows; changes are covered by expanded tests but alter how bare UUIDs and legacy
remoteinteract with runtime defaults.Overview
Restores
hud jobs <job-id>andhud trace <trace-id>as shortcuts to the existinggetcommands via customCLIGroupresolvers that detect a leading UUID (options can appear before or after the id). Malformed bare ids still surface as usage errors.Eval config:
.hud_eval.tomlagain accepts legacy[eval] remote = true|false, mappingtrueto hosted placement whenruntimeis unset; explicitruntimeand CLI flags keep precedence. Non-booleanremoteis rejected like other invalid keys.Docs and templates align with current behavior: hosted Compose/Harbor deploys document
--runtime-configwith a JSONRuntimeConfig; CLI reference updates coverhud evallocal vs Docker requirements, deploy/init flags, dry-run/--yes, andhud models list. Cookbook comments and scaffold.hud_eval.tomlfiles pick up the same model-list and gateway comment tweaks.Reviewed by Cursor Bugbot for commit d5d5c37. Bugbot is set up for automated code reviews on this repo. Configure here.