grok-bot-sdkGrok Bot client protocol, in Node.js

Browser login, the bot roster, sessions, transcript, tasks, normalized avatars, send, and Connect replies forwarded as SSE. Matched to Grok Bot 0.78.1. Unofficial.

Authorize

API reference

中文

Your own browser login

PKCE-style login on cursor.com, then a poll for an access token. The official client's saved session stays where it is.

One avatar shape

Explicit server fields win. Missing or invalid shape and color are derived from the agent UUID, each field on its own.

Replies as SSE

watchBot reads the Connect JSON transcript stream. botEventsSSE turns those events into a standard text/event-stream Response.

The limits are written down

No token refresh, no local file upload, no per-token stream claim, and no automatic resend. Read the notes before you ship a bot.

Community

The author is 铁柱AGI on X (@cgnot996). The desktop workbench for local Grok Build is Grok App. The course that walks through Grok Bot itself is the learning site.

Author WeChat QR for the paid community

Search 铁柱AGI for the WeChat official account. The right code is the author's personal WeChat. The paid community is joined by adding that account and asking to be invited.