hellogrok

hellowind777·hellowind777.hellogrok

Cross-platform 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.

winget install --id hellowind777.hellogrok --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

x64461A3EA8571640FF215929EDB04E4BED1134B8301C7C0CC807015BE9F8C3D35E
arm64A8FC691CCE86F9190EC4C4A738EAB4683851A338902EBB18EB6BED915DA22964

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