diff --git a/.github/upstream-projects.yaml b/.github/upstream-projects.yaml index d796f9509..dd5667397 100644 --- a/.github/upstream-projects.yaml +++ b/.github/upstream-projects.yaml @@ -64,7 +64,7 @@ projects: - id: toolhive repo: stacklok/toolhive - version: v0.61.0 + version: v0.64.0 # toolhive is a monorepo covering the CLI, the Kubernetes # operator, and the vMCP gateway. It also introduces cross- # cutting features that land in concepts/, integrations/, diff --git a/docs/toolhive/guides-cli/webhooks.mdx b/docs/toolhive/guides-cli/webhooks.mdx index 1c098e4b8..1dbbd0dc1 100644 --- a/docs/toolhive/guides-cli/webhooks.mdx +++ b/docs/toolhive/guides-cli/webhooks.mdx @@ -351,6 +351,11 @@ webhook endpoint: - `ignore` allows the tool call through. Use this for non-critical webhooks like logging or enrichment, where availability is not a hard requirement. +The failure policy covers errors reaching or reading from the webhook, such as +timeouts, network errors, and invalid responses. If ToolHive fails before it +sends the request, for example because it can't resolve the HMAC signing secret +or build the request payload, it rejects the request under either policy. + :::warning A `422 Unprocessable Entity` response from a webhook is always treated as a diff --git a/docs/toolhive/guides-k8s/auth-k8s.mdx b/docs/toolhive/guides-k8s/auth-k8s.mdx index d69f88b1a..ab5152a1b 100644 --- a/docs/toolhive/guides-k8s/auth-k8s.mdx +++ b/docs/toolhive/guides-k8s/auth-k8s.mdx @@ -224,7 +224,10 @@ kubectl get mcpserver -n toolhive-system \ ``` If the ConfigMap is missing or the key isn't found, the condition reports a -`False` status with a reason of `CABundleRefNotFound` or `CABundleRefInvalid`. +`False` status with a reason of `CABundleRefNotFound` or `CABundleRefInvalid`. A +VirtualMCPServer whose `incomingAuth.oidcConfigRef` points at the same +`MCPOIDCConfig` reports the same condition, so you can check it with +`kubectl get virtualmcpserver` in the same way. ### Authenticate Kubernetes service-to-service traffic diff --git a/docs/toolhive/guides-k8s/embedded-auth-server-k8s.mdx b/docs/toolhive/guides-k8s/embedded-auth-server-k8s.mdx index 799bbf12a..208f2f63d 100644 --- a/docs/toolhive/guides-k8s/embedded-auth-server-k8s.mdx +++ b/docs/toolhive/guides-k8s/embedded-auth-server-k8s.mdx @@ -219,6 +219,7 @@ with a generic "authorization header required" error. | `upstreamProviders` | Configuration for upstream identity providers. MCPServer and MCPRemoteProxy support one provider; VirtualMCPServer supports multiple providers for sequential authentication. | | `cimd` | Optional Client ID Metadata Document (CIMD) configuration. When `cimd.enabled` is `true`, the auth server accepts HTTPS URLs as `client_id` values and resolves them via CIMD, letting clients (for example, VS Code) authenticate without prior Dynamic Client Registration. See [Enable CIMD for zero-registration clients](#enable-cimd-for-zero-registration-clients). | | `baselineClientScopes` | Optional list of OAuth 2.0 scopes merged into every DCR-registered client's scope set. Use this when MCP clients register with a narrowed `scope` field but then request wider scopes at `/oauth/authorize`. See [Enable baseline scopes for DCR clients](#enable-baseline-scopes-for-dcr-clients). | +| `tlsListener` | Optional. Serves the authorization server's OAuth endpoints over HTTPS on port 8443, using a certificate and private key from a Secret. See [Serve the authorization server over TLS](#serve-the-authorization-server-over-tls). | | `disableUpstreamTokenInjection` | Optional. When `true`, the embedded auth server authenticates clients normally but the proxy strips `Authorization`, `Cookie`, and `Proxy-Authorization` from forwarded requests instead of swapping the JWT for an upstream token. Use this for public backends (such as documentation servers) that you still want to gate behind client auth. Cannot be combined with `tokenExchange`, `awsSts`, or OBO (Stacklok Enterprise) on the same workload, since each would re-add credentials after the strip. | ## Step 5: Create the MCPOIDCConfig and MCPServer resources @@ -394,6 +395,56 @@ kubectl create secret generic redis-acl-secret \ For a complete walkthrough including deploying Redis Sentinel from scratch, see [Redis session storage](./redis-session-storage.mdx). +## Serve the authorization server over TLS + +By default, the embedded authorization server shares the proxy's plain HTTP +port, and you terminate TLS at an ingress or gateway in front of it. To have the +pod serve the authorization server's OAuth endpoints over HTTPS itself, add a +`tlsListener` block at `spec.embeddedAuthServer.tlsListener`. The listener runs +on port 8443 alongside the HTTP port. MCP traffic, health probes, and metrics +stay on the HTTP port. + +Create a TLS Secret with the certificate and private key in PEM format: + +```bash +kubectl create secret tls auth-server-tls \ + --namespace toolhive-system \ + --cert=tls.crt \ + --key=tls.key +``` + +Then reference both keys from the `MCPExternalAuthConfig`. Both +`certificateSecretRef` and `privateKeySecretRef` are required: + +```yaml title="MCPExternalAuthConfig: TLS listener" +spec: + type: embeddedAuthServer + embeddedAuthServer: + # ... + tlsListener: + certificateSecretRef: + name: auth-server-tls + key: tls.crt + privateKeySecretRef: + name: auth-server-tls + key: tls.key +``` + +When `tlsListener` is set, the operator adds a container port named `https-auth` +and a Service port 8443 with `appProtocol: https` to each MCPServer or +MCPRemoteProxy that references the config. The listener accepts TLS 1.2 or +later. When the certificate in the Secret is renewed, the listener picks up the +new certificate without a pod restart. + +Because the TLS listener owns port 8443, set the workload's `proxyPort` to a +different port. If both use 8443, the operator marks the workload `Failed` and +reports the conflict in its status conditions. + +A VirtualMCPServer accepts the same block at +`spec.authServerConfig.tlsListener`. See +[Serve the authorization server over TLS](../guides-vmcp/embedded-auth-server-vmcp.mdx#serve-the-authorization-server-over-tls) +in the vMCP guide. + ## Configure MCP client registration MCP clients must identify themselves to the embedded authorization server. The diff --git a/docs/toolhive/guides-vmcp/delegate-agent-identity.mdx b/docs/toolhive/guides-vmcp/delegate-agent-identity.mdx index dbb05ffe6..c38a5765b 100644 --- a/docs/toolhive/guides-vmcp/delegate-agent-identity.mdx +++ b/docs/toolhive/guides-vmcp/delegate-agent-identity.mdx @@ -318,5 +318,6 @@ must register again. | `invalid_grant`: "This client is not authorized to exchange subject tokens from the external actor's issuer." | The authenticated client isn't in `issuerPolicies[].allowedDelegateClients` for the issuer that minted the subject token. | | `invalid_grant`: "The subject token was issued to a different client." | The subject token's own `client_id` claim doesn't match the authenticated delegate client, and the client isn't in `allowedDelegateClients`. | | `invalid_request`: "The subject token is invalid or could not be verified." | The subject token failed signature, issuer, or audience validation against every configured `trustedIssuers` entry. | +| `invalid_target`: "The client is not permitted to request audience ..." | The `audience` parameter on the exchange request isn't in the delegate client's `audiences` list. Request one of the listed audiences, or add the audience to `delegateClients[].audiences`. | | CRD rejected: `issuerPolicies[]: allowedDelegateClients: Required value` | An `inboundGrants.tokenExchange.issuerPolicies` entry is missing `allowedDelegateClients`. Add it. | | CRD rejected: "delegateClients with an HTTP issuer require insecureAllowConfidentialOverLoopbackHTTP to be explicitly enabled" | A delegate client uses a plain-HTTP issuer. Use an `https://` issuer, or for local development set `insecureAllowConfidentialOverLoopbackHTTP: true` with a loopback issuer. | diff --git a/docs/toolhive/guides-vmcp/embedded-auth-server-vmcp.mdx b/docs/toolhive/guides-vmcp/embedded-auth-server-vmcp.mdx index 392c9e285..8accffd3e 100644 --- a/docs/toolhive/guides-vmcp/embedded-auth-server-vmcp.mdx +++ b/docs/toolhive/guides-vmcp/embedded-auth-server-vmcp.mdx @@ -669,6 +669,19 @@ registration orphaned. For production, configure Redis storage by adding a [Redis session storage](../guides-k8s/redis-session-storage.mdx) for a complete walkthrough. +## Serve the authorization server over TLS + +To have the vMCP pod serve the authorization server's OAuth endpoints over HTTPS +itself, add a `tlsListener` block to `authServerConfig` that references a +PEM-encoded certificate and private key in a Secret. The listener runs on port +8443, and the operator adds it to the vMCP Service as port 8443 with +`appProtocol: https`. MCP traffic stays on the HTTP port. If the Service uses +`serviceType: LoadBalancer` or `NodePort`, port 8443 is reachable from outside +the cluster and serves the same authorization server routes as the HTTP port. +See +[Serve the authorization server over TLS](../guides-k8s/embedded-auth-server-k8s.mdx#serve-the-authorization-server-over-tls) +for the field layout and Secret setup. + ## Forward user tokens to backends The embedded auth server stores each user's upstream tokens after login. Three diff --git a/docs/toolhive/reference/cli/thv.md b/docs/toolhive/reference/cli/thv.md index 170d95c26..0f1002baa 100644 --- a/docs/toolhive/reference/cli/thv.md +++ b/docs/toolhive/reference/cli/thv.md @@ -29,8 +29,8 @@ thv [flags] ### Options ``` - --debug Enable debug mode - -h, --help help for thv + --debug[=true|false] Enable debug mode + -h, --help[=true|false] help for thv ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin.md b/docs/toolhive/reference/cli/thv_ai-plugin.md index 67368956d..220fba997 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin.md @@ -22,13 +22,13 @@ commands, agents, skills, hooks, and server declarations. ### Options ``` - -h, --help help for ai-plugin + -h, --help[=true|false] help for ai-plugin ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_build.md b/docs/toolhive/reference/cli/thv_ai-plugin_build.md index 094991b1f..8adb5a8d9 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_build.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_build.md @@ -26,14 +26,14 @@ thv ai-plugin build [path] [flags] ### Options ``` - -h, --help help for build - -t, --tag string OCI tag for the built artifact + -h, --help[=true|false] help for build + -t, --tag string OCI tag for the built artifact ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_builds.md b/docs/toolhive/reference/cli/thv_ai-plugin_builds.md index b26da4a41..e64ff425d 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_builds.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_builds.md @@ -24,14 +24,14 @@ thv ai-plugin builds [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for builds + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for builds ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_builds_remove.md b/docs/toolhive/reference/cli/thv_ai-plugin_builds_remove.md index d265c16d8..95b1c1201 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_builds_remove.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_builds_remove.md @@ -24,13 +24,13 @@ thv ai-plugin builds remove [flags] ### Options ``` - -h, --help help for remove + -h, --help[=true|false] help for remove ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_info.md b/docs/toolhive/reference/cli/thv_ai-plugin_info.md index 107f371c5..c3768cc33 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_info.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_info.md @@ -25,7 +25,7 @@ thv ai-plugin info [plugin-name] [flags] ``` --format string Output format (json, text) (default "text") - -h, --help help for info + -h, --help[=true|false] help for info --project-root string Project root path for project-scoped plugins --scope string Filter by scope (user, project) ``` @@ -33,7 +33,7 @@ thv ai-plugin info [plugin-name] [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_install.md b/docs/toolhive/reference/cli/thv_ai-plugin_install.md index fd886d346..baadf6fac 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_install.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_install.md @@ -29,20 +29,20 @@ thv ai-plugin install [plugin-name] [flags] ### Options ``` - --allow-unsigned Allow installing a project-scoped plugin without a verified signature (recorded in the lock file) - --clients string Comma-separated target client apps (e.g. claude-code,codex), or "all" for every available client - --force Overwrite existing plugin directory - --group string Group to add the plugin to after installation - -h, --help help for install - --project-root string Project root path for project-scoped installs - --public-key string Path to the cosign public key (cosign.pub) a key-pair-signed plugin must verify against. Required the first time such a plugin is installed project-scoped; the key is then pinned in the lock file and reused automatically - --scope string Installation scope (user, project) (default "user") + --allow-unsigned[=true|false] Allow installing a project-scoped plugin without a verified signature (recorded in the lock file) + --clients string Comma-separated target client apps (e.g. claude-code,codex), or "all" for every available client + --force[=true|false] Overwrite existing plugin directory + --group string Group to add the plugin to after installation + -h, --help[=true|false] help for install + --project-root string Project root path for project-scoped installs + --public-key string Path to the cosign public key (cosign.pub) a key-pair-signed plugin must verify against. Required the first time such a plugin is installed project-scoped; the key is then pinned in the lock file and reused automatically + --scope string Installation scope (user, project) (default "user") ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_list.md b/docs/toolhive/reference/cli/thv_ai-plugin_list.md index 8fa59900d..1c785d747 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_list.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_list.md @@ -27,7 +27,7 @@ thv ai-plugin list [flags] --client string Filter by client application --format string Output format (json, text) (default "text") --group string Filter by group - -h, --help help for list + -h, --help[=true|false] help for list --project-root string Project root path for project-scoped plugins --scope string Filter by scope (user, project) ``` @@ -35,7 +35,7 @@ thv ai-plugin list [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_push.md b/docs/toolhive/reference/cli/thv_ai-plugin_push.md index 7f821d735..ed29f1bef 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_push.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_push.md @@ -27,16 +27,16 @@ thv ai-plugin push [reference] [flags] ### Options ``` - -h, --help help for push + -h, --help[=true|false] help for push --identity-token string OIDC identity token (or a path to a file containing one) for keyless signing. Mutually exclusive with --key. If omitted, one is acquired automatically: from the GitHub Actions OIDC token when running with id-token: write permission, otherwise via an interactive browser sign-in --key string Path to a cosign private key to sign the pushed artifact. Requires the locally discovered ToolHive server; for a remote or manually configured API URL, use keyless signing. Encrypted keys are decrypted with COSIGN_PASSWORD read from the 'thv serve' process, which performs the signing. Consumers installing the result project-scoped must pass --public-key with the matching cosign public key the first time; distribute it alongside the artifact. Keyless signing needs no such out-of-band step, since the signer identity is verifiable from the artifact itself - --no-sign Push without signing (consumers will need an explicit unsigned exception to install project-scoped) + --no-sign[=true|false] Push without signing (consumers will need an explicit unsigned exception to install project-scoped) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_sync.md b/docs/toolhive/reference/cli/thv_ai-plugin_sync.md index 7160ee5a8..943cea9f5 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_sync.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_sync.md @@ -33,22 +33,22 @@ thv ai-plugin sync [flags] ### Options ``` - --adopt Write lock entries for existing unmanaged project-scope installs - --allow-unsigned Record plugins as unsigned in the lock file: when adopting installs whose signature state cannot be established (--adopt), and when repairing an entry that records no trust decision and whose content is unsigned - --check Report drift without installing, writing, or removing anything - --clients string Comma-separated target client apps (e.g. claude-code,codex), or "all" for every available client - --format string Output format (json, text) (default "text") - -h, --help help for sync - --project-root string Project root path (default: auto-detected from the current directory) - --prune Remove installs no longer present in the lock file - --public-key string Path to the cosign public key used to verify key-pair-signed plugins during --adopt - --yes Skip the confirmation prompt (required when not running interactively) + --adopt[=true|false] Write lock entries for existing unmanaged project-scope installs + --allow-unsigned[=true|false] Record plugins as unsigned in the lock file: when adopting installs whose signature state cannot be established (--adopt), and when repairing an entry that records no trust decision and whose content is unsigned + --check[=true|false] Report drift without installing, writing, or removing anything + --clients string Comma-separated target client apps (e.g. claude-code,codex), or "all" for every available client + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for sync + --project-root string Project root path (default: auto-detected from the current directory) + --prune[=true|false] Remove installs no longer present in the lock file + --public-key string Path to the cosign public key used to verify key-pair-signed plugins during --adopt + --yes[=true|false] Skip the confirmation prompt (required when not running interactively) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_uninstall.md b/docs/toolhive/reference/cli/thv_ai-plugin_uninstall.md index 156267d1f..413abe5ce 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_uninstall.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_uninstall.md @@ -24,7 +24,7 @@ thv ai-plugin uninstall [plugin-name] [flags] ### Options ``` - -h, --help help for uninstall + -h, --help[=true|false] help for uninstall --project-root string Project root path for project-scoped plugins --scope string Scope to uninstall from (user, project) (default "user") ``` @@ -32,7 +32,7 @@ thv ai-plugin uninstall [plugin-name] [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_upgrade.md b/docs/toolhive/reference/cli/thv_ai-plugin_upgrade.md index ce8aaefd4..ae9ca6a78 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_upgrade.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_upgrade.md @@ -39,22 +39,22 @@ thv ai-plugin upgrade [plugin-name...] [flags] ### Options ``` - --allow-ref-change Permit the artifact to move to a different repository during upgrade - --allow-signer-change Permit upgrading to an artifact signed by a different identity; the new identity replaces the recorded one - --clients string Comma-separated target client apps (e.g. claude-code,codex), or "all" for every available client - --fail-on-changes Report what would change without installing anything; a CI freshness gate - --format string Output format (json, text) (default "text") - -h, --help help for upgrade - --preview Report what would change without persisting anything (OCI sources are still fetched to compare digests) - --project-root string Project root path (default: auto-detected from the current directory) - --public-key string Path to a cosign public key proposed as the replacement trust anchor (requires --allow-signer-change) - --yes Skip the confirmation prompt (required when not running interactively) + --allow-ref-change[=true|false] Permit the artifact to move to a different repository during upgrade + --allow-signer-change[=true|false] Permit upgrading to an artifact signed by a different identity; the new identity replaces the recorded one + --clients string Comma-separated target client apps (e.g. claude-code,codex), or "all" for every available client + --fail-on-changes[=true|false] Report what would change without installing anything; a CI freshness gate + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for upgrade + --preview[=true|false] Report what would change without persisting anything (OCI sources are still fetched to compare digests) + --project-root string Project root path (default: auto-detected from the current directory) + --public-key string Path to a cosign public key proposed as the replacement trust anchor (requires --allow-signer-change) + --yes[=true|false] Skip the confirmation prompt (required when not running interactively) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_ai-plugin_validate.md b/docs/toolhive/reference/cli/thv_ai-plugin_validate.md index 6146f0767..bcc59b08d 100644 --- a/docs/toolhive/reference/cli/thv_ai-plugin_validate.md +++ b/docs/toolhive/reference/cli/thv_ai-plugin_validate.md @@ -24,14 +24,14 @@ thv ai-plugin validate [path] [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for validate + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for validate ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_build.md b/docs/toolhive/reference/cli/thv_build.md index 141364a48..e1aec7170 100644 --- a/docs/toolhive/reference/cli/thv_build.md +++ b/docs/toolhive/reference/cli/thv_build.md @@ -54,8 +54,8 @@ thv build [flags] PROTOCOL [-- ARGS...] ``` --build-with stringArray Build-time dependency constraint for protocol scheme builds, interpreted per package ecosystem (uvx://: PEP 508 specifier passed to 'uv tool install --with', e.g. --build-with 'mcp<2'); errors on ecosystems without constraint support (can be specified multiple times) - --dry-run Generate Dockerfile without building (stdout output unless -o is set) (default false) - -h, --help help for build + --dry-run[=true|false] Generate Dockerfile without building (stdout output unless -o is set) (default false) + -h, --help[=true|false] help for build -o, --output string Write the Dockerfile to the specified file instead of building (default builds an image instead of generating a Dockerfile) -t, --tag string Name and optionally a tag in the 'name:tag' format for the built image (default generates a unique image name based on the package and transport type) ``` @@ -63,7 +63,7 @@ thv build [flags] PROTOCOL [-- ARGS...] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client.md b/docs/toolhive/reference/cli/thv_client.md index 76a06ba99..203a318bf 100644 --- a/docs/toolhive/reference/cli/thv_client.md +++ b/docs/toolhive/reference/cli/thv_client.md @@ -20,13 +20,13 @@ The client command provides subcommands to manage MCP client integrations. ### Options ``` - -h, --help help for client + -h, --help[=true|false] help for client ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_connector.md b/docs/toolhive/reference/cli/thv_client_connector.md index 03f3c1acf..d8fbf1d94 100644 --- a/docs/toolhive/reference/cli/thv_client_connector.md +++ b/docs/toolhive/reference/cli/thv_client_connector.md @@ -32,14 +32,14 @@ Re-running "thv llm setup --client claude-desktop" keeps existing connectors. ### Options ``` - --client string Client to configure (supported: claude-desktop) - -h, --help help for connector + --client string Client to configure (supported: claude-desktop) + -h, --help[=true|false] help for connector ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_connector_add.md b/docs/toolhive/reference/cli/thv_client_connector_add.md index d42d00a4c..d918d6fde 100644 --- a/docs/toolhive/reference/cli/thv_client_connector_add.md +++ b/docs/toolhive/reference/cli/thv_client_connector_add.md @@ -37,14 +37,14 @@ thv client connector add NAME URL [flags] ### Options ``` - -h, --help help for add + -h, --help[=true|false] help for add ``` ### Options inherited from parent commands ``` - --client string Client to configure (supported: claude-desktop) - --debug Enable debug mode + --client string Client to configure (supported: claude-desktop) + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_connector_list.md b/docs/toolhive/reference/cli/thv_client_connector_list.md index cda72f4ba..a2cb4b94c 100644 --- a/docs/toolhive/reference/cli/thv_client_connector_list.md +++ b/docs/toolhive/reference/cli/thv_client_connector_list.md @@ -20,15 +20,15 @@ thv client connector list [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for list + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for list ``` ### Options inherited from parent commands ``` - --client string Client to configure (supported: claude-desktop) - --debug Enable debug mode + --client string Client to configure (supported: claude-desktop) + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_connector_rm.md b/docs/toolhive/reference/cli/thv_client_connector_rm.md index 29ff55b30..f510fe475 100644 --- a/docs/toolhive/reference/cli/thv_client_connector_rm.md +++ b/docs/toolhive/reference/cli/thv_client_connector_rm.md @@ -20,14 +20,14 @@ thv client connector rm NAME [flags] ### Options ``` - -h, --help help for rm + -h, --help[=true|false] help for rm ``` ### Options inherited from parent commands ``` - --client string Client to configure (supported: claude-desktop) - --debug Enable debug mode + --client string Client to configure (supported: claude-desktop) + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_list-registered.md b/docs/toolhive/reference/cli/thv_client_list-registered.md index af3eb3afc..7e75ed1b3 100644 --- a/docs/toolhive/reference/cli/thv_client_list-registered.md +++ b/docs/toolhive/reference/cli/thv_client_list-registered.md @@ -24,13 +24,13 @@ thv client list-registered [flags] ### Options ``` - -h, --help help for list-registered + -h, --help[=true|false] help for list-registered ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_register.md b/docs/toolhive/reference/cli/thv_client_register.md index 8870beebc..4235ef8fc 100644 --- a/docs/toolhive/reference/cli/thv_client_register.md +++ b/docs/toolhive/reference/cli/thv_client_register.md @@ -52,14 +52,14 @@ thv client register [client] [flags] ### Options ``` - --group strings Only register workloads from specified groups (default [default]) - -h, --help help for register + --group strings Only register workloads from specified groups (default [default]) + -h, --help[=true|false] help for register ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_remove.md b/docs/toolhive/reference/cli/thv_client_remove.md index 55a30a8bb..2ba0dd81b 100644 --- a/docs/toolhive/reference/cli/thv_client_remove.md +++ b/docs/toolhive/reference/cli/thv_client_remove.md @@ -52,14 +52,14 @@ thv client remove [client] [flags] ### Options ``` - --group strings Remove client from specified groups (if not set, removes all workloads from the client) - -h, --help help for remove + --group strings Remove client from specified groups (if not set, removes all workloads from the client) + -h, --help[=true|false] help for remove ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_setup.md b/docs/toolhive/reference/cli/thv_client_setup.md index 09b6ed3fd..2b20c6a9d 100644 --- a/docs/toolhive/reference/cli/thv_client_setup.md +++ b/docs/toolhive/reference/cli/thv_client_setup.md @@ -24,13 +24,13 @@ thv client setup [flags] ### Options ``` - -h, --help help for setup + -h, --help[=true|false] help for setup ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_client_status.md b/docs/toolhive/reference/cli/thv_client_status.md index 730afbb1d..5ad95d11d 100644 --- a/docs/toolhive/reference/cli/thv_client_status.md +++ b/docs/toolhive/reference/cli/thv_client_status.md @@ -24,13 +24,13 @@ thv client status [flags] ### Options ``` - -h, --help help for status + -h, --help[=true|false] help for status ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config.md b/docs/toolhive/reference/cli/thv_config.md index 00f3b1634..022f5f22f 100644 --- a/docs/toolhive/reference/cli/thv_config.md +++ b/docs/toolhive/reference/cli/thv_config.md @@ -20,13 +20,13 @@ The config command provides subcommands to manage application configuration sett ### Options ``` - -h, --help help for config + -h, --help[=true|false] help for config ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_get-build-auth-file.md b/docs/toolhive/reference/cli/thv_config_get-build-auth-file.md index 978776c30..d60446f15 100644 --- a/docs/toolhive/reference/cli/thv_config_get-build-auth-file.md +++ b/docs/toolhive/reference/cli/thv_config_get-build-auth-file.md @@ -34,14 +34,14 @@ thv config get-build-auth-file [name] [flags] ### Options ``` - -h, --help help for get-build-auth-file - --show-content Show the actual file content (contains credentials) (default false) + -h, --help[=true|false] help for get-build-auth-file + --show-content[=true|false] Show the actual file content (contains credentials) (default false) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_get-build-env.md b/docs/toolhive/reference/cli/thv_config_get-build-env.md index f0d6a269a..77c830785 100644 --- a/docs/toolhive/reference/cli/thv_config_get-build-env.md +++ b/docs/toolhive/reference/cli/thv_config_get-build-env.md @@ -30,13 +30,13 @@ thv config get-build-env [KEY] [flags] ### Options ``` - -h, --help help for get-build-env + -h, --help[=true|false] help for get-build-env ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_get-ca-cert.md b/docs/toolhive/reference/cli/thv_config_get-ca-cert.md index 755e519eb..79fb49034 100644 --- a/docs/toolhive/reference/cli/thv_config_get-ca-cert.md +++ b/docs/toolhive/reference/cli/thv_config_get-ca-cert.md @@ -24,13 +24,13 @@ thv config get-ca-cert [flags] ### Options ``` - -h, --help help for get-ca-cert + -h, --help[=true|false] help for get-ca-cert ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_get-registry.md b/docs/toolhive/reference/cli/thv_config_get-registry.md index d78b66ff5..4bb7ab05b 100644 --- a/docs/toolhive/reference/cli/thv_config_get-registry.md +++ b/docs/toolhive/reference/cli/thv_config_get-registry.md @@ -24,13 +24,13 @@ thv config get-registry [flags] ### Options ``` - -h, --help help for get-registry + -h, --help[=true|false] help for get-registry ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel.md b/docs/toolhive/reference/cli/thv_config_otel.md index 24781da35..1ff1ec96d 100644 --- a/docs/toolhive/reference/cli/thv_config_otel.md +++ b/docs/toolhive/reference/cli/thv_config_otel.md @@ -20,13 +20,13 @@ Configure OpenTelemetry settings for observability and monitoring of MCP servers ### Options ``` - -h, --help help for otel + -h, --help[=true|false] help for otel ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-enable-prometheus-metrics-path.md b/docs/toolhive/reference/cli/thv_config_otel_get-enable-prometheus-metrics-path.md index 7930a07f5..30ce4596b 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_get-enable-prometheus-metrics-path.md +++ b/docs/toolhive/reference/cli/thv_config_otel_get-enable-prometheus-metrics-path.md @@ -24,13 +24,13 @@ thv config otel get-enable-prometheus-metrics-path [flags] ### Options ``` - -h, --help help for get-enable-prometheus-metrics-path + -h, --help[=true|false] help for get-enable-prometheus-metrics-path ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-endpoint.md b/docs/toolhive/reference/cli/thv_config_otel_get-endpoint.md index f3d4f7ad1..682cf57a3 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_get-endpoint.md +++ b/docs/toolhive/reference/cli/thv_config_otel_get-endpoint.md @@ -24,13 +24,13 @@ thv config otel get-endpoint [flags] ### Options ``` - -h, --help help for get-endpoint + -h, --help[=true|false] help for get-endpoint ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-env-vars.md b/docs/toolhive/reference/cli/thv_config_otel_get-env-vars.md index bfb107e3e..ec860fc24 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_get-env-vars.md +++ b/docs/toolhive/reference/cli/thv_config_otel_get-env-vars.md @@ -24,13 +24,13 @@ thv config otel get-env-vars [flags] ### Options ``` - -h, --help help for get-env-vars + -h, --help[=true|false] help for get-env-vars ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-insecure.md b/docs/toolhive/reference/cli/thv_config_otel_get-insecure.md index bea3eea3c..a1e7d9c4b 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_get-insecure.md +++ b/docs/toolhive/reference/cli/thv_config_otel_get-insecure.md @@ -24,13 +24,13 @@ thv config otel get-insecure [flags] ### Options ``` - -h, --help help for get-insecure + -h, --help[=true|false] help for get-insecure ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-metrics-enabled.md b/docs/toolhive/reference/cli/thv_config_otel_get-metrics-enabled.md index 656d463a1..36d6b539f 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_get-metrics-enabled.md +++ b/docs/toolhive/reference/cli/thv_config_otel_get-metrics-enabled.md @@ -24,13 +24,13 @@ thv config otel get-metrics-enabled [flags] ### Options ``` - -h, --help help for get-metrics-enabled + -h, --help[=true|false] help for get-metrics-enabled ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-sampling-rate.md b/docs/toolhive/reference/cli/thv_config_otel_get-sampling-rate.md index adc9b44dd..a414defe3 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_get-sampling-rate.md +++ b/docs/toolhive/reference/cli/thv_config_otel_get-sampling-rate.md @@ -24,13 +24,13 @@ thv config otel get-sampling-rate [flags] ### Options ``` - -h, --help help for get-sampling-rate + -h, --help[=true|false] help for get-sampling-rate ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-tracing-enabled.md b/docs/toolhive/reference/cli/thv_config_otel_get-tracing-enabled.md index d817f26de..27269e2bc 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_get-tracing-enabled.md +++ b/docs/toolhive/reference/cli/thv_config_otel_get-tracing-enabled.md @@ -24,13 +24,13 @@ thv config otel get-tracing-enabled [flags] ### Options ``` - -h, --help help for get-tracing-enabled + -h, --help[=true|false] help for get-tracing-enabled ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-enable-prometheus-metrics-path.md b/docs/toolhive/reference/cli/thv_config_otel_set-enable-prometheus-metrics-path.md index 189ecf5a9..2f0f2b878 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_set-enable-prometheus-metrics-path.md +++ b/docs/toolhive/reference/cli/thv_config_otel_set-enable-prometheus-metrics-path.md @@ -26,13 +26,13 @@ thv config otel set-enable-prometheus-metrics-path [flags] ### Options ``` - -h, --help help for set-enable-prometheus-metrics-path + -h, --help[=true|false] help for set-enable-prometheus-metrics-path ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-endpoint.md b/docs/toolhive/reference/cli/thv_config_otel_set-endpoint.md index 49cf5a4e5..8a903357f 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_set-endpoint.md +++ b/docs/toolhive/reference/cli/thv_config_otel_set-endpoint.md @@ -30,13 +30,13 @@ thv config otel set-endpoint [flags] ### Options ``` - -h, --help help for set-endpoint + -h, --help[=true|false] help for set-endpoint ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-env-vars.md b/docs/toolhive/reference/cli/thv_config_otel_set-env-vars.md index cc84588a7..20b938937 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_set-env-vars.md +++ b/docs/toolhive/reference/cli/thv_config_otel_set-env-vars.md @@ -30,13 +30,13 @@ thv config otel set-env-vars [flags] ### Options ``` - -h, --help help for set-env-vars + -h, --help[=true|false] help for set-env-vars ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-insecure.md b/docs/toolhive/reference/cli/thv_config_otel_set-insecure.md index d60d698c7..412eb67b8 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_set-insecure.md +++ b/docs/toolhive/reference/cli/thv_config_otel_set-insecure.md @@ -26,13 +26,13 @@ thv config otel set-insecure [flags] ### Options ``` - -h, --help help for set-insecure + -h, --help[=true|false] help for set-insecure ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-metrics-enabled.md b/docs/toolhive/reference/cli/thv_config_otel_set-metrics-enabled.md index 7fb0305b3..252fed255 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_set-metrics-enabled.md +++ b/docs/toolhive/reference/cli/thv_config_otel_set-metrics-enabled.md @@ -26,13 +26,13 @@ thv config otel set-metrics-enabled [flags] ### Options ``` - -h, --help help for set-metrics-enabled + -h, --help[=true|false] help for set-metrics-enabled ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-sampling-rate.md b/docs/toolhive/reference/cli/thv_config_otel_set-sampling-rate.md index f8a734711..0fa634842 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_set-sampling-rate.md +++ b/docs/toolhive/reference/cli/thv_config_otel_set-sampling-rate.md @@ -30,13 +30,13 @@ thv config otel set-sampling-rate [flags] ### Options ``` - -h, --help help for set-sampling-rate + -h, --help[=true|false] help for set-sampling-rate ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-tracing-enabled.md b/docs/toolhive/reference/cli/thv_config_otel_set-tracing-enabled.md index fb02fbee3..4de642195 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_set-tracing-enabled.md +++ b/docs/toolhive/reference/cli/thv_config_otel_set-tracing-enabled.md @@ -26,13 +26,13 @@ thv config otel set-tracing-enabled [flags] ### Options ``` - -h, --help help for set-tracing-enabled + -h, --help[=true|false] help for set-tracing-enabled ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-enable-prometheus-metrics-path.md b/docs/toolhive/reference/cli/thv_config_otel_unset-enable-prometheus-metrics-path.md index b583a7d9c..c2004ea25 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_unset-enable-prometheus-metrics-path.md +++ b/docs/toolhive/reference/cli/thv_config_otel_unset-enable-prometheus-metrics-path.md @@ -24,13 +24,13 @@ thv config otel unset-enable-prometheus-metrics-path [flags] ### Options ``` - -h, --help help for unset-enable-prometheus-metrics-path + -h, --help[=true|false] help for unset-enable-prometheus-metrics-path ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-endpoint.md b/docs/toolhive/reference/cli/thv_config_otel_unset-endpoint.md index 391a64de1..39107b526 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_unset-endpoint.md +++ b/docs/toolhive/reference/cli/thv_config_otel_unset-endpoint.md @@ -24,13 +24,13 @@ thv config otel unset-endpoint [flags] ### Options ``` - -h, --help help for unset-endpoint + -h, --help[=true|false] help for unset-endpoint ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-env-vars.md b/docs/toolhive/reference/cli/thv_config_otel_unset-env-vars.md index 561a52f5b..b07a1c0ab 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_unset-env-vars.md +++ b/docs/toolhive/reference/cli/thv_config_otel_unset-env-vars.md @@ -24,13 +24,13 @@ thv config otel unset-env-vars [flags] ### Options ``` - -h, --help help for unset-env-vars + -h, --help[=true|false] help for unset-env-vars ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-insecure.md b/docs/toolhive/reference/cli/thv_config_otel_unset-insecure.md index 3e31d7372..84bfabd85 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_unset-insecure.md +++ b/docs/toolhive/reference/cli/thv_config_otel_unset-insecure.md @@ -24,13 +24,13 @@ thv config otel unset-insecure [flags] ### Options ``` - -h, --help help for unset-insecure + -h, --help[=true|false] help for unset-insecure ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-metrics-enabled.md b/docs/toolhive/reference/cli/thv_config_otel_unset-metrics-enabled.md index cd7c9812b..9cd05e54d 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_unset-metrics-enabled.md +++ b/docs/toolhive/reference/cli/thv_config_otel_unset-metrics-enabled.md @@ -24,13 +24,13 @@ thv config otel unset-metrics-enabled [flags] ### Options ``` - -h, --help help for unset-metrics-enabled + -h, --help[=true|false] help for unset-metrics-enabled ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-sampling-rate.md b/docs/toolhive/reference/cli/thv_config_otel_unset-sampling-rate.md index 56de17cf2..d98b5e4eb 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_unset-sampling-rate.md +++ b/docs/toolhive/reference/cli/thv_config_otel_unset-sampling-rate.md @@ -24,13 +24,13 @@ thv config otel unset-sampling-rate [flags] ### Options ``` - -h, --help help for unset-sampling-rate + -h, --help[=true|false] help for unset-sampling-rate ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-tracing-enabled.md b/docs/toolhive/reference/cli/thv_config_otel_unset-tracing-enabled.md index fe449100d..714717ea4 100644 --- a/docs/toolhive/reference/cli/thv_config_otel_unset-tracing-enabled.md +++ b/docs/toolhive/reference/cli/thv_config_otel_unset-tracing-enabled.md @@ -24,13 +24,13 @@ thv config otel unset-tracing-enabled [flags] ### Options ``` - -h, --help help for unset-tracing-enabled + -h, --help[=true|false] help for unset-tracing-enabled ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_set-build-auth-file.md b/docs/toolhive/reference/cli/thv_config_set-build-auth-file.md index 0165a9787..4bc353e6f 100644 --- a/docs/toolhive/reference/cli/thv_config_set-build-auth-file.md +++ b/docs/toolhive/reference/cli/thv_config_set-build-auth-file.md @@ -47,14 +47,14 @@ thv config set-build-auth-file [content] [flags] ### Options ``` - -h, --help help for set-build-auth-file - --stdin Read file content from stdin instead of command line argument (default false) + -h, --help[=true|false] help for set-build-auth-file + --stdin[=true|false] Read file content from stdin instead of command line argument (default false) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_set-build-env.md b/docs/toolhive/reference/cli/thv_config_set-build-env.md index 86c37c84d..b9fcf21ca 100644 --- a/docs/toolhive/reference/cli/thv_config_set-build-env.md +++ b/docs/toolhive/reference/cli/thv_config_set-build-env.md @@ -48,15 +48,15 @@ thv config set-build-env [value] [flags] ### Options ``` - --from-env Read value from shell environment at build time - --from-secret Read value from a ToolHive secret at build time (value argument becomes secret name) - -h, --help help for set-build-env + --from-env[=true|false] Read value from shell environment at build time + --from-secret[=true|false] Read value from a ToolHive secret at build time (value argument becomes secret name) + -h, --help[=true|false] help for set-build-env ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_set-ca-cert.md b/docs/toolhive/reference/cli/thv_config_set-ca-cert.md index 9985113f3..041ed8f27 100644 --- a/docs/toolhive/reference/cli/thv_config_set-ca-cert.md +++ b/docs/toolhive/reference/cli/thv_config_set-ca-cert.md @@ -28,13 +28,13 @@ thv config set-ca-cert [flags] ### Options ``` - -h, --help help for set-ca-cert + -h, --help[=true|false] help for set-ca-cert ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_set-registry.md b/docs/toolhive/reference/cli/thv_config_set-registry.md index d5a1f079e..5f0ffed37 100644 --- a/docs/toolhive/reference/cli/thv_config_set-registry.md +++ b/docs/toolhive/reference/cli/thv_config_set-registry.md @@ -39,18 +39,18 @@ thv config set-registry [flags] ### Options ``` - -p, --allow-private-ip Allow setting the registry URL or API endpoint, even if it references a private IP address (default false) - --audience string OAuth audience parameter for registry authentication - --client-id string OAuth client ID for registry authentication - -h, --help help for set-registry - --issuer string OIDC issuer URL for registry authentication - --scopes strings OAuth scopes for registry authentication (default [openid,offline_access]) + -p, --allow-private-ip[=true|false] Allow setting the registry URL or API endpoint, even if it references a private IP address (default false) + --audience string OAuth audience parameter for registry authentication + --client-id string OAuth client ID for registry authentication + -h, --help[=true|false] help for set-registry + --issuer string OIDC issuer URL for registry authentication + --scopes strings OAuth scopes for registry authentication (default [openid,offline_access]) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_unset-build-auth-file.md b/docs/toolhive/reference/cli/thv_config_unset-build-auth-file.md index 4e04166fb..2eae5afe4 100644 --- a/docs/toolhive/reference/cli/thv_config_unset-build-auth-file.md +++ b/docs/toolhive/reference/cli/thv_config_unset-build-auth-file.md @@ -28,14 +28,14 @@ thv config unset-build-auth-file [name] [flags] ### Options ``` - --all Remove all build auth files - -h, --help help for unset-build-auth-file + --all[=true|false] Remove all build auth files + -h, --help[=true|false] help for unset-build-auth-file ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_unset-build-env.md b/docs/toolhive/reference/cli/thv_config_unset-build-env.md index 4078e18d0..dc888de68 100644 --- a/docs/toolhive/reference/cli/thv_config_unset-build-env.md +++ b/docs/toolhive/reference/cli/thv_config_unset-build-env.md @@ -28,14 +28,14 @@ thv config unset-build-env [KEY] [flags] ### Options ``` - --all Remove all build environment variables - -h, --help help for unset-build-env + --all[=true|false] Remove all build environment variables + -h, --help[=true|false] help for unset-build-env ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_unset-ca-cert.md b/docs/toolhive/reference/cli/thv_config_unset-ca-cert.md index 40a9c787c..56d33a28f 100644 --- a/docs/toolhive/reference/cli/thv_config_unset-ca-cert.md +++ b/docs/toolhive/reference/cli/thv_config_unset-ca-cert.md @@ -24,13 +24,13 @@ thv config unset-ca-cert [flags] ### Options ``` - -h, --help help for unset-ca-cert + -h, --help[=true|false] help for unset-ca-cert ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_unset-registry.md b/docs/toolhive/reference/cli/thv_config_unset-registry.md index 06b99a9b1..c1b255d37 100644 --- a/docs/toolhive/reference/cli/thv_config_unset-registry.md +++ b/docs/toolhive/reference/cli/thv_config_unset-registry.md @@ -24,13 +24,13 @@ thv config unset-registry [flags] ### Options ``` - -h, --help help for unset-registry + -h, --help[=true|false] help for unset-registry ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_config_usage-metrics.md b/docs/toolhive/reference/cli/thv_config_usage-metrics.md index 9fa161e58..906c67a7d 100644 --- a/docs/toolhive/reference/cli/thv_config_usage-metrics.md +++ b/docs/toolhive/reference/cli/thv_config_usage-metrics.md @@ -20,13 +20,13 @@ thv config usage-metrics [flags] ### Options ``` - -h, --help help for usage-metrics + -h, --help[=true|false] help for usage-metrics ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_export.md b/docs/toolhive/reference/cli/thv_export.md index db3fd7f55..6e70a3965 100644 --- a/docs/toolhive/reference/cli/thv_export.md +++ b/docs/toolhive/reference/cli/thv_export.md @@ -42,14 +42,14 @@ thv export [flags] ### Options ``` - --format string Export format: json or k8s (default "json") - -h, --help help for export + --format string Export format: json or k8s (default "json") + -h, --help[=true|false] help for export ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_group.md b/docs/toolhive/reference/cli/thv_group.md index d0ec552cd..bb1e4e143 100644 --- a/docs/toolhive/reference/cli/thv_group.md +++ b/docs/toolhive/reference/cli/thv_group.md @@ -20,13 +20,13 @@ The group command provides subcommands to manage logical groupings of MCP server ### Options ``` - -h, --help help for group + -h, --help[=true|false] help for group ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_group_create.md b/docs/toolhive/reference/cli/thv_group_create.md index 8338deb69..723a5f5dd 100644 --- a/docs/toolhive/reference/cli/thv_group_create.md +++ b/docs/toolhive/reference/cli/thv_group_create.md @@ -25,13 +25,13 @@ thv group create [group-name] [flags] ### Options ``` - -h, --help help for create + -h, --help[=true|false] help for create ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_group_list.md b/docs/toolhive/reference/cli/thv_group_list.md index 07acb9b5a..fd8f01b5b 100644 --- a/docs/toolhive/reference/cli/thv_group_list.md +++ b/docs/toolhive/reference/cli/thv_group_list.md @@ -24,13 +24,13 @@ thv group list [flags] ### Options ``` - -h, --help help for list + -h, --help[=true|false] help for list ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_group_rm.md b/docs/toolhive/reference/cli/thv_group_rm.md index 42cac4b83..f6fb5d333 100644 --- a/docs/toolhive/reference/cli/thv_group_rm.md +++ b/docs/toolhive/reference/cli/thv_group_rm.md @@ -24,14 +24,14 @@ thv group rm [group-name] [flags] ### Options ``` - -h, --help help for rm - --with-workloads Delete all workloads in the group along with the group (default false) + -h, --help[=true|false] help for rm + --with-workloads[=true|false] Delete all workloads in the group along with the group (default false) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_inspector.md b/docs/toolhive/reference/cli/thv_inspector.md index 660af6ab0..70214de3d 100644 --- a/docs/toolhive/reference/cli/thv_inspector.md +++ b/docs/toolhive/reference/cli/thv_inspector.md @@ -24,7 +24,7 @@ thv inspector [workload-name] [flags] ### Options ``` - -h, --help help for inspector + -h, --help[=true|false] help for inspector -p, --mcp-proxy-port int Port to run the MCP Proxy on (default 6277) -u, --ui-port int Port to run the MCP Inspector UI on (default 6274) ``` @@ -32,7 +32,7 @@ thv inspector [workload-name] [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_list.md b/docs/toolhive/reference/cli/thv_list.md index 772073e13..676157a1d 100644 --- a/docs/toolhive/reference/cli/thv_list.md +++ b/docs/toolhive/reference/cli/thv_list.md @@ -40,18 +40,18 @@ thv list [flags] ### Options ``` - -a, --all Show all workloads (default shows running and auth_retrying) - --check-upgrades Check each workload for available upgrades against its source registry (performs a registry lookup) - --format string Output format (json, text, mcpservers) (default "text") - --group string Filter by group - -h, --help help for list - -l, --label stringArray Filter workloads by labels (format: key=value) + -a, --all[=true|false] Show all workloads (default shows running and auth_retrying) + --check-upgrades[=true|false] Check each workload for available upgrades against its source registry (performs a registry lookup) + --format string Output format (json, text, mcpservers) (default "text") + --group string Filter by group + -h, --help[=true|false] help for list + -l, --label stringArray Filter workloads by labels (format: key=value) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm.md b/docs/toolhive/reference/cli/thv_llm.md index b39471c6f..861d9118f 100644 --- a/docs/toolhive/reference/cli/thv_llm.md +++ b/docs/toolhive/reference/cli/thv_llm.md @@ -37,13 +37,13 @@ Use "thv llm config show" to view the current configuration. ### Options ``` - -h, --help help for llm + -h, --help[=true|false] help for llm ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_config.md b/docs/toolhive/reference/cli/thv_llm_config.md index bd8e65437..cf1fdb839 100644 --- a/docs/toolhive/reference/cli/thv_llm_config.md +++ b/docs/toolhive/reference/cli/thv_llm_config.md @@ -20,13 +20,13 @@ The config command provides subcommands to manage LLM gateway connection setting ### Options ``` - -h, --help help for config + -h, --help[=true|false] help for config ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_config_reset.md b/docs/toolhive/reference/cli/thv_llm_config_reset.md index 9b5402f9a..feea68d36 100644 --- a/docs/toolhive/reference/cli/thv_llm_config_reset.md +++ b/docs/toolhive/reference/cli/thv_llm_config_reset.md @@ -25,13 +25,13 @@ thv llm config reset [flags] ### Options ``` - -h, --help help for reset + -h, --help[=true|false] help for reset ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_config_set.md b/docs/toolhive/reference/cli/thv_llm_config_set.md index 1d629a09b..f0d2a2e08 100644 --- a/docs/toolhive/reference/cli/thv_llm_config_set.md +++ b/docs/toolhive/reference/cli/thv_llm_config_set.md @@ -30,25 +30,25 @@ thv llm config set [flags] ### Options ``` - --audience string OIDC audience (optional) - --bedrock-compat Persist Bedrock compatibility for Claude Code (CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 + per-tier Bedrock model IDs discovered from the gateway). Applied by "thv llm setup". Use --bedrock-compat=false to clear. - --callback-port int OIDC callback port (omit to keep current; default: ephemeral) - --client-id string OIDC client ID - --enable-1m With Bedrock compat, opt into the 1M context window by appending [1m] to opus/sonnet model IDs. - --gateway-url string LLM gateway base URL (must use HTTPS) - -h, --help help for set - --issuer string OIDC issuer URL - --models strings Model IDs to persist and apply during "thv llm setup", comma-separated or by repeating the flag, e.g. --models=us.anthropic.claude-opus-4-8,us.anthropic.claude-sonnet-5. Credential-helper clients (Claude Desktop) write these as inferenceModels; with Bedrock compat, each ID overrides a Claude Code tier by matching 'haiku', 'opus', 'sonnet', or 'fable' in the ID. - --proxy-port int Localhost proxy listen port (omit to keep current; default: 14000) - --scopes strings OIDC scopes to request, comma-separated or by repeating the flag. offline_access is always requested; pass openid explicitly if the provider needs it (the default scopes are openid and offline_access). Omit to keep the current scopes; an empty value restores the defaults. Changing the list clears cached tokens so the next sign-in requests the new scopes - --short-prompt-cache Use Claude Code's five-minute prompt cache instead of ToolHive's one-hour default. Applied by "thv llm setup"; use --short-prompt-cache=false to restore one-hour caching. - --tls-skip-verify Skip TLS certificate verification for the upstream gateway (local dev only; use --tls-skip-verify=false to clear) + --audience string OIDC audience (optional) + --bedrock-compat[=true|false] Persist Bedrock compatibility for Claude Code (CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 + per-tier Bedrock model IDs discovered from the gateway) and Codex (per-tier Bedrock GPT models + web_search disabled). Applied by "thv llm setup". Use --bedrock-compat=false to clear. + --callback-port int OIDC callback port (omit to keep current; default: ephemeral) + --client-id string OIDC client ID + --enable-1m[=true|false] With Bedrock compat, opt into the 1M context window by appending [1m] to opus/sonnet model IDs. + --gateway-url string LLM gateway base URL (must use HTTPS) + -h, --help[=true|false] help for set + --issuer string OIDC issuer URL + --models strings Model IDs to persist and apply during "thv llm setup", comma-separated or by repeating the flag, e.g. --models=us.anthropic.claude-opus-4-8,us.anthropic.claude-sonnet-5. Credential-helper clients (Claude Desktop) write these as inferenceModels; with Bedrock compat, each ID overrides a Claude Code tier by matching 'haiku', 'opus', 'sonnet', or 'fable' in the ID, and a us./global.openai.gpt-* ID a Codex tier by matching 'sol', 'terra', or 'luna'. + --proxy-port int Localhost proxy listen port (omit to keep current; default: 14000) + --scopes strings OIDC scopes to request, comma-separated or by repeating the flag. offline_access is always requested; pass openid explicitly if the provider needs it (the default scopes are openid and offline_access). Omit to keep the current scopes; an empty value restores the defaults. Changing the list clears cached tokens so the next sign-in requests the new scopes + --short-prompt-cache[=true|false] Use Claude Code's five-minute prompt cache instead of ToolHive's one-hour default. Applied by "thv llm setup"; use --short-prompt-cache=false to restore one-hour caching. + --tls-skip-verify[=true|false] Skip TLS certificate verification for the upstream gateway (local dev only; use --tls-skip-verify=false to clear) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_config_show.md b/docs/toolhive/reference/cli/thv_llm_config_show.md index f1e48b7c8..87e9a1725 100644 --- a/docs/toolhive/reference/cli/thv_llm_config_show.md +++ b/docs/toolhive/reference/cli/thv_llm_config_show.md @@ -20,14 +20,14 @@ thv llm config show [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for show + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for show ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_proxy.md b/docs/toolhive/reference/cli/thv_llm_proxy.md index bdb8a3f38..0d4f73884 100644 --- a/docs/toolhive/reference/cli/thv_llm_proxy.md +++ b/docs/toolhive/reference/cli/thv_llm_proxy.md @@ -16,13 +16,13 @@ Manage the LLM gateway localhost proxy ### Options ``` - -h, --help help for proxy + -h, --help[=true|false] help for proxy ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_proxy_start.md b/docs/toolhive/reference/cli/thv_llm_proxy_start.md index 9eee37312..97f5626a8 100644 --- a/docs/toolhive/reference/cli/thv_llm_proxy_start.md +++ b/docs/toolhive/reference/cli/thv_llm_proxy_start.md @@ -30,15 +30,15 @@ thv llm proxy start [flags] ### Options ``` - -h, --help help for start - --skip-browser Print the OIDC authorization URL instead of opening a browser, then wait for the callback. Use in headless/SSH/CI environments where no system browser is available. - --tls-skip-verify Skip TLS certificate verification for the upstream gateway (overrides stored config; local dev only) + -h, --help[=true|false] help for start + --skip-browser[=true|false] Print the OIDC authorization URL instead of opening a browser, then wait for the callback. Use in headless/SSH/CI environments where no system browser is available. + --tls-skip-verify[=true|false] Skip TLS certificate verification for the upstream gateway (overrides stored config; local dev only) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_setup.md b/docs/toolhive/reference/cli/thv_llm_setup.md index ac10357dd..2462e21ed 100644 --- a/docs/toolhive/reference/cli/thv_llm_setup.md +++ b/docs/toolhive/reference/cli/thv_llm_setup.md @@ -69,11 +69,32 @@ also enables Claude Code's gateway model discovery, which adds any further model the gateway serves as separate picker rows without re-running setup. If the gateway's model list cannot be fetched, or has no Bedrock model IDs, setup does not configure Claude Code (unless --models pins every tier). The setting is -persisted and only affects Claude Code. +persisted and affects Claude Code and Codex. To add it to an already-configured Claude Code, re-run: thv llm setup --client claude-code --bedrock-compat +With --bedrock-compat, Codex is pinned per tier to the newest Bedrock GPT model +of each family the gateway lists: sol as the main model (top-level model in +config.toml, with its context window as model_context_window when the gateway +reports one), and terra and luna as the background memory models +(memories.consolidation_model and memories.extract_model). Without a sol model +the main model is terra, then luna, and a memory tier the gateway has no model +for uses the main model. web_search is set to +"disabled", because Bedrock rejects Codex's hosted web search tool. Only the +closed GPT models served through us. or global. inference profiles (e.g. +us.openai.gpt-6.1-sol) speak the Responses API Codex uses; the open-weight +models (nvidia.*, qwen.*, deepseek.*, openai.gpt-oss-*) serve only Chat +Completions, so setup never picks them for Codex, and a --models entry naming +one is left to the other tools that can use it. Override a tier with --models: + + thv llm setup --client codex --bedrock-compat --models us.openai.gpt-6.1-sol + +Like Claude Code's Bedrock keys, these Codex keys belong to ToolHive once a +setup with --bedrock-compat has written them: a later setup without it and +"thv llm teardown" remove them, whatever they hold, and warn which keys they +removed. If no Bedrock setup wrote them, they are left as you set them. + Re-running is idempotent and uses the cached token (no browser prompt). Run "thv llm teardown" to revert all changes. @@ -85,29 +106,29 @@ thv llm setup [flags] ### Options ``` - --anthropic-path-prefix string Path prefix appended to the gateway URL for Anthropic API tools (e.g. /anthropic). Also used for Pi model discovery. When omitted, the gateway is probed automatically. - --audience string OIDC audience (optional) - --bedrock-compat Configure Claude Code for a gateway that forwards to AWS Bedrock: write CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 (Bedrock rejects the experimental anthropic-beta headers) and pin each tier to the newest Bedrock model the gateway advertises (override with --models). Persisted, so a later plain "thv llm setup" keeps it; clear with --bedrock-compat=false. Only affects Claude Code. - --callback-port int OIDC callback port (omit to keep current; default: ephemeral) - --client string Configure only this AI tool by name (e.g. claude-code, cursor, codex). Omit to configure all detected tools. - --client-id string OIDC client ID - --enable-1m With --bedrock-compat, append the [1m] suffix to the opus and sonnet model IDs to opt into the 1M-token context window on Bedrock (never haiku, which is 200K). Off by default. - --gateway-url string LLM gateway base URL (must use HTTPS) - -h, --help help for setup - --issuer string OIDC issuer URL - --lazy Skip the interactive OIDC login and defer it until the first time a configured tool accesses the gateway. Tool config and persisted settings are written normally. Useful for unattended provisioning (e.g. an MDM profile). - --models strings Model IDs to configure, comma-separated or by repeating the flag, e.g. --models=us.anthropic.claude-opus-4-8,us.anthropic.claude-sonnet-5. For Pi these filter its discovered models (Pi does not support --lazy). For credential-helper clients (Claude Desktop) these become inferenceModels. With --bedrock-compat, each ID overrides a Claude Code tier by matching 'haiku', 'opus', 'sonnet', or 'fable' in the ID (IDs matching no tier are ignored with a warning). Omit to pin each tier to the newest Bedrock model discovered from the gateway. - --proxy-port int Localhost proxy listen port (omit to keep current; default: 14000) - --scopes strings OIDC scopes to request, comma-separated or by repeating the flag. offline_access is always requested; pass openid explicitly if the provider needs it (the default scopes are openid and offline_access). Omit to keep the current scopes; an empty value restores the defaults. Changing the list clears cached tokens so the next sign-in requests the new scopes - --short-prompt-cache Use Claude Code's five-minute prompt cache instead of ToolHive's one-hour default. Persisted, so a later plain "thv llm setup" keeps it; use --short-prompt-cache=false to restore one-hour caching. - --skip-browser Print the OIDC authorization URL instead of opening a browser, then wait for the callback. Use in headless/SSH/CI environments where no system browser is available. - --tls-skip-verify Skip TLS certificate verification for the upstream gateway (local dev only). For direct-mode tools (Claude Code, Gemini CLI) this sets NODE_TLS_REJECT_UNAUTHORIZED=0, disabling TLS for ALL of that tool's outbound connections. For proxy-mode tools only the proxy-to-gateway connection is affected. + --anthropic-path-prefix string Path prefix appended to the gateway URL for Anthropic API tools (e.g. /anthropic). Also used for Pi model discovery. When omitted, the gateway is probed automatically. + --audience string OIDC audience (optional) + --bedrock-compat[=true|false] Configure Claude Code for a gateway that forwards to AWS Bedrock: write CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 (Bedrock rejects the experimental anthropic-beta headers) and pin each tier to the newest Bedrock model the gateway advertises (override with --models). For Codex, pin the newest Bedrock GPT model per tier (sol main, terra and luna for memories) and set web_search = "disabled". Persisted, so a later plain "thv llm setup" keeps it; clear with --bedrock-compat=false. Only affects Claude Code and Codex. + --callback-port int OIDC callback port (omit to keep current; default: ephemeral) + --client string Configure only this AI tool by name (e.g. claude-code, cursor, codex). Omit to configure all detected tools. + --client-id string OIDC client ID + --enable-1m[=true|false] With --bedrock-compat, append the [1m] suffix to the opus and sonnet model IDs to opt into the 1M-token context window on Bedrock (never haiku, which is 200K). Off by default. + --gateway-url string LLM gateway base URL (must use HTTPS) + -h, --help[=true|false] help for setup + --issuer string OIDC issuer URL + --lazy[=true|false] Skip the interactive OIDC login and defer it until the first time a configured tool accesses the gateway. Tool config and persisted settings are written normally. Useful for unattended provisioning (e.g. an MDM profile). + --models strings Model IDs to configure, comma-separated or by repeating the flag, e.g. --models=us.anthropic.claude-opus-4-8,us.anthropic.claude-sonnet-5. For Pi these filter its discovered models (Pi does not support --lazy). For credential-helper clients (Claude Desktop) these become inferenceModels. With --bedrock-compat, each ID overrides a Claude Code tier by matching 'haiku', 'opus', 'sonnet', or 'fable' in the ID (IDs matching no tier are ignored with a warning), and a us./global.openai.gpt-* ID overrides a Codex tier by matching 'sol', 'terra', or 'luna' (an ID naming none pins the main model; openai.gpt-oss-* and other vendors' IDs are left to other tools). Omit to pin each tier, and Codex, to the newest Bedrock model discovered from the gateway. + --proxy-port int Localhost proxy listen port (omit to keep current; default: 14000) + --scopes strings OIDC scopes to request, comma-separated or by repeating the flag. offline_access is always requested; pass openid explicitly if the provider needs it (the default scopes are openid and offline_access). Omit to keep the current scopes; an empty value restores the defaults. Changing the list clears cached tokens so the next sign-in requests the new scopes + --short-prompt-cache[=true|false] Use Claude Code's five-minute prompt cache instead of ToolHive's one-hour default. Persisted, so a later plain "thv llm setup" keeps it; use --short-prompt-cache=false to restore one-hour caching. + --skip-browser[=true|false] Print the OIDC authorization URL instead of opening a browser, then wait for the callback. Use in headless/SSH/CI environments where no system browser is available. + --tls-skip-verify[=true|false] Skip TLS certificate verification for the upstream gateway (local dev only). For direct-mode tools (Claude Code, Gemini CLI) this sets NODE_TLS_REJECT_UNAUTHORIZED=0, disabling TLS for ALL of that tool's outbound connections. For proxy-mode tools only the proxy-to-gateway connection is affected. ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_teardown.md b/docs/toolhive/reference/cli/thv_llm_teardown.md index 788953a51..314cbca54 100644 --- a/docs/toolhive/reference/cli/thv_llm_teardown.md +++ b/docs/toolhive/reference/cli/thv_llm_teardown.md @@ -36,16 +36,16 @@ thv llm teardown [tool-name] [flags] ### Options ``` - --client string Remove configuration for only this AI tool by name (e.g. claude-code, cursor). Omit to revert all configured tools. - -h, --help help for teardown - --keep-tokens Retain cached OIDC tokens when no configured tools remain - --purge-tokens Delete cached OIDC tokens even when other tools remain configured + --client string Remove configuration for only this AI tool by name (e.g. claude-code, cursor). Omit to revert all configured tools. + -h, --help[=true|false] help for teardown + --keep-tokens[=true|false] Retain cached OIDC tokens when no configured tools remain + --purge-tokens[=true|false] Delete cached OIDC tokens even when other tools remain configured ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_llm_token.md b/docs/toolhive/reference/cli/thv_llm_token.md index f4f9dc73e..143f4ced0 100644 --- a/docs/toolhive/reference/cli/thv_llm_token.md +++ b/docs/toolhive/reference/cli/thv_llm_token.md @@ -29,14 +29,14 @@ thv llm token [flags] ### Options ``` - -h, --help help for token - --skip-browser Print the OIDC authorization URL instead of opening a browser, then wait for the callback. Use in headless/SSH/CI environments where no system browser is available. + -h, --help[=true|false] help for token + --skip-browser[=true|false] Print the OIDC authorization URL instead of opening a browser, then wait for the callback. Use in headless/SSH/CI environments where no system browser is available. ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_logs.md b/docs/toolhive/reference/cli/thv_logs.md index 2dbeecb88..333435e06 100644 --- a/docs/toolhive/reference/cli/thv_logs.md +++ b/docs/toolhive/reference/cli/thv_logs.md @@ -40,15 +40,15 @@ thv logs [workload-name|prune] [flags] ### Options ``` - -f, --follow Follow log output (only for workload logs) (default false) - -h, --help help for logs - -p, --proxy Show proxy logs instead of container logs (default false) + -f, --follow[=true|false] Follow log output (only for workload logs) (default false) + -h, --help[=true|false] help for logs + -p, --proxy[=true|false] Show proxy logs instead of container logs (default false) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_logs_prune.md b/docs/toolhive/reference/cli/thv_logs_prune.md index 93a5dc362..66f16028d 100644 --- a/docs/toolhive/reference/cli/thv_logs_prune.md +++ b/docs/toolhive/reference/cli/thv_logs_prune.md @@ -25,13 +25,13 @@ thv logs prune [flags] ### Options ``` - -h, --help help for prune + -h, --help[=true|false] help for prune ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_mcp.md b/docs/toolhive/reference/cli/thv_mcp.md index d77dbcbf8..7041f5bb8 100644 --- a/docs/toolhive/reference/cli/thv_mcp.md +++ b/docs/toolhive/reference/cli/thv_mcp.md @@ -20,13 +20,13 @@ The mcp command provides subcommands to interact with MCP (Model Context Protoco ### Options ``` - -h, --help help for mcp + -h, --help[=true|false] help for mcp ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_mcp_call.md b/docs/toolhive/reference/cli/thv_mcp_call.md index 0973192fd..670bcaeb5 100644 --- a/docs/toolhive/reference/cli/thv_mcp_call.md +++ b/docs/toolhive/reference/cli/thv_mcp_call.md @@ -32,20 +32,20 @@ thv mcp call [flags] ### Options ``` - --args string Tool arguments as a JSON object literal - --args-file string Path to a file containing a JSON object of tool arguments (use '-' to read from stdin) - --format string Output format (json, text) (default "text") - -h, --help help for call - --ignore-tool-error Exit zero even when the tool reports an error (default is non-zero) - --server string MCP server URL or name from ToolHive registry (required) - --timeout duration Connection timeout (default 30s) - --transport string Transport type (auto, sse, streamable-http) (default "auto") + --args string Tool arguments as a JSON object literal + --args-file string Path to a file containing a JSON object of tool arguments (use '-' to read from stdin) + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for call + --ignore-tool-error[=true|false] Exit zero even when the tool reports an error (default is non-zero) + --server string MCP server URL or name from ToolHive registry (required) + --timeout duration Connection timeout (default 30s) + --transport string Transport type (auto, sse, streamable-http) (default "auto") ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_mcp_list.md b/docs/toolhive/reference/cli/thv_mcp_list.md index e74c8083e..d118b25d5 100644 --- a/docs/toolhive/reference/cli/thv_mcp_list.md +++ b/docs/toolhive/reference/cli/thv_mcp_list.md @@ -24,17 +24,17 @@ thv mcp list [tools|resources|prompts] [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for list - --server string MCP server URL or name from ToolHive registry (required) - --timeout duration Connection timeout (default 30s) - --transport string Transport type (auto, sse, streamable-http) (default "auto") + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for list + --server string MCP server URL or name from ToolHive registry (required) + --timeout duration Connection timeout (default 30s) + --transport string Transport type (auto, sse, streamable-http) (default "auto") ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_mcp_list_prompts.md b/docs/toolhive/reference/cli/thv_mcp_list_prompts.md index ed8584715..d1bde8387 100644 --- a/docs/toolhive/reference/cli/thv_mcp_list_prompts.md +++ b/docs/toolhive/reference/cli/thv_mcp_list_prompts.md @@ -24,17 +24,17 @@ thv mcp list prompts [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for prompts - --server string MCP server URL or name from ToolHive registry (required) - --timeout duration Connection timeout (default 30s) - --transport string Transport type (auto, sse, streamable-http) (default "auto") + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for prompts + --server string MCP server URL or name from ToolHive registry (required) + --timeout duration Connection timeout (default 30s) + --transport string Transport type (auto, sse, streamable-http) (default "auto") ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_mcp_list_resources.md b/docs/toolhive/reference/cli/thv_mcp_list_resources.md index 665512792..3345da66e 100644 --- a/docs/toolhive/reference/cli/thv_mcp_list_resources.md +++ b/docs/toolhive/reference/cli/thv_mcp_list_resources.md @@ -24,17 +24,17 @@ thv mcp list resources [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for resources - --server string MCP server URL or name from ToolHive registry (required) - --timeout duration Connection timeout (default 30s) - --transport string Transport type (auto, sse, streamable-http) (default "auto") + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for resources + --server string MCP server URL or name from ToolHive registry (required) + --timeout duration Connection timeout (default 30s) + --transport string Transport type (auto, sse, streamable-http) (default "auto") ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_mcp_list_tools.md b/docs/toolhive/reference/cli/thv_mcp_list_tools.md index 5a0a2d5c5..2250fe5f0 100644 --- a/docs/toolhive/reference/cli/thv_mcp_list_tools.md +++ b/docs/toolhive/reference/cli/thv_mcp_list_tools.md @@ -24,17 +24,17 @@ thv mcp list tools [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for tools - --server string MCP server URL or name from ToolHive registry (required) - --timeout duration Connection timeout (default 30s) - --transport string Transport type (auto, sse, streamable-http) (default "auto") + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for tools + --server string MCP server URL or name from ToolHive registry (required) + --timeout duration Connection timeout (default 30s) + --transport string Transport type (auto, sse, streamable-http) (default "auto") ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_proxy.md b/docs/toolhive/reference/cli/thv_proxy.md index 9b2406998..8f5e776ee 100644 --- a/docs/toolhive/reference/cli/thv_proxy.md +++ b/docs/toolhive/reference/cli/thv_proxy.md @@ -98,7 +98,7 @@ thv proxy [flags] SERVER_NAME ``` --allowed-origins stringArray Exact-match allowlist for the HTTP Origin header (repeatable). Recommended when binding publicly; loopback binds derive a default allowlist automatically, non-loopback binds log a warning when no value is supplied. Example: https://my-mcp.example.com - -h, --help help for proxy + -h, --help[=true|false] help for proxy --host string Host for the HTTP proxy to listen on (IP or hostname) (default "127.0.0.1") --max-request-body-size int Maximum inbound request body size in bytes; zero uses the default (8 MiB) --oidc-audience string Expected audience for the token @@ -109,7 +109,7 @@ thv proxy [flags] SERVER_NAME --oidc-jwks-url string URL to fetch the JWKS from --oidc-scopes strings OAuth scopes to advertise in the well-known endpoint (RFC 9728, defaults to 'openid' if not specified) --port int Port for the HTTP proxy to listen on (host port) - --remote-auth Enable OAuth/OIDC authentication to remote MCP server (default false) + --remote-auth[=true|false] Enable OAuth/OIDC authentication to remote MCP server (default false) --remote-auth-authorize-url string OAuth authorization endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth) --remote-auth-bearer-token string Bearer token for remote server authentication (alternative to OAuth) --remote-auth-bearer-token-file string Path to file containing bearer token (alternative to --remote-auth-bearer-token) @@ -121,7 +121,7 @@ thv proxy [flags] SERVER_NAME --remote-auth-resource string OAuth 2.0 resource indicator (RFC 8707) --remote-auth-scope-param-name string Override the query parameter name for scopes in the authorization URL (e.g., 'user_scope' for Slack OAuth) --remote-auth-scopes strings OAuth scopes to request for remote server authentication (defaults: OIDC uses 'openid,profile,email') - --remote-auth-skip-browser Skip opening browser for remote server OAuth flow (default false) + --remote-auth-skip-browser[=true|false] Skip opening browser for remote server OAuth flow (default false) --remote-auth-timeout duration Timeout for OAuth authentication flow (e.g., 30s, 1m, 2m30s) (default 30s) --remote-auth-token-url string OAuth token endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth) --remote-forward-headers stringArray Headers to inject into requests to remote server (format: Name=Value, can be repeated) @@ -141,7 +141,7 @@ thv proxy [flags] SERVER_NAME ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_proxy_stdio.md b/docs/toolhive/reference/cli/thv_proxy_stdio.md index 5006ade6a..b3d1c7626 100644 --- a/docs/toolhive/reference/cli/thv_proxy_stdio.md +++ b/docs/toolhive/reference/cli/thv_proxy_stdio.md @@ -28,13 +28,13 @@ thv proxy stdio WORKLOAD-NAME [flags] ### Options ``` - -h, --help help for stdio + -h, --help[=true|false] help for stdio ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_proxy_tunnel.md b/docs/toolhive/reference/cli/thv_proxy_tunnel.md index 24f2f8a78..f4c3d3d54 100644 --- a/docs/toolhive/reference/cli/thv_proxy_tunnel.md +++ b/docs/toolhive/reference/cli/thv_proxy_tunnel.md @@ -45,7 +45,7 @@ thv proxy tunnel [flags] TARGET SERVER_NAME ### Options ``` - -h, --help help for tunnel + -h, --help[=true|false] help for tunnel --provider-args string JSON object with provider-specific arguments (default "{}") --tunnel-provider string The provider to use for the tunnel (e.g., 'ngrok') - mandatory ``` @@ -53,7 +53,7 @@ thv proxy tunnel [flags] TARGET SERVER_NAME ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_registry.md b/docs/toolhive/reference/cli/thv_registry.md index f983ba945..1afdaa12e 100644 --- a/docs/toolhive/reference/cli/thv_registry.md +++ b/docs/toolhive/reference/cli/thv_registry.md @@ -20,13 +20,13 @@ Manage the MCP server registry, including listing and getting information about ### Options ``` - -h, --help help for registry + -h, --help[=true|false] help for registry ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_registry_convert.md b/docs/toolhive/reference/cli/thv_registry_convert.md index 7bfc6f8a2..fa69cd2ae 100644 --- a/docs/toolhive/reference/cli/thv_registry_convert.md +++ b/docs/toolhive/reference/cli/thv_registry_convert.md @@ -28,17 +28,17 @@ thv registry convert [flags] ### Options ``` - -h, --help help for convert - --in string Input file (default: stdin) - --in-place Overwrite the input file (writes a .bak backup unless --no-backup is set) - --no-backup Do not write a .bak backup when using --in-place - --out string Output file (default: stdout) + -h, --help[=true|false] help for convert + --in string Input file (default: stdin) + --in-place[=true|false] Overwrite the input file (writes a .bak backup unless --no-backup is set) + --no-backup[=true|false] Do not write a .bak backup when using --in-place + --out string Output file (default: stdout) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_registry_info.md b/docs/toolhive/reference/cli/thv_registry_info.md index 0eea0b539..8558ed716 100644 --- a/docs/toolhive/reference/cli/thv_registry_info.md +++ b/docs/toolhive/reference/cli/thv_registry_info.md @@ -24,15 +24,15 @@ thv registry info [server] [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for info - --refresh Force refresh registry cache + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for info + --refresh[=true|false] Force refresh registry cache ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_registry_list.md b/docs/toolhive/reference/cli/thv_registry_list.md index f01e4289b..3a2fd2d2f 100644 --- a/docs/toolhive/reference/cli/thv_registry_list.md +++ b/docs/toolhive/reference/cli/thv_registry_list.md @@ -24,15 +24,15 @@ thv registry list [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for list - --refresh Force refresh registry cache + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for list + --refresh[=true|false] Force refresh registry cache ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_registry_login.md b/docs/toolhive/reference/cli/thv_registry_login.md index ccbfb1baf..ef831420d 100644 --- a/docs/toolhive/reference/cli/thv_registry_login.md +++ b/docs/toolhive/reference/cli/thv_registry_login.md @@ -32,19 +32,19 @@ thv registry login [flags] ### Options ``` - -p, --allow-private-ip Allow --registry to reference a private IP address (default false). Mirrors the flag on 'thv config set-registry'. - --audience string OAuth audience parameter for registry authentication (optional) - --client-id string OAuth client ID for registry authentication - -h, --help help for login - --issuer string OIDC issuer URL for registry authentication - --registry string Registry URL - --scopes strings OAuth scopes for registry authentication (defaults to openid,offline_access) + -p, --allow-private-ip[=true|false] Allow --registry to reference a private IP address (default false). Mirrors the flag on 'thv config set-registry'. + --audience string OAuth audience parameter for registry authentication (optional) + --client-id string OAuth client ID for registry authentication + -h, --help[=true|false] help for login + --issuer string OIDC issuer URL for registry authentication + --registry string Registry URL + --scopes strings OAuth scopes for registry authentication (defaults to openid,offline_access) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_registry_logout.md b/docs/toolhive/reference/cli/thv_registry_logout.md index 4c915892e..92793a157 100644 --- a/docs/toolhive/reference/cli/thv_registry_logout.md +++ b/docs/toolhive/reference/cli/thv_registry_logout.md @@ -24,13 +24,13 @@ thv registry logout [flags] ### Options ``` - -h, --help help for logout + -h, --help[=true|false] help for logout ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_rm.md b/docs/toolhive/reference/cli/thv_rm.md index 901b2eabf..27ef80b03 100644 --- a/docs/toolhive/reference/cli/thv_rm.md +++ b/docs/toolhive/reference/cli/thv_rm.md @@ -36,15 +36,15 @@ thv rm [workload-name...] [flags] ### Options ``` - --all Delete all workloads - -g, --group string Filter by group - -h, --help help for rm + --all[=true|false] Delete all workloads + -g, --group string Filter by group + -h, --help[=true|false] help for rm ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_run.md b/docs/toolhive/reference/cli/thv_run.md index 15ce0a91f..774dc1185 100644 --- a/docs/toolhive/reference/cli/thv_run.md +++ b/docs/toolhive/reference/cli/thv_run.md @@ -111,104 +111,104 @@ thv run [flags] SERVER_OR_IMAGE_OR_PROTOCOL [-- ARGS...] ### Options ``` - --allow-docker-gateway Allow outbound connections to Docker/Podman host addresses (all daemon bridge gateways, runtime host-alias IPs, host.docker.internal, gateway.docker.internal, and host.containers.internal). Only applies when --isolate-network is set. Addresses are snapshotted at deployment; redeploy after runtime network changes. These are blocked by default even when insecure_allow_all is enabled. Gateway access is port-independent: it ignores the permission profile's allowed ports, so once enabled the gateway is reachable on any port. - --allowed-origins stringArray Exact-match allowlist for the HTTP Origin header (repeatable). Recommended when binding publicly; loopback binds derive a default allowlist automatically, non-loopback binds log a warning when no value is supplied. Example: https://my-mcp.example.com - --audit-config string Path to the audit configuration file - --authz-config string Path to the authorization configuration file - --build-with stringArray Build-time dependency constraint for protocol scheme builds, interpreted per package ecosystem (uvx://: PEP 508 specifier passed to 'uv tool install --with', e.g. --build-with 'mcp<2'); errors on ecosystems without constraint support (can be specified multiple times) - --ca-cert string Path to a custom CA certificate file to use for container builds - --enable-audit Enable audit logging with default configuration (default false) - --endpoint-prefix string Path prefix to prepend to SSE endpoint URLs (e.g., /playwright) - -e, --env stringArray Environment variables to pass to the MCP server (format: KEY=VALUE) - --env-file string Load environment variables from a single file - --env-file-dir string Load environment variables from all files in a directory - -f, --foreground Run in foreground mode (block until container exits) (default false) - --from-config string Load configuration from exported file - --group string Name of the group this workload should belong to (default "default") - -h, --help help for run - --host string Host for the HTTP proxy to listen on (IP or hostname) (default "127.0.0.1") - --ignore-globally Load global ignore patterns from ~/.config/toolhive/thvignore (default true) - --image-verification string Set image verification mode (warn, enabled, disabled) (default "warn") - --isolate-network Isolate the container network from the host. Use --isolate-network=false to opt out. Not enforced with --network host or --network none (isolation requires bridge networking). (default true) - --jwks-allow-private-ip Allow JWKS/OIDC endpoints on private IP addresses (use with caution) (default false) - --jwks-auth-token-file string Path to file containing bearer token for authenticating JWKS/OIDC requests - -l, --label stringArray Set labels on the container (format: key=value) - --max-request-body-size int Maximum inbound request body size in bytes; zero uses the default (8 MiB) - --name string Name of the MCP server (default to auto-generated from image) - --network string Connect the container to a network (e.g., 'host' for host networking). Note: 'host' and 'none' cannot enforce network isolation, so isolation is dropped for those modes. - --oidc-audience string Expected audience for the token - --oidc-client-id string OIDC client ID - --oidc-client-secret string OIDC client secret (optional, for introspection) - --oidc-insecure-allow-http Allow HTTP (non-HTTPS) OIDC issuers for local development/testing (WARNING: Insecure!) (default false) - --oidc-introspection-url string URL for token introspection endpoint - --oidc-issuer string OIDC issuer URL (e.g., https://accounts.google.com) - --oidc-jwks-url string URL to fetch the JWKS from - --oidc-scopes strings OAuth scopes to advertise in the well-known endpoint (RFC 9728, defaults to 'openid' if not specified) - --otel-custom-attributes string Custom resource attributes for OpenTelemetry in key=value format (e.g., server_type=prod,region=us-east-1,team=platform) - --otel-enable-prometheus-metrics-path Enable Prometheus-style /metrics endpoint on a dedicated diagnostics port (default false) - --otel-endpoint string OpenTelemetry OTLP endpoint URL (e.g., https://api.honeycomb.io) - --otel-env-vars stringArray Environment variable names to include in OpenTelemetry spans (comma-separated: ENV1,ENV2) - --otel-headers stringArray OpenTelemetry OTLP headers in key=value format (e.g., x-honeycomb-team=your-api-key) - --otel-insecure Connect to the OpenTelemetry endpoint using HTTP instead of HTTPS (default false) - --otel-metrics-enabled Enable OTLP metrics export (when OTLP endpoint is configured) (default true) - --otel-metrics-on-transport-port Also serve Prometheus /metrics on the transport port, alongside the diagnostics port. Deprecated: this is a migration aid and the default will become false; see https://github.com/stacklok/toolhive/issues/6384 for the timeline. Move scrapers to the diagnostics port and set this to false to verify. (default true) - --otel-sampling-rate float OpenTelemetry trace sampling rate (0.0-1.0) (default 0.1) - --otel-service-name string OpenTelemetry service name (defaults to thv-) - --otel-tracing-enabled Enable distributed tracing (when OTLP endpoint is configured) (default true) - --otel-use-legacy-attributes Emit legacy attribute names alongside new OTEL semantic convention names (default true) (default true) - --permission-profile string Permission profile to use (none, network, or path to JSON file) (default is to use the permission profile from the registry or "network" if not part of the registry) - --print-resolved-overlays Debug: show resolved container paths for tmpfs overlays (default false) - --proxy-mode string Proxy mode for stdio (streamable-http or sse (deprecated, will be removed)) (default "streamable-http") - --proxy-port int Port for the HTTP proxy to listen on (host port) - --proxy-read-timeout duration Maximum time to read a full request on the proxy (e.g., 30s, 1m); zero uses the default (30s) - -p, --publish stringArray Publish a container's port(s) to the host (format: hostPort:containerPort) - --remote-auth Enable OAuth/OIDC authentication to remote MCP server (default false) - --remote-auth-authorize-url string OAuth authorization endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth) - --remote-auth-bearer-token string Bearer token for remote server authentication (alternative to OAuth) - --remote-auth-bearer-token-file string Path to file containing bearer token (alternative to --remote-auth-bearer-token) - --remote-auth-callback-port int Port for OAuth callback server during remote authentication (default 8666) - --remote-auth-client-id string OAuth client ID for remote server authentication (optional if the authorization server supports dynamic client registration (RFC 7591)) - --remote-auth-client-secret string OAuth client secret for remote server authentication (optional if the authorization server supports dynamic client registration (RFC 7591) or if using PKCE) - --remote-auth-client-secret-file string Path to file containing OAuth client secret (alternative to --remote-auth-client-secret) (optional if the authorization server supports dynamic client registration (RFC 7591) or if using PKCE) - --remote-auth-issuer string OAuth/OIDC issuer URL for remote server authentication (e.g., https://accounts.google.com) - --remote-auth-resource string OAuth 2.0 resource indicator (RFC 8707) - --remote-auth-scope-param-name string Override the query parameter name for scopes in the authorization URL (e.g., 'user_scope' for Slack OAuth) - --remote-auth-scopes strings OAuth scopes to request for remote server authentication (defaults: OIDC uses 'openid,profile,email') - --remote-auth-skip-browser Skip opening browser for remote server OAuth flow (default false) - --remote-auth-timeout duration Timeout for OAuth authentication flow (e.g., 30s, 1m, 2m30s) (default 30s) - --remote-auth-token-url string OAuth token endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth) - --remote-forward-headers stringArray Headers to inject into requests to remote MCP server (format: Name=Value, can be repeated) - --remote-forward-headers-secret stringArray Headers with secret values from ToolHive secrets manager (format: Name=secret-name, can be repeated) - --resource-url string Explicit resource URL for OAuth discovery endpoint (RFC 9728) - --runtime-add-package stringArray Add additional packages to install in the builder and runtime stages (can be repeated) - --runtime-image string Override the default base image for protocol schemes (e.g., golang:1.24-alpine, node:20-alpine, python:3.11-slim) - --secret stringArray Specify a secret to be fetched from the secrets manager and set as an environment variable (format: NAME,target=TARGET) - --session-ttl duration Session inactivity timeout (e.g., 30m, 2h); zero uses the default (2h) - --stateless Declare the server as stateless (POST-only, no SSE). Use for MCP servers implementing streamable-HTTP stateless mode. - --strict-protocol-validation Reject client requests whose MCP-Protocol-Version header is an unknown/unsupported MCP revision with HTTP 400 (streamable-HTTP proxy only; an absent header is accepted). Off by default: any version is accepted. - --target-host string Host to forward traffic to (only applicable to SSE or Streamable HTTP transport) (default "127.0.0.1") - --target-port int Port for the container to expose (only applicable to SSE or Streamable HTTP transport) - --thv-ca-bundle string Path to CA certificate bundle for ToolHive HTTP operations (JWKS, OIDC discovery, etc.) - --token-exchange-audience string Target audience for exchanged tokens - --token-exchange-client-id string OAuth client ID for token exchange operations - --token-exchange-client-secret string OAuth client secret for token exchange operations - --token-exchange-client-secret-file string Path to file containing OAuth client secret for token exchange (alternative to --token-exchange-client-secret) - --token-exchange-header-name string Custom header name for injecting exchanged token (default: replaces Authorization header) - --token-exchange-scopes strings Scopes to request for exchanged tokens - --token-exchange-subject-token-type string Type of subject token to exchange. Accepts: access_token (default), id_token (required for Google STS) - --token-exchange-url string OAuth 2.0 token exchange endpoint URL (enables token exchange when provided) - --tools stringArray Filter MCP server tools (comma-separated list of tool names) - --tools-override string Path to a JSON file containing overrides for MCP server tools names and descriptions - --transport string Transport mode (sse, streamable-http or stdio) - --trust-proxy-headers Trust X-Forwarded-* headers from reverse proxies (X-Forwarded-Proto, X-Forwarded-Host, X-Forwarded-Port, X-Forwarded-Prefix) (default false) - -v, --volume stringArray Mount a volume into the container (format: host-path:container-path[:ro]) - --webhook-config stringArray Path to webhook configuration file (can be specified multiple times to merge configs) + --allow-docker-gateway[=true|false] Allow outbound connections to Docker/Podman host addresses (all daemon bridge gateways, runtime host-alias IPs, host.docker.internal, gateway.docker.internal, and host.containers.internal). Only applies when --isolate-network is set. Addresses are snapshotted at deployment; redeploy after runtime network changes. These are blocked by default even when insecure_allow_all is enabled. Gateway access is port-independent: it ignores the permission profile's allowed ports, so once enabled the gateway is reachable on any port. + --allowed-origins stringArray Exact-match allowlist for the HTTP Origin header (repeatable). Recommended when binding publicly; loopback binds derive a default allowlist automatically, non-loopback binds log a warning when no value is supplied. Example: https://my-mcp.example.com + --audit-config string Path to the audit configuration file + --authz-config string Path to the authorization configuration file + --build-with stringArray Build-time dependency constraint for protocol scheme builds, interpreted per package ecosystem (uvx://: PEP 508 specifier passed to 'uv tool install --with', e.g. --build-with 'mcp<2'); errors on ecosystems without constraint support (can be specified multiple times) + --ca-cert string Path to a custom CA certificate file to use for container builds + --enable-audit[=true|false] Enable audit logging with default configuration (default false) + --endpoint-prefix string Path prefix to prepend to SSE endpoint URLs (e.g., /playwright) + -e, --env stringArray Environment variables to pass to the MCP server (format: KEY=VALUE) + --env-file string Load environment variables from a single file + --env-file-dir string Load environment variables from all files in a directory + -f, --foreground[=true|false] Run in foreground mode (block until container exits) (default false) + --from-config string Load configuration from exported file + --group string Name of the group this workload should belong to (default "default") + -h, --help[=true|false] help for run + --host string Host for the HTTP proxy to listen on (IP or hostname) (default "127.0.0.1") + --ignore-globally[=true|false] Load global ignore patterns from ~/.config/toolhive/thvignore (default true) + --image-verification string Set image verification mode (warn, enabled, disabled) (default "warn") + --isolate-network[=true|false] Isolate the container network from the host. Use --isolate-network=false to opt out. Not enforced with --network host or --network none (isolation requires bridge networking). (default true) + --jwks-allow-private-ip[=true|false] Allow JWKS/OIDC endpoints on private IP addresses (use with caution) (default false) + --jwks-auth-token-file string Path to file containing bearer token for authenticating JWKS/OIDC requests + -l, --label stringArray Set labels on the container (format: key=value) + --max-request-body-size int Maximum inbound request body size in bytes; zero uses the default (8 MiB) + --name string Name of the MCP server (default to auto-generated from image) + --network string Connect the container to a network (e.g., 'host' for host networking). Note: 'host' and 'none' cannot enforce network isolation, so isolation is dropped for those modes. + --oidc-audience string Expected audience for the token + --oidc-client-id string OIDC client ID + --oidc-client-secret string OIDC client secret (optional, for introspection) + --oidc-insecure-allow-http[=true|false] Allow HTTP (non-HTTPS) OIDC issuers for local development/testing (WARNING: Insecure!) (default false) + --oidc-introspection-url string URL for token introspection endpoint + --oidc-issuer string OIDC issuer URL (e.g., https://accounts.google.com) + --oidc-jwks-url string URL to fetch the JWKS from + --oidc-scopes strings OAuth scopes to advertise in the well-known endpoint (RFC 9728, defaults to 'openid' if not specified) + --otel-custom-attributes string Custom resource attributes for OpenTelemetry in key=value format (e.g., server_type=prod,region=us-east-1,team=platform) + --otel-enable-prometheus-metrics-path[=true|false] Enable Prometheus-style /metrics endpoint on a dedicated diagnostics port (default false) + --otel-endpoint string OpenTelemetry OTLP endpoint URL (e.g., https://api.honeycomb.io) + --otel-env-vars stringArray Environment variable names to include in OpenTelemetry spans (comma-separated: ENV1,ENV2) + --otel-headers stringArray OpenTelemetry OTLP headers in key=value format (e.g., x-honeycomb-team=your-api-key) + --otel-insecure[=true|false] Connect to the OpenTelemetry endpoint using HTTP instead of HTTPS (default false) + --otel-metrics-enabled[=true|false] Enable OTLP metrics export (when OTLP endpoint is configured) (default true) + --otel-metrics-on-transport-port[=true|false] Also serve Prometheus /metrics on the transport port, alongside the diagnostics port. Deprecated: this is a migration aid and the default will become false; see https://github.com/stacklok/toolhive/issues/6384 for the timeline. Move scrapers to the diagnostics port and set this to false to verify. (default true) + --otel-sampling-rate float OpenTelemetry trace sampling rate (0.0-1.0) (default 0.1) + --otel-service-name string OpenTelemetry service name (defaults to thv-) + --otel-tracing-enabled[=true|false] Enable distributed tracing (when OTLP endpoint is configured) (default true) + --otel-use-legacy-attributes[=true|false] Emit legacy attribute names alongside new OTEL semantic convention names (default true) (default true) + --permission-profile string Permission profile to use (none, network, or path to JSON file) (default is to use the permission profile from the registry or "network" if not part of the registry) + --print-resolved-overlays[=true|false] Debug: show resolved container paths for tmpfs overlays (default false) + --proxy-mode string Proxy mode for stdio (streamable-http or sse (deprecated, will be removed)) (default "streamable-http") + --proxy-port int Port for the HTTP proxy to listen on (host port) + --proxy-read-timeout duration Maximum time to read a full request on the proxy (e.g., 30s, 1m); zero uses the default (30s) + -p, --publish stringArray Publish a container's port(s) to the host (format: hostPort:containerPort) + --remote-auth[=true|false] Enable OAuth/OIDC authentication to remote MCP server (default false) + --remote-auth-authorize-url string OAuth authorization endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth) + --remote-auth-bearer-token string Bearer token for remote server authentication (alternative to OAuth) + --remote-auth-bearer-token-file string Path to file containing bearer token (alternative to --remote-auth-bearer-token) + --remote-auth-callback-port int Port for OAuth callback server during remote authentication (default 8666) + --remote-auth-client-id string OAuth client ID for remote server authentication (optional if the authorization server supports dynamic client registration (RFC 7591)) + --remote-auth-client-secret string OAuth client secret for remote server authentication (optional if the authorization server supports dynamic client registration (RFC 7591) or if using PKCE) + --remote-auth-client-secret-file string Path to file containing OAuth client secret (alternative to --remote-auth-client-secret) (optional if the authorization server supports dynamic client registration (RFC 7591) or if using PKCE) + --remote-auth-issuer string OAuth/OIDC issuer URL for remote server authentication (e.g., https://accounts.google.com) + --remote-auth-resource string OAuth 2.0 resource indicator (RFC 8707) + --remote-auth-scope-param-name string Override the query parameter name for scopes in the authorization URL (e.g., 'user_scope' for Slack OAuth) + --remote-auth-scopes strings OAuth scopes to request for remote server authentication (defaults: OIDC uses 'openid,profile,email') + --remote-auth-skip-browser[=true|false] Skip opening browser for remote server OAuth flow (default false) + --remote-auth-timeout duration Timeout for OAuth authentication flow (e.g., 30s, 1m, 2m30s) (default 30s) + --remote-auth-token-url string OAuth token endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth) + --remote-forward-headers stringArray Headers to inject into requests to remote MCP server (format: Name=Value, can be repeated) + --remote-forward-headers-secret stringArray Headers with secret values from ToolHive secrets manager (format: Name=secret-name, can be repeated) + --resource-url string Explicit resource URL for OAuth discovery endpoint (RFC 9728) + --runtime-add-package stringArray Add additional packages to install in the builder and runtime stages (can be repeated) + --runtime-image string Override the default base image for protocol schemes (e.g., golang:1.24-alpine, node:20-alpine, python:3.11-slim) + --secret stringArray Specify a secret to be fetched from the secrets manager and set as an environment variable (format: NAME,target=TARGET) + --session-ttl duration Session inactivity timeout (e.g., 30m, 2h); zero uses the default (2h) + --stateless[=true|false] Declare the server as stateless (POST-only, no SSE). Use for MCP servers implementing streamable-HTTP stateless mode. + --strict-protocol-validation[=true|false] Reject client requests whose MCP-Protocol-Version header is an unknown/unsupported MCP revision with HTTP 400 (streamable-HTTP proxy only; an absent header is accepted). Off by default: any version is accepted. + --target-host string Host to forward traffic to (only applicable to SSE or Streamable HTTP transport) (default "127.0.0.1") + --target-port int Port for the container to expose (only applicable to SSE or Streamable HTTP transport) + --thv-ca-bundle string Path to CA certificate bundle for ToolHive HTTP operations (JWKS, OIDC discovery, etc.) + --token-exchange-audience string Target audience for exchanged tokens + --token-exchange-client-id string OAuth client ID for token exchange operations + --token-exchange-client-secret string OAuth client secret for token exchange operations + --token-exchange-client-secret-file string Path to file containing OAuth client secret for token exchange (alternative to --token-exchange-client-secret) + --token-exchange-header-name string Custom header name for injecting exchanged token (default: replaces Authorization header) + --token-exchange-scopes strings Scopes to request for exchanged tokens + --token-exchange-subject-token-type string Type of subject token to exchange. Accepts: access_token (default), id_token (required for Google STS) + --token-exchange-url string OAuth 2.0 token exchange endpoint URL (enables token exchange when provided) + --tools stringArray Filter MCP server tools (comma-separated list of tool names) + --tools-override string Path to a JSON file containing overrides for MCP server tools names and descriptions + --transport string Transport mode (sse, streamable-http or stdio) + --trust-proxy-headers[=true|false] Trust X-Forwarded-* headers from reverse proxies (X-Forwarded-Proto, X-Forwarded-Host, X-Forwarded-Port, X-Forwarded-Prefix) (default false) + -v, --volume stringArray Mount a volume into the container (format: host-path:container-path[:ro]) + --webhook-config stringArray Path to webhook configuration file (can be specified multiple times to merge configs) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_runtime.md b/docs/toolhive/reference/cli/thv_runtime.md index 57d51efa7..d638668c4 100644 --- a/docs/toolhive/reference/cli/thv_runtime.md +++ b/docs/toolhive/reference/cli/thv_runtime.md @@ -16,13 +16,13 @@ Commands related to the container runtime ### Options ``` - -h, --help help for runtime + -h, --help[=true|false] help for runtime ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_runtime_check.md b/docs/toolhive/reference/cli/thv_runtime_check.md index 6bfc6c22b..a0beabd55 100644 --- a/docs/toolhive/reference/cli/thv_runtime_check.md +++ b/docs/toolhive/reference/cli/thv_runtime_check.md @@ -24,14 +24,14 @@ thv runtime check [flags] ### Options ``` - -h, --help help for check - --timeout int Timeout in seconds for runtime checks (default: 30 seconds) (default 30) + -h, --help[=true|false] help for check + --timeout int Timeout in seconds for runtime checks (default: 30 seconds) (default 30) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_search.md b/docs/toolhive/reference/cli/thv_search.md index 047969bca..01db652f0 100644 --- a/docs/toolhive/reference/cli/thv_search.md +++ b/docs/toolhive/reference/cli/thv_search.md @@ -24,14 +24,14 @@ thv search [query] [flags] ### Options ``` - --format string Output format (json or text) (default "text") - -h, --help help for search + --format string Output format (json or text) (default "text") + -h, --help[=true|false] help for search ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret.md b/docs/toolhive/reference/cli/thv_secret.md index 1dae3b0a4..f8b3a0984 100644 --- a/docs/toolhive/reference/cli/thv_secret.md +++ b/docs/toolhive/reference/cli/thv_secret.md @@ -24,13 +24,13 @@ Run "thv secret setup" first to configure a secrets provider before using any se ### Options ``` - -h, --help help for secret + -h, --help[=true|false] help for secret ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_delete.md b/docs/toolhive/reference/cli/thv_secret_delete.md index 00e972d12..131bed360 100644 --- a/docs/toolhive/reference/cli/thv_secret_delete.md +++ b/docs/toolhive/reference/cli/thv_secret_delete.md @@ -30,14 +30,14 @@ thv secret delete [flags] ### Options ``` - -h, --help help for delete - --system Allow deleting a system-managed secret (emergency use only) + -h, --help[=true|false] help for delete + --system[=true|false] Allow deleting a system-managed secret (emergency use only) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_get.md b/docs/toolhive/reference/cli/thv_secret_get.md index 1a2f1f81c..a043a6fba 100644 --- a/docs/toolhive/reference/cli/thv_secret_get.md +++ b/docs/toolhive/reference/cli/thv_secret_get.md @@ -30,13 +30,13 @@ thv secret get [flags] ### Options ``` - -h, --help help for get + -h, --help[=true|false] help for get ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_list.md b/docs/toolhive/reference/cli/thv_secret_list.md index 1a5125554..ce6a95093 100644 --- a/docs/toolhive/reference/cli/thv_secret_list.md +++ b/docs/toolhive/reference/cli/thv_secret_list.md @@ -27,14 +27,14 @@ thv secret list [flags] ### Options ``` - -h, --help help for list - --system List system-managed secrets (registry auth, workload tokens) + -h, --help[=true|false] help for list + --system[=true|false] List system-managed secrets (registry auth, workload tokens) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_provider.md b/docs/toolhive/reference/cli/thv_secret_provider.md index e4ea85a65..ea4022f84 100644 --- a/docs/toolhive/reference/cli/thv_secret_provider.md +++ b/docs/toolhive/reference/cli/thv_secret_provider.md @@ -34,13 +34,13 @@ thv secret provider [flags] ### Options ``` - -h, --help help for provider + -h, --help[=true|false] help for provider ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_reset-keyring.md b/docs/toolhive/reference/cli/thv_secret_reset-keyring.md index 7116d801d..be1d2d319 100644 --- a/docs/toolhive/reference/cli/thv_secret_reset-keyring.md +++ b/docs/toolhive/reference/cli/thv_secret_reset-keyring.md @@ -38,13 +38,13 @@ thv secret reset-keyring [flags] ### Options ``` - -h, --help help for reset-keyring + -h, --help[=true|false] help for reset-keyring ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_set.md b/docs/toolhive/reference/cli/thv_secret_set.md index 1d839f76e..77d3631f4 100644 --- a/docs/toolhive/reference/cli/thv_secret_set.md +++ b/docs/toolhive/reference/cli/thv_secret_set.md @@ -46,13 +46,13 @@ thv secret set [flags] ### Options ``` - -h, --help help for set + -h, --help[=true|false] help for set ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_setup.md b/docs/toolhive/reference/cli/thv_secret_setup.md index fab40515f..1189a7659 100644 --- a/docs/toolhive/reference/cli/thv_secret_setup.md +++ b/docs/toolhive/reference/cli/thv_secret_setup.md @@ -35,13 +35,13 @@ thv secret setup [flags] ### Options ``` - -h, --help help for setup + -h, --help[=true|false] help for setup ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_secret_upgrade-protection.md b/docs/toolhive/reference/cli/thv_secret_upgrade-protection.md index 4fafd7dcc..3c0c932b8 100644 --- a/docs/toolhive/reference/cli/thv_secret_upgrade-protection.md +++ b/docs/toolhive/reference/cli/thv_secret_upgrade-protection.md @@ -27,14 +27,14 @@ thv secret upgrade-protection [flags] ### Options ``` - -h, --help help for upgrade-protection - --yes Skip the compatibility confirmation + -h, --help[=true|false] help for upgrade-protection + --yes[=true|false] Skip the compatibility confirmation ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_serve.md b/docs/toolhive/reference/cli/thv_serve.md index bb164aedb..0f2847d0c 100644 --- a/docs/toolhive/reference/cli/thv_serve.md +++ b/docs/toolhive/reference/cli/thv_serve.md @@ -24,7 +24,7 @@ thv serve [flags] ### Options ``` - -h, --help help for serve + -h, --help[=true|false] help for serve --host string Host address to bind the server to (default "127.0.0.1") --oidc-audience string Expected audience for the token --oidc-client-id string OIDC client ID @@ -33,7 +33,7 @@ thv serve [flags] --oidc-issuer string OIDC issuer URL (e.g., https://accounts.google.com) --oidc-jwks-url string URL to fetch the JWKS from --oidc-scopes strings OAuth scopes to advertise in the well-known endpoint (RFC 9728, defaults to 'openid' if not specified) - --openapi Enable OpenAPI documentation endpoints (/api/openapi.json and /api/doc) + --openapi[=true|false] Enable OpenAPI documentation endpoints (/api/openapi.json and /api/doc) --port int Port to bind the server to (default 8080) --sentry-dsn string Sentry DSN for error tracking and distributed tracing (falls back to SENTRY_DSN env var) --sentry-environment string Sentry environment name, e.g. production or development (falls back to SENTRY_ENVIRONMENT env var) @@ -44,7 +44,7 @@ thv serve [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill.md b/docs/toolhive/reference/cli/thv_skill.md index a97336a78..9dc89de20 100644 --- a/docs/toolhive/reference/cli/thv_skill.md +++ b/docs/toolhive/reference/cli/thv_skill.md @@ -20,13 +20,13 @@ The skill command provides subcommands to manage skills. ### Options ``` - -h, --help help for skill + -h, --help[=true|false] help for skill ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_build.md b/docs/toolhive/reference/cli/thv_skill_build.md index 8ca6fe3dc..2367b0323 100644 --- a/docs/toolhive/reference/cli/thv_skill_build.md +++ b/docs/toolhive/reference/cli/thv_skill_build.md @@ -26,14 +26,14 @@ thv skill build [path] [flags] ### Options ``` - -h, --help help for build - -t, --tag string OCI tag for the built artifact + -h, --help[=true|false] help for build + -t, --tag string OCI tag for the built artifact ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_builds.md b/docs/toolhive/reference/cli/thv_skill_builds.md index 5d882498b..5dd8ed46d 100644 --- a/docs/toolhive/reference/cli/thv_skill_builds.md +++ b/docs/toolhive/reference/cli/thv_skill_builds.md @@ -24,14 +24,14 @@ thv skill builds [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for builds + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for builds ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_builds_remove.md b/docs/toolhive/reference/cli/thv_skill_builds_remove.md index 3caf9fd79..d33f4e96d 100644 --- a/docs/toolhive/reference/cli/thv_skill_builds_remove.md +++ b/docs/toolhive/reference/cli/thv_skill_builds_remove.md @@ -24,13 +24,13 @@ thv skill builds remove [flags] ### Options ``` - -h, --help help for remove + -h, --help[=true|false] help for remove ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_info.md b/docs/toolhive/reference/cli/thv_skill_info.md index 990a81b61..70af9f1be 100644 --- a/docs/toolhive/reference/cli/thv_skill_info.md +++ b/docs/toolhive/reference/cli/thv_skill_info.md @@ -25,7 +25,7 @@ thv skill info [skill-name] [flags] ``` --format string Output format (json, text) (default "text") - -h, --help help for info + -h, --help[=true|false] help for info --project-root string Project root path for project-scoped skills --scope string Filter by scope (user, project) ``` @@ -33,7 +33,7 @@ thv skill info [skill-name] [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_install.md b/docs/toolhive/reference/cli/thv_skill_install.md index 842d687a7..7f93d1989 100644 --- a/docs/toolhive/reference/cli/thv_skill_install.md +++ b/docs/toolhive/reference/cli/thv_skill_install.md @@ -25,20 +25,20 @@ thv skill install [skill-name] [flags] ### Options ``` - --allow-unsigned Allow installing a project-scoped skill without a verified signature (recorded in the lock file) - --clients string Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client - --force Overwrite existing skill directory - --group string Group to add the skill to after installation - -h, --help help for install - --project-root string Project root path for project-scoped installs - --public-key string Path to the cosign public key (cosign.pub) a key-pair-signed skill must verify against. Required the first time such a skill is installed project-scoped; the key is then pinned in the lock file and reused automatically - --scope string Installation scope (user, project) (default "user") + --allow-unsigned[=true|false] Allow installing a project-scoped skill without a verified signature (recorded in the lock file) + --clients string Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client + --force[=true|false] Overwrite existing skill directory + --group string Group to add the skill to after installation + -h, --help[=true|false] help for install + --project-root string Project root path for project-scoped installs + --public-key string Path to the cosign public key (cosign.pub) a key-pair-signed skill must verify against. Required the first time such a skill is installed project-scoped; the key is then pinned in the lock file and reused automatically + --scope string Installation scope (user, project) (default "user") ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_list.md b/docs/toolhive/reference/cli/thv_skill_list.md index 118a9dded..f54c1fe03 100644 --- a/docs/toolhive/reference/cli/thv_skill_list.md +++ b/docs/toolhive/reference/cli/thv_skill_list.md @@ -27,7 +27,7 @@ thv skill list [flags] --client string Filter by client application --format string Output format (json, text) (default "text") --group string Filter by group - -h, --help help for list + -h, --help[=true|false] help for list --project-root string Project root path for project-scoped skills --scope string Filter by scope (user, project) ``` @@ -35,7 +35,7 @@ thv skill list [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_push.md b/docs/toolhive/reference/cli/thv_skill_push.md index c9a418982..4df349f3f 100644 --- a/docs/toolhive/reference/cli/thv_skill_push.md +++ b/docs/toolhive/reference/cli/thv_skill_push.md @@ -24,16 +24,16 @@ thv skill push [reference] [flags] ### Options ``` - -h, --help help for push + -h, --help[=true|false] help for push --identity-token string OIDC identity token (or a path to a file containing one) for keyless signing. Mutually exclusive with --key. If omitted, one is acquired automatically: from the ambient CI OIDC token when running with id-token: write permission, otherwise via an interactive browser sign-in --key string Path to a cosign private key to sign the pushed artifact. Requires the locally discovered ToolHive server; for a remote or manually configured API URL, use keyless signing. Encrypted keys are decrypted with COSIGN_PASSWORD read from the 'thv serve' process, which performs the signing. Consumers installing the result project-scoped must pass --public-key with the matching cosign public key the first time; distribute it alongside the artifact. Keyless signing needs no such out-of-band step, since the signer identity is verifiable from the artifact itself - --no-sign Push without signing (consumers will need an explicit unsigned exception to install project-scoped) + --no-sign[=true|false] Push without signing (consumers will need an explicit unsigned exception to install project-scoped) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_sync.md b/docs/toolhive/reference/cli/thv_skill_sync.md index e85b18c66..535a22946 100644 --- a/docs/toolhive/reference/cli/thv_skill_sync.md +++ b/docs/toolhive/reference/cli/thv_skill_sync.md @@ -33,22 +33,22 @@ thv skill sync [flags] ### Options ``` - --adopt Write lock entries for existing unmanaged project-scope installs - --allow-unsigned Allow adopting skills whose signature state cannot be established (recorded as unsigned) - --check Report drift without installing, writing, or removing anything - --clients string Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client - --format string Output format (json, text) (default "text") - -h, --help help for sync - --project-root string Project root path (default: auto-detected from the current directory) - --prune Remove installs no longer present in the lock file - --public-key string Path to the cosign public key used to verify key-pair-signed skills during --adopt - --yes Skip the confirmation prompt (required when not running interactively) + --adopt[=true|false] Write lock entries for existing unmanaged project-scope installs + --allow-unsigned[=true|false] Allow adopting skills whose signature state cannot be established (recorded as unsigned) + --check[=true|false] Report drift without installing, writing, or removing anything + --clients string Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for sync + --project-root string Project root path (default: auto-detected from the current directory) + --prune[=true|false] Remove installs no longer present in the lock file + --public-key string Path to the cosign public key used to verify key-pair-signed skills during --adopt + --yes[=true|false] Skip the confirmation prompt (required when not running interactively) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_uninstall.md b/docs/toolhive/reference/cli/thv_skill_uninstall.md index 7dabfd286..406fe277d 100644 --- a/docs/toolhive/reference/cli/thv_skill_uninstall.md +++ b/docs/toolhive/reference/cli/thv_skill_uninstall.md @@ -24,7 +24,7 @@ thv skill uninstall [skill-name] [flags] ### Options ``` - -h, --help help for uninstall + -h, --help[=true|false] help for uninstall --project-root string Project root path for project-scoped skills --scope string Scope to uninstall from (user, project) (default "user") ``` @@ -32,7 +32,7 @@ thv skill uninstall [skill-name] [flags] ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_upgrade.md b/docs/toolhive/reference/cli/thv_skill_upgrade.md index 876947030..621149a59 100644 --- a/docs/toolhive/reference/cli/thv_skill_upgrade.md +++ b/docs/toolhive/reference/cli/thv_skill_upgrade.md @@ -39,22 +39,22 @@ thv skill upgrade [skill-name...] [flags] ### Options ``` - --allow-ref-change Permit the artifact to move to a different repository during upgrade - --allow-signer-change Permit upgrading to an artifact signed by a different identity; the new identity replaces the recorded one - --clients string Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client - --fail-on-changes Report what would change without installing anything; a CI freshness gate - --format string Output format (json, text) (default "text") - -h, --help help for upgrade - --preview Report what would change without persisting anything (OCI sources are still fetched to compare digests) - --project-root string Project root path (default: auto-detected from the current directory) - --public-key string Path to a cosign public key proposed as the replacement trust anchor (requires --allow-signer-change) - --yes Skip the confirmation prompt (required when not running interactively) + --allow-ref-change[=true|false] Permit the artifact to move to a different repository during upgrade + --allow-signer-change[=true|false] Permit upgrading to an artifact signed by a different identity; the new identity replaces the recorded one + --clients string Comma-separated target client apps (e.g. claude-code,opencode), or "all" for every available client + --fail-on-changes[=true|false] Report what would change without installing anything; a CI freshness gate + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for upgrade + --preview[=true|false] Report what would change without persisting anything (OCI sources are still fetched to compare digests) + --project-root string Project root path (default: auto-detected from the current directory) + --public-key string Path to a cosign public key proposed as the replacement trust anchor (requires --allow-signer-change) + --yes[=true|false] Skip the confirmation prompt (required when not running interactively) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_skill_validate.md b/docs/toolhive/reference/cli/thv_skill_validate.md index 0a7cc7727..3c080e9b6 100644 --- a/docs/toolhive/reference/cli/thv_skill_validate.md +++ b/docs/toolhive/reference/cli/thv_skill_validate.md @@ -24,14 +24,14 @@ thv skill validate [path] [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for validate + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for validate ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_start.md b/docs/toolhive/reference/cli/thv_start.md index 70d589268..764668eb7 100644 --- a/docs/toolhive/reference/cli/thv_start.md +++ b/docs/toolhive/reference/cli/thv_start.md @@ -27,16 +27,16 @@ thv start [workload-name] [flags] ### Options ``` - -a, --all Restart all MCP servers - -f, --foreground Run the restarted workload in foreground mode (default false) - -g, --group string Filter by group - -h, --help help for start + -a, --all[=true|false] Restart all MCP servers + -f, --foreground[=true|false] Run the restarted workload in foreground mode (default false) + -g, --group string Filter by group + -h, --help[=true|false] help for start ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_status.md b/docs/toolhive/reference/cli/thv_status.md index 84575ca3b..39b5d5752 100644 --- a/docs/toolhive/reference/cli/thv_status.md +++ b/docs/toolhive/reference/cli/thv_status.md @@ -24,14 +24,14 @@ thv status [workload-name] [flags] ### Options ``` - --format string Output format (json or text) (default "text") - -h, --help help for status + --format string Output format (json or text) (default "text") + -h, --help[=true|false] help for status ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_stop.md b/docs/toolhive/reference/cli/thv_stop.md index 83a59042b..90e18757a 100644 --- a/docs/toolhive/reference/cli/thv_stop.md +++ b/docs/toolhive/reference/cli/thv_stop.md @@ -35,16 +35,16 @@ thv stop [workload-name...] [flags] ### Options ``` - -a, --all Stop all running MCP servers - -g, --group string Filter by group - -h, --help help for stop - --timeout int Timeout in seconds before forcibly stopping the workload (default 30) + -a, --all[=true|false] Stop all running MCP servers + -g, --group string Filter by group + -h, --help[=true|false] help for stop + --timeout int Timeout in seconds before forcibly stopping the workload (default 30) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_tui.md b/docs/toolhive/reference/cli/thv_tui.md index a258fe1a8..5fa1a883e 100644 --- a/docs/toolhive/reference/cli/thv_tui.md +++ b/docs/toolhive/reference/cli/thv_tui.md @@ -47,13 +47,13 @@ thv tui [flags] ### Options ``` - -h, --help help for tui + -h, --help[=true|false] help for tui ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_upgrade.md b/docs/toolhive/reference/cli/thv_upgrade.md index 03998668e..d8c93298e 100644 --- a/docs/toolhive/reference/cli/thv_upgrade.md +++ b/docs/toolhive/reference/cli/thv_upgrade.md @@ -24,13 +24,13 @@ comparison and never pull images. ### Options ``` - -h, --help help for upgrade + -h, --help[=true|false] help for upgrade ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_upgrade_apply.md b/docs/toolhive/reference/cli/thv_upgrade_apply.md index da7d73d2e..33133fc8c 100644 --- a/docs/toolhive/reference/cli/thv_upgrade_apply.md +++ b/docs/toolhive/reference/cli/thv_upgrade_apply.md @@ -47,18 +47,18 @@ thv upgrade apply [flags] ``` --ca-cert string Path to a custom CA certificate file to use when resolving the candidate image - --dry-run Print what the upgrade would change without applying it + --dry-run[=true|false] Print what the upgrade would change without applying it -e, --env stringArray Environment variables to set on the upgraded workload (format: KEY=VALUE, repeatable) - -h, --help help for apply + -h, --help[=true|false] help for apply --image-verification string Set image verification mode (warn, enabled, disabled) (default "warn") --secret stringArray Secrets to set on the upgraded workload (format: NAME,target=TARGET, repeatable) - -y, --yes Skip the confirmation prompt and run non-interactively (fail if required values are missing) + -y, --yes[=true|false] Skip the confirmation prompt and run non-interactively (fail if required values are missing) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_upgrade_check.md b/docs/toolhive/reference/cli/thv_upgrade_check.md index be1f501d4..14c3c9cec 100644 --- a/docs/toolhive/reference/cli/thv_upgrade_check.md +++ b/docs/toolhive/reference/cli/thv_upgrade_check.md @@ -39,14 +39,14 @@ thv upgrade check [workload-name] [flags] ### Options ``` - --format string Output format (json, text) (default "text") - -h, --help help for check + --format string Output format (json, text) (default "text") + -h, --help[=true|false] help for check ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_version.md b/docs/toolhive/reference/cli/thv_version.md index 9640c8a3c..23c05b404 100644 --- a/docs/toolhive/reference/cli/thv_version.md +++ b/docs/toolhive/reference/cli/thv_version.md @@ -24,15 +24,15 @@ thv version [flags] ### Options ``` - --format string Output format (json or text) (default "text") - -h, --help help for version - --json Output version information as JSON (deprecated, use --format instead) + --format string Output format (json or text) (default "text") + -h, --help[=true|false] help for version + --json[=true|false] Output version information as JSON (deprecated, use --format instead) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_vmcp.md b/docs/toolhive/reference/cli/thv_vmcp.md index d9d0ece7f..0509907a7 100644 --- a/docs/toolhive/reference/cli/thv_vmcp.md +++ b/docs/toolhive/reference/cli/thv_vmcp.md @@ -22,13 +22,13 @@ servers from a ToolHive group into a single unified endpoint. ### Options ``` - -h, --help help for vmcp + -h, --help[=true|false] help for vmcp ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_vmcp_init.md b/docs/toolhive/reference/cli/thv_vmcp_init.md index 5f5c420e9..f628f3420 100644 --- a/docs/toolhive/reference/cli/thv_vmcp_init.md +++ b/docs/toolhive/reference/cli/thv_vmcp_init.md @@ -32,16 +32,16 @@ thv vmcp init [flags] ### Options ``` - -c, --config string Output file path for the generated config; alias for --output - -g, --group string ToolHive group name to discover workloads from (required) - -h, --help help for init - -o, --output string Output file path for the generated config (default: stdout) + -c, --config string Output file path for the generated config; alias for --output + -g, --group string ToolHive group name to discover workloads from (required) + -h, --help[=true|false] help for init + -o, --output string Output file path for the generated config (default: stdout) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_vmcp_serve.md b/docs/toolhive/reference/cli/thv_vmcp_serve.md index 48243c7ee..a847b68fb 100644 --- a/docs/toolhive/reference/cli/thv_vmcp_serve.md +++ b/docs/toolhive/reference/cli/thv_vmcp_serve.md @@ -32,23 +32,23 @@ thv vmcp serve [flags] ### Options ``` - -c, --config string Path to vMCP configuration file - --embedding-image string TEI container image (Tier 2) (default "ghcr.io/huggingface/text-embeddings-inference:cpu-latest") - --embedding-model string HuggingFace model name for semantic search (Tier 2) (default "BAAI/bge-small-en-v1.5") - --enable-audit Enable audit logging with default configuration - --group string ToolHive group name (zero-config quick mode when --config is omitted) - -h, --help help for serve - --host string Host address to bind to (default "127.0.0.1") - --optimizer Enable FTS5 keyword optimizer (Tier 1): exposes find_tool and call_tool instead of all backend tools - --optimizer-embedding Enable managed TEI semantic optimizer (Tier 2); implies --optimizer - --port int Port to listen on (default 4483) - --session-ttl duration Session inactivity timeout (e.g., 30m, 2h); zero uses the default (30m) + -c, --config string Path to vMCP configuration file + --embedding-image string TEI container image (Tier 2) (default "ghcr.io/huggingface/text-embeddings-inference:cpu-latest") + --embedding-model string HuggingFace model name for semantic search (Tier 2) (default "BAAI/bge-small-en-v1.5") + --enable-audit[=true|false] Enable audit logging with default configuration + --group string ToolHive group name (zero-config quick mode when --config is omitted) + -h, --help[=true|false] help for serve + --host string Host address to bind to (default "127.0.0.1") + --optimizer[=true|false] Enable FTS5 keyword optimizer (Tier 1): exposes find_tool and call_tool instead of all backend tools + --optimizer-embedding[=true|false] Enable managed TEI semantic optimizer (Tier 2); implies --optimizer + --port int Port to listen on (default 4483) + --session-ttl duration Session inactivity timeout (e.g., 30m, 2h); zero uses the default (30m) ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/cli/thv_vmcp_validate.md b/docs/toolhive/reference/cli/thv_vmcp_validate.md index 0f88282be..2e9d64edc 100644 --- a/docs/toolhive/reference/cli/thv_vmcp_validate.md +++ b/docs/toolhive/reference/cli/thv_vmcp_validate.md @@ -28,14 +28,14 @@ thv vmcp validate [flags] ### Options ``` - -c, --config string Path to vMCP configuration file (required) - -h, --help help for validate + -c, --config string Path to vMCP configuration file (required) + -h, --help[=true|false] help for validate ``` ### Options inherited from parent commands ``` - --debug Enable debug mode + --debug[=true|false] Enable debug mode ``` ### SEE ALSO diff --git a/docs/toolhive/reference/helm/operator-crds.mdx b/docs/toolhive/reference/helm/operator-crds.mdx index a3a2ce3bf..9ab3e7fbf 100644 --- a/docs/toolhive/reference/helm/operator-crds.mdx +++ b/docs/toolhive/reference/helm/operator-crds.mdx @@ -11,9 +11,9 @@ Control CRD installation and preservation with these Helm values. This reference lists values declared in the chart's default `values.yaml`. Templates can also accept optional settings and inherited `global` values. -Chart: `toolhive-operator-crds`. Chart version: `0.61.0`. Source: -[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.61.0/deploy/charts/operator-crds/values.yaml) -at `v0.61.0`. +Chart: `toolhive-operator-crds`. Chart version: `0.64.0`. Source: +[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.64.0/deploy/charts/operator-crds/values.yaml) +at `v0.64.0`. ## Values diff --git a/docs/toolhive/reference/helm/operator.mdx b/docs/toolhive/reference/helm/operator.mdx index cf28352a8..6599af556 100644 --- a/docs/toolhive/reference/helm/operator.mdx +++ b/docs/toolhive/reference/helm/operator.mdx @@ -10,9 +10,9 @@ Configure the ToolHive operator with these Helm values. This reference lists values declared in the chart's default `values.yaml`. Templates can also accept optional settings and inherited `global` values. -Chart: `toolhive-operator`. Chart version: `0.61.0`. Source: -[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.61.0/deploy/charts/operator/values.yaml) -at `v0.61.0`. +Chart: `toolhive-operator`. Chart version: `0.64.0`. Source: +[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.64.0/deploy/charts/operator/values.yaml) +at `v0.64.0`. ## Values @@ -73,7 +73,7 @@ features: gc: gogc: 75 gomemlimit: 110MiB -image: ghcr.io/stacklok/toolhive/operator:v0.61.0 +image: ghcr.io/stacklok/toolhive/operator:v0.64.0 imageDiscovery: enabled: false resources: {} @@ -158,8 +158,8 @@ serviceAccount: labels: {} name: toolhive-operator tolerations: [] -toolhiveRunnerImage: ghcr.io/stacklok/toolhive/proxyrunner:v0.61.0 -vmcpImage: ghcr.io/stacklok/toolhive/vmcp:v0.61.0 +toolhiveRunnerImage: ghcr.io/stacklok/toolhive/proxyrunner:v0.64.0 +vmcpImage: ghcr.io/stacklok/toolhive/vmcp:v0.64.0 volumeMounts: [] volumes: [] ``` @@ -318,7 +318,7 @@ Key containing the PEM-encoded CA certificate in the Secret. **Type:** `string` -**Default:** `"ghcr.io/stacklok/toolhive/operator:v0.61.0"` +**Default:** `"ghcr.io/stacklok/toolhive/operator:v0.64.0"` Container image for the operator. @@ -334,7 +334,7 @@ Image pull policy for the operator container and image-discovery containers. **Type:** `string` -**Default:** `"ghcr.io/stacklok/toolhive/proxyrunner:v0.61.0"` +**Default:** `"ghcr.io/stacklok/toolhive/proxyrunner:v0.64.0"` Container image for ToolHive proxy runners created by the operator. @@ -342,7 +342,7 @@ Container image for ToolHive proxy runners created by the operator. **Type:** `string` -**Default:** `"ghcr.io/stacklok/toolhive/vmcp:v0.61.0"` +**Default:** `"ghcr.io/stacklok/toolhive/vmcp:v0.64.0"` Container image for Virtual MCP Server (vMCP) deployments created by the operator. diff --git a/static/api-specs/toolhive-api.yaml b/static/api-specs/toolhive-api.yaml index 3c4a01a5d..7d16c424f 100644 --- a/static/api-specs/toolhive-api.yaml +++ b/static/api-specs/toolhive-api.yaml @@ -278,7 +278,9 @@ components: refresh_token_max_lifetime: description: |- RefreshTokenMaxLifetime caps the lifetime of grants that can be exchanged - for child refresh tokens. Empty refuses those grants. + for child refresh tokens. Empty refuses those grants. Setting it also needs + id_jag_max_lifetime, because a child allows ID-JAGs and is capped by that + value; validation rejects refresh_token_max_lifetime without it. type: string type: object authserver.DelegateClientRunConfig: diff --git a/static/api-specs/toolhive-crds/mcpexternalauthconfigs.schema.json b/static/api-specs/toolhive-crds/mcpexternalauthconfigs.schema.json index 02b38d65f..16bf37100 100644 --- a/static/api-specs/toolhive-crds/mcpexternalauthconfigs.schema.json +++ b/static/api-specs/toolhive-crds/mcpexternalauthconfigs.schema.json @@ -1059,6 +1059,52 @@ }, "type": "object" }, + "tlsListener": { + "description": "TLSListener configures an additional TLS listener on port 8443 that\nserves the embedded authorization server's routes. MCP traffic, health\nprobes and metrics stay on plain HTTP. Both certificateSecretRef and\nprivateKeySecretRef are required. It is required when\ninboundGrants.spiffeClientAuth enables spiffe_x509. That requirement is\nchecked when the resource is reconciled and reported in status conditions;\nthe API server does not reject it. The operator exposes the listener as an\nhttps-auth container port and Service port 8443. Updates to the referenced\nSecret contents are picked up without a pod restart.", + "properties": { + "certificateSecretRef": { + "description": "CertificateSecretRef references the PEM-encoded TLS certificate.", + "properties": { + "key": { + "description": "Key is the key within the secret", + "type": "string" + }, + "name": { + "description": "Name is the name of the secret", + "type": "string" + } + }, + "required": [ + "key", + "name" + ], + "type": "object" + }, + "privateKeySecretRef": { + "description": "PrivateKeySecretRef references the PEM-encoded TLS private key.", + "properties": { + "key": { + "description": "Key is the key within the secret", + "type": "string" + }, + "name": { + "description": "Name is the name of the secret", + "type": "string" + } + }, + "required": [ + "key", + "name" + ], + "type": "object" + } + }, + "required": [ + "certificateSecretRef", + "privateKeySecretRef" + ], + "type": "object" + }, "tokenLifespans": { "description": "TokenLifespans configures the duration that various tokens are valid.\nIf not specified, defaults are applied (access: 1h, refresh: 7d, authCode: 10m).", "properties": { diff --git a/static/api-specs/toolhive-crds/virtualmcpservers.schema.json b/static/api-specs/toolhive-crds/virtualmcpservers.schema.json index 62a7b6bc8..71a5b2fae 100644 --- a/static/api-specs/toolhive-crds/virtualmcpservers.schema.json +++ b/static/api-specs/toolhive-crds/virtualmcpservers.schema.json @@ -950,6 +950,52 @@ }, "type": "object" }, + "tlsListener": { + "description": "TLSListener configures an additional TLS listener on port 8443 that\nserves the embedded authorization server's routes. MCP traffic, health\nprobes and metrics stay on plain HTTP. Both certificateSecretRef and\nprivateKeySecretRef are required. It is required when\ninboundGrants.spiffeClientAuth enables spiffe_x509. That requirement is\nchecked when the resource is reconciled and reported in status conditions;\nthe API server does not reject it. The operator exposes the listener as an\nhttps-auth container port and Service port 8443. Updates to the referenced\nSecret contents are picked up without a pod restart.", + "properties": { + "certificateSecretRef": { + "description": "CertificateSecretRef references the PEM-encoded TLS certificate.", + "properties": { + "key": { + "description": "Key is the key within the secret", + "type": "string" + }, + "name": { + "description": "Name is the name of the secret", + "type": "string" + } + }, + "required": [ + "key", + "name" + ], + "type": "object" + }, + "privateKeySecretRef": { + "description": "PrivateKeySecretRef references the PEM-encoded TLS private key.", + "properties": { + "key": { + "description": "Key is the key within the secret", + "type": "string" + }, + "name": { + "description": "Name is the name of the secret", + "type": "string" + } + }, + "required": [ + "key", + "name" + ], + "type": "object" + } + }, + "required": [ + "certificateSecretRef", + "privateKeySecretRef" + ], + "type": "object" + }, "tokenLifespans": { "description": "TokenLifespans configures the duration that various tokens are valid.\nIf not specified, defaults are applied (access: 1h, refresh: 7d, authCode: 10m).", "properties": {