hellogrok-cli

hellowind777·hellowind777.hellogrok.CLI

Console-only CLI of hellogrok, a local proxy that makes Grok Build custom model channels work with common API formats, native Web tools, isolated authentication, and automatic configuration recovery.

Grok Build can use custom model endpoints, but real-world providers do not all expose the same protocol, response shape, authentication method, or Web-search behavior. hellogrok provides one local compatibility layer for those custom channels: it prepares the required Grok configuration while running, keeps each channel tied to its own endpoint and credentials, supports Grok Build native Web workflows, and restores the original configuration when stopped. This console-only build runs the same proxy from the terminal without the tray application; run `hellogrok help` for the full CLI reference (start, version, routes, restore, autostart, log, logview).

winget install --id hellowind777.hellogrok.CLI --exact --source winget

Latest 0.1.1·August 7, 2026

Release Notes

Added

  • Explicit search model selection via [models].web_search config key and GROK_WEB_SEARCH_MODEL environment variable, with env taking precedence over config.
  • Hosted search capability auto-detection for Grok relay channels at startup (web_search + x_search probing).
  • Chat Completions search dialect auto-detection (search_parameters vs web_search_options).
  • CC Switch takeover detection before config rewrite — start is refused when CC Switch already owns Grok Build.
  • Single-instance enforcement for both tray and foreground modes via OS-level lock.
  • Windows log window application icon display in title bar and taskbar.
  • Search route resolution logging at startup, visible in hellogrok routes and the log window. Changed
  • Tray now defaults to proxy-enabled on first launch.
  • Tray quit defers exit when a config-ownership conflict exists, preventing orphaned proxy URLs.
  • SIGINT/SIGTERM handlers retry stop on deferred errors instead of leaving the process inconsistent.
  • BackendSearchSet field distinguishes explicit supports_backend_search declarations from Build's false default, enabling runtime probing for unset values.
  • Route now carries HostedSearchKnown, HostedWebSearch, HostedXSearch, and HostedChatSearchDialect for capability-aware request normalization.
  • Tool choice normalization is now capability-aware — only confirmed hosted search declarations are injected. Fixed
  • Managed search flag now placed after channel settings in config rewrites, preventing key-ordering issues.
  • Client search wire alias properly hidden from upstream requests.

Installer type: portable

x645BB4E3F86D2D809574256243E1955FA215E6071C0494BD7E00E69490A8882AF6
arm640DA77400A0E688C126DC0E1C5F672ED5E6F094BE89FFC1132D5D95840AEF9861

Details

Homepage
https://github.com/hellowind777/hellogrok
License
MIT
Publisher
hellowind777
Support
https://github.com/hellowind777/hellogrok/issues
Copyright
Copyright (c) 2026 hellowind777

Tags

grokgrok-buildproxy