Skip to content

feat: add Grok Build CLI provider - #26698

Closed
canderson26 wants to merge 6 commits into
NousResearch:mainfrom
canderson26:feat/grok-build-cli-provider
Closed

feat: add Grok Build CLI provider#26698
canderson26 wants to merge 6 commits into
NousResearch:mainfrom
canderson26:feat/grok-build-cli-provider

Conversation

@canderson26

Copy link
Copy Markdown

Summary

Adds a first-class grok-build provider backed by the local Grok CLI.

  • Registers grok-build in the provider registry, model catalog, aliases, model picker, runtime resolver, and auxiliary client path
  • Adds GrokCliClient, an OpenAI-compatible shim around grok --prompt-file
  • Defaults to --no-memory --disable-web-search --max-turns 1 --output-format plain --effort xhigh
  • Supports HERMES_GROK_BUILD_COMMAND, GROK_CLI_PATH, HERMES_GROK_BUILD_ARGS, and HERMES_GROK_BUILD_EFFORT
  • Documents setup and supported provider lists

Testing

  • venv/bin/python -m py_compile agent/grok_cli_client.py hermes_cli/auth.py hermes_cli/models.py hermes_cli/runtime_provider.py hermes_cli/providers.py hermes_cli/model_normalize.py hermes_cli/main.py hermes_cli/model_switch.py hermes_cli/setup.py agent/auxiliary_client.py agent/model_metadata.py run_agent.py tests/agent/test_grok_cli_client.py tests/hermes_cli/test_api_key_providers.py tests/hermes_cli/test_model_validation.py tests/run_agent/test_run_agent.py
  • venv/bin/python -m pytest tests/agent/test_grok_cli_client.py tests/hermes_cli/test_api_key_providers.py tests/hermes_cli/test_model_validation.py tests/run_agent/test_run_agent.py::test_aiagent_uses_grok_cli_client
  • venv/bin/hermes chat -q "Reply exactly with: HERMES_GROK_BUILD_OK_2" --provider grok-build -m grok-build --ignore-rules

Notes

The provider relies on an already-authenticated local Grok CLI session. Run grok login and confirm grok models includes grok-build.

@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have provider/xai xAI (Grok) comp/agent Core agent runtime: loop, agent_init, prompt builder, context-compression, responses endpoint comp/cli CLI entry point, hermes_cli/, setup wizard labels May 16, 2026
@alt-glitch

Copy link
Copy Markdown
Collaborator

Related xAI/Grok provider work:

This PR adds a grok-build CLI-shim provider, which overlaps with #25968's approach of wrapping the Grok CLI. Please coordinate to avoid duplicated effort.

@canderson26

Copy link
Copy Markdown
Author

Closing this polluted branch. It accidentally picked up unrelated local work after the Grok Build provider commit. A clean replacement branch/PR will be used instead.

@canderson26
canderson26 deleted the feat/grok-build-cli-provider branch May 16, 2026 13:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/agent Core agent runtime: loop, agent_init, prompt builder, context-compression, responses endpoint comp/cli CLI entry point, hermes_cli/, setup wizard P3 Low — cosmetic, nice to have provider/xai xAI (Grok) type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants