OAuth Shared account authority
Use the xAI OAuth client lineage documented by Hermes Agent and OpenClaw.
xAI OAuth tool activation
progrok
Activate your xAI OAuth session as a local Grok API surface. progrok turns the same account session pattern used by Hermes Agent, OpenClaw, and Grok Build-style workflows into a localhost proxy plus direct CLI commands for search, reasoning, image generation, and video generation.
npm install -g progrok
progrok login
progrok proxy
curl http://127.0.0.1:18645/v1/chat/completions \
-H "Authorization: Bearer anything" \
-H "Content-Type: application/json" \
-d '{"model":"grok-4.3","messages":[{"role":"user","content":"Hello"}]}'What it activates
One OAuth session, many Grok tool paths.
progrok is an activation layer, not a new account system. Login once, keep the refreshable credential local, then let clients and tools use Grok through interfaces they already understand.
/v1/* OpenAI-compatible proxy
Point SDKs and agents at localhost while progrok injects the real bearer token.
grok-build Coding tool ready
Expose Grok Build and general Grok models to tools that expect a base URL and key.
media Direct workflow commands
Search, image, video, model, and capability commands use the same OAuth session.
Use any client
Make OAuth look like a normal local API.
The proxy replaces placeholder bearer tokens with your refreshed xAI OAuth token before forwarding requests to api.x.ai. That means OpenAI SDKs, curl scripts, coding agents, and Grok Build-style tools can call Grok through the same local endpoint without each one learning the xAI login flow.
from openai import OpenAI
client = OpenAI(
base_url="http://127.0.0.1:18645/v1",
api_key="anything",
)
result = client.chat.completions.create(
model="grok-4.3",
messages=[{"role": "user", "content": "Explain MCP in 5 bullets"}],
)
print(result.choices[0].message.content)CLI commands
Direct commands for work a proxy cannot polish.
Some Grok APIs need source routing, output files, async polling, or machine-readable discovery. progrok wraps those workflows directly while still using the same OAuth credential.
progrok login Authenticate
Browser or device-code OAuth login for local token storage.
progrok proxy Run the proxy
Start the OpenAI-compatible server on 127.0.0.1:18645.
progrok search Search current sources
Use Grok web and X search with citations, JSON, and reasoning effort.
progrok image Generate images
Create or edit Imagine images directly from the terminal.
progrok video Generate video
Submit text-to-video or image-to-video jobs and poll until complete.
progrok models Inspect models
List aliases, pricing, context windows, and media model capabilities.
progrok status Check auth
See whether your OAuth session is present and when it expires.
progrok capabilities Export metadata
Print a machine-readable capability surface for agents and scripts.
Operational truth
Local by default, account-bound by design.
progrok requires an active SuperGrok subscription. It stores refreshed OAuth credentials in your home directory, activates the tools your account can access, and does not bypass product limits, quotas, or pricing. Collection management still requires xAI management credentials.
Security model
The proxy only binds to localhost by default. Do not expose the port to a public network unless you add your own access controls in front of it.