Publish thv llm commands and regenerate CLI reference docs#5189
Merged
Conversation
JAORMX
previously approved these changes
May 5, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR makes the thv llm command group part of the public CLI surface and regenerates the CLI reference so the LLM gateway workflow is documented alongside the rest of ToolHive. It also updates the top-level llm description to say proxy and token-helper modes are supported rather than planned.
Changes:
- Unhide
thv llmandthv llm tokenin the Cobra command tree. - Update the
thv llmlong description to describe supported proxy/token-helper modes. - Regenerate
docs/cli/so the fullthv llmcommand tree appears in CLI reference docs.
Reviewed changes
Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
cmd/thv/app/llm.go |
Makes llm and llm token visible and updates the top-level help text. |
docs/cli/thv.md |
Adds thv llm to the root CLI reference index. |
docs/cli/thv_llm.md |
New top-level thv llm reference page. |
docs/cli/thv_llm_token.md |
New reference page for thv llm token. |
docs/cli/thv_llm_teardown.md |
New reference page for thv llm teardown. |
docs/cli/thv_llm_setup.md |
New reference page for thv llm setup. |
docs/cli/thv_llm_proxy.md |
New reference page for the thv llm proxy group. |
docs/cli/thv_llm_proxy_start.md |
New reference page for thv llm proxy start. |
docs/cli/thv_llm_config.md |
New reference page for the thv llm config group. |
docs/cli/thv_llm_config_show.md |
New reference page for thv llm config show. |
docs/cli/thv_llm_config_set.md |
New reference page for thv llm config set. |
docs/cli/thv_llm_config_reset.md |
New reference page for thv llm config reset. |
Comments suppressed due to low confidence (1)
cmd/thv/app/llm.go:38
runLLMTokenreturns an OAuth/OIDC access token, not necessarily a JWT. Some providers issue opaque bearer tokens, so documenting this as a "fresh JWT" is inaccurate and may lead users to build integrations that incorrectly depend on JWT structure.
authentication transparently. Two modes are supported:
Proxy mode — a localhost reverse proxy injects fresh tokens for tools
that only accept static API keys (e.g. Cursor).
Token helper — "thv llm token" prints a fresh JWT suitable for use as
apiKeyHelper or auth.command in OIDC-capable tools
(e.g. Claude Code).
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Remove Hidden: true from the thv llm command group and thv llm token subcommand, making them visible in help output and CLI reference. Update the command description to reflect that both proxy and token-helper modes are now supported (not planned). Regenerate docs/cli/ to include the full thv llm subcommand tree.
JAORMX
approved these changes
May 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Remove Hidden: true from the thv llm command group and thv llm token subcommand, making them visible in help output and CLI reference. Update the command description to reflect that both proxy and token-helper modes are now supported (not planned). Regenerate docs/cli/ to include the full thv llm subcommand tree.
Type of change
Test plan
task test)task test-e2e)task lint-fix)API Compatibility
v1beta1API, OR theapi-break-allowedlabel is applied and the migration guidance is described above.Changes
Does this introduce a user-facing change?
Implementation plan
Approved implementation plan
Special notes for reviewers