Grok Bot vs Grok Build: five names, three programmable surfaces

If you searched for a Grok Bot API you are in the right place and the answer is going to disappoint you. There isn't one. There are five named xAI-adjacent products plus the xAI API, they have wildly different capabilities, and exactly three surfaces are programmable. Here is the map, with a primary source on every row.

By the Continuum team. We build a workbench that runs Claude Code, Codex, and their peers, so the model rates quoted here are the ones our own cost analytics ship with.

The short version

Grok Bot is the always-on teammate product launched 11 August 2026, and it has no public API, webhook or programmatic surface. Grok Build is the official xAI coding CLI, announced 25 May 2026, defaulting to grok-4.6, with documented headless flags, JSON output formats, an ACP agent mode and Workflows that fan out across up to 128 parallel agents per run and up to 1,024 for larger jobs. Grok Automations, renamed from Tasks on 16 July 2026, adds schedule and email triggers on grok.com and has no API either. Imagine Agent Mode is a creative canvas and unrelated to both. superagent-ai/grok-cli is a programmable community project with 3,400 stars that shares the name with the official CLI and never mentions it. The three programmable surfaces are Grok Build, the community grok-cli, and the xAI API itself.

What you need to know
  • Grok Bot has no API. No public endpoint, no webhook, no documented programmatic surface as of 22 August 2026.
  • Grok Build is the programmable one. Official CLI, grok-4.6 by default, headless flags, JSON output, and an ACP agent over stdio.
  • Grok Build left beta around 7 August 2026, reaching 1.0.5 by 15 August. Every article still calling it an early beta is out of date.
  • Grok Build needs only SuperGrok at $30 or X Premium+, not Heavy. Pages pricing it near $300 are out by roughly ten times.
  • Grok Automations is not Grok Build, and "Tasks" is its old name. Schedule and email triggers, no API, email triggers need SuperGrok.
  • There are two different tools called grok CLI. The official grok from xAI, and the community superagent-ai project with 3,400 stars.
  • "Grok agent mode" is two unrelated products. Imagine Agent Mode is a creative canvas; Grok Build is the coding agent.
  • If you need to automate agents, build against a CLI, not a chat product. That is the honest answer, and it applies beyond xAI.

The map

xAI shipped a great deal in ninety days and named much of it similarly. This table is the whole page in one place; the sections after it add the detail.

Five named products plus the xAI API, and the three programmable surfaces.checked 22 aug 2026
ProductWhat it isShippedWhere you use itProgrammable?
Grok BotAlways-on named teammates on a shared cloud VM11 Aug 2026, betaMac, Windows and iOS appsNo public API
Grok BuildOfficial coding CLI and agent25 May 2026, 1.0 since ~7 AugYour terminalYes. Headless, JSON, ACP
Grok AutomationsScheduled and email-triggered runs, formerly "Tasks"16 Jul 2026grok.com, iOS and AndroidNo API
Imagine Agent ModeCreative canvas agentMay 2026grok.com/imagineNot a developer surface
superagent-ai/grok-cliCommunity CLI agent, 3,400 starsCommunity projectYour terminalYes, it is open source
The xAI APIThe actual programmable surfaceOngoingapi.x.ai/v1Yes
FIVE NAMES, AND WHERE THE API ACTUALLY ISchecked 22 August 2026Grokthe chatbotone question at a timegrok.com, appsno APIGrok Botalways-on named agentsa shared cloud computerMac, Windows, iOSno APIGrok Automationsschedules and triggersformerly called Tasksgrok.com, mobileno APIGrok Buildthe official coding CLIheadless · JSON · ACPyour terminalAPIgrok-cli3,400 stars, open sourcecommunity, not from xAIyour terminalno APIthe xAI APIthe programmable surfaceapi.x.ai/v1your own codeAPITwo of the six can be called from your own code. Grok Bot is not one of them.
Five named products plus the xAI API; three programmable surfaces. Grok Build, the community grok-cli, and the xAI API can be called from your own code.

Grok Bot: the product with no API

Grok Bot launched on 11 August 2026 in beta. You create named Bots and message them like colleagues. Each Bot works on a persistent cloud Linux VM with a browser, a filesystem and a terminal, and the documentation is specific that the VM is shared: "All of your Bots use the same persistent cloud computer", each gets its own screen on it "without getting separate security boundaries", and you should "treat a login or file placed on the computer as available to all of your Bots".

Bots use connectors and MCP where an API exists, and computer use, meaning driving the graphical interface, for apps and websites that do not have one. Named Bots keep memory, files, browser sessions and preferences across turns. You can walk a Bot through a multi-step path once and it persists that path as a routine to re-run on a schedule or on demand.

What none of that gives you is a way in from your own code. There is no documented public API, no webhook, and no programmatic trigger. Neither the Grok Bot documentation nor any launch coverage describes one. This is a coherent product decision rather than an oversight, because the whole design premise is a human messaging a colleague, but it does mean the phrase "Grok Bot integrations" means connectors that Bots use, not integrations that call Bots.

Grok Bot access and constraints, as of 22 August 2026.
QuestionAnswer
Public APINone
WebhooksNone documented
Eligible plansSuperGrok Plus, SuperGrok Heavy, Cursor Pro+, Cursor Ultra, Cursor Teams Standard or Premium
Cursor account requiredYes, on every path
Model selectionNone. Automatic routing; xAI names no default model
PlatformsmacOS (Apple silicon and Intel), Windows (x64 and Arm64), iOS. Docs say no Linux desktop app
EnterpriseWaitlist
Dry-run modeNone. A test run performs real work

One platform wrinkle worth flagging because three ranking articles get it wrong in the other direction: the documentation states plainly that Grok Bot is not currently available as a Linux desktop app, while the download page has been reported to serve a Debian package anyway. A Hacker News commenter, gexla, reported exactly that confusion on launch day. If you are on Linux, do not plan around a Linux client existing.

Grok Build: the one you can actually script

Grok Build is xAI's official coding CLI, announced 25 May 2026. Two facts about it are wrong nearly everywhere, and both make it look worse than it is.

  • It is not in beta any more. Grok Build reached 1.0 around 7 August 2026 and has shipped steadily since, reaching 1.0.5 by 15 August, and it switched its default model to Grok 4.6 on 13 August. Every article currently ranking for Grok coding comparisons still describes it as an early beta, which was true in May and has not been true for weeks.
  • It does not require SuperGrok Heavy. xAI's own announcement puts availability at "SuperGrok and X Premium Plus subscribers", which is the $30 a month tier. Several ranking pages price it at $299 or say there is no individual tier at all. The figure the internet quotes is roughly ten times the real one.

That second point is the single most useful thing on this page for a developer, because it inverts the usual conclusion. Grok Build, the programmable one, is on the cheap tier. Grok Bot, the one with no API, is on the expensive tiers. If you assumed the coding agent was the premium product, you had it backwards.

Grok Build install, authentication and configuration.
Command or fact
macOS, Linux, WSLcurl -fsSL https://x.ai/cli/install.sh | bash
Windows PowerShellirm https://x.ai/cli/install.ps1 | iex
Status1.0 since around 7 August 2026, 1.0.5 by 15 August
Default modelgrok-4.6, default since 13 August 2026
Subscription accessSuperGrok ($30) or X Premium+, not Heavy-only
Config~/.grok, overridable with GROK_HOME
Instruction filesReads AGENTS.md and CLAUDE.md
Also supportsClaude-style skills, hooks, plugins and MCP servers
Browser authOpens a browser; requires SuperGrok or X Premium+
Non-browser authexport XAI_API_KEY="xai-...", which bills the API account

The CLAUDE.md line is worth pausing on if you are evaluating a switch. A repository already carrying Claude Code project instructions and skills is closer to running under Grok Build than most migration guides suggest, because the CLI reads both instruction formats rather than demanding a rewrite.

The dual authentication path is the thing that trips people up, and it matters for cost. Browser authentication rides a consumer subscription. API-key authentication bills your xAI API account at per-token rates. In CI, or anywhere without a browser, you are on the second path whether you meant to be or not.

The Grok Build command set.
CommandWhat it does
grokThe interactive terminal session
grok execRun a task non-interactively, the rough equivalent of claude -p
grok planPlan before writing, the rough equivalent of Claude Code plan mode
grok applyApply a prepared change
grok goalWork toward a stated objective across steps
grok arenaRaces up to 8 parallel subagents against the same task
grok mcp addRegister an MCP server, the rough equivalent of claude mcp add
grok inspectShow discovered config, instructions, skills, plugins, hooks and MCP servers
grok agent stdioExpose the agent over JSON-RPC for another program to drive

The headless surface is the part nothing else on the web documents properly, and it is the reason Grok Build is the answer to "how do I automate this".

Grok Build headless flags, from the official scripting documentation.
FlagWhat it does
-p, --single <PROMPT>Send one prompt and exit
-m, --model <MODEL>Override the model for this run
-s, --session-id <ID>Create or resume a named headless session
--output-format plain | json | streaming-jsonMachine-readable output, which is what makes it scriptable
--no-alt-screenRun inline instead of taking over the terminal
--no-auto-updateThe docs explicitly say to pass this in scripts and CI
grok agent stdioJSON-RPC agent over stdin and stdout, the ACP surface
grok inspectShows discovered config sources, instructions, skills, plugins, hooks and MCP servers

One model-level correction while we are here, because it circulated widely in launch-week press and is still repeated: the grok-build-0.1 coding model has a 256,000-token context window, not the 2 million some coverage claimed. If you sized a workflow around the larger figure, resize it. Separately, grok-code-fast-1 was deprecated in May 2026 and retired around 15 August, so any comparison still quoting its benchmark scores is describing a model you can no longer run.

On top of that sits Workflows, announced 23 July 2026: you describe a task in plain language and it fans out across up to 128 parallel agents per run, and up to 1,024 for larger jobs, each with its own focused context. Progress checkpoints let a run pause and resume, /workflows shows live per-agent token tracking, saved workflows become custom slash commands, and a built-in /deep-research verifies claims against sources. Workflows is a Grok Build feature. It is not part of Grok Bot, and conflating the two is one of the more common errors in circulation.

Grok Automations, formerly Tasks

This is the third product people mean when they say they want Grok to do something on a schedule, and most of the pages ranking for it describe a version that no longer exists.

Grok Automations was announced on 16 July 2026, replacing and rebuilding the feature previously called Tasks. It lives at grok.com/automations plus the iOS and Android apps. There are two trigger types: schedules, which run once, daily, on weekdays, weekly, monthly or yearly; and email triggers, which fire on sender, recipient or subject filters. Basic scheduling is free to everyone. Email triggers require SuperGrok at $30 a month.

Automations has no API either. So of the three xAI products that can run work unattended, two of them, Bots and Automations, are driven only through their own interfaces, and one of them, Grok Build, is a CLI you can script. That is the shape of the platform today and it is worth planning around rather than waiting on.

The two remaining confusions

"Grok agent mode" is a query split across two unrelated products, and no page currently resolves it. Imagine Agent Mode arrived in May 2026 at grok.com/imagine and is a creative canvas: image and video work, not code and not automation. Grok Build is the coding agent. If you searched agent mode wanting to ship software, you want Grok Build.

"Grok CLI" is worse, because two entirely different tools ship under the name and neither acknowledges the other. There is grok, the official xAI CLI described above. And there is superagent-ai/grok-cli, a community project with roughly 3,400 stars and active development, offering plan mode, MCP, sub-agents and Telegram remote control, and defaulting to grok-4.3 rather than grok-4.6. Its README contains no reference to the official Grok Build CLI, so anybody arriving from a search for "grok cli" can install it believing it is xAI's own tool.

The two things called grok CLI.
Official (Grok Build)Community (superagent-ai/grok-cli)
PublisherxAIsuperagent-ai
Installcurl -fsSL https://x.ai/cli/install.sh | bashFrom the GitHub project
Default modelgrok-4.6grok-4.3
AuthBrowser (SuperGrok or X Premium+) or XAI_API_KEYYour xAI API key
Headless and ACPDocumentedIts own surfaces
WorkflowsYes, up to 128 parallel agents per runSub-agents
Open sourceReported open-sourced around July 2026Yes

Neither is wrong to exist. But if a colleague says "use the Grok CLI", ask which one, because the model defaults differ, the authentication differs, and only one of them gets support from xAI. Our Grok CLI guide covers the official tool in detail.

The xAI API, since that is where you end up

Anyone who arrived searching for a Grok Bot API is going to end up here, so it is worth putting the essentials on the page rather than sending you away for them. Everything below is from xAI's own documentation, fetched 22 August 2026.

Access. From docs.x.ai.
Base URLhttps://api.x.ai/v1
Consoleconsole.x.ai
Environment variableXAI_API_KEY, read automatically by the official SDK
Key prefixxai-
Primary endpointPOST /v1/responses, with Chat Completions also supported
OpenAI compatibilityYes. Swap the base URL and keep your existing client
Subscription required?No. The API is standalone and self-serve

Two facts about that table deserve emphasis because the pages currently ranking get them wrong. First, you do not need a SuperGrok or Premium+ subscription to use the API, despite at least one well-ranked tutorial implying otherwise. Second, an Anthropic-compatible endpoint is claimed in several secondary sources and we could not verify it: both plausible documentation paths returned 404, so we are not asserting it exists. If your migration plan depends on it, test it before you commit.

Rate limits by tier. Tiers are set by cumulative API spend since 1 January 2026 and never downgrade.
TierSpend thresholdgrok-4.6 and 4.5 at this tier
0$0, the default150 requests per second, 50M tokens per minute
1$50 or moreBetween tier 0 and tier 4
2$250 or moreBetween tier 0 and tier 4
3$1,000 or moreBetween tier 0 and tier 4
4$5,000 or more500 requests per second, 100M tokens per minute
EnterpriseOn requestNegotiated

Prompt, completion, reasoning and cached tokens all count toward the tokens-per-minute limit, which is a genuine gotcha for anybody assuming cached input is free of quota as well as cheap. Exceeding a limit returns HTTP 429 and the documentation recommends exponential backoff. Non-token charges are billed separately: web and X search at $5 per thousand calls, code execution at $5 per thousand, file attachments at $10 per thousand, image generation at $0.02 each. Batch processing is 20 percent off standard rates on selected models, and priority processing is double.

And the one that catches long-running agents: the 200,000-token threshold applies to the entire request, not incrementally. A 210,000-token prompt bills all of it at $4 input and $12 output rather than the first 200,000 at the standard rate. An agent that accumulates context across a long session crosses that line without any signal that it has.

So what do you actually build against?

If your goal is agents running unattended and controlled from your own code, the honest answer is that you build against a CLI or the raw API, not against a chat product. That is true of xAI and it is true of the category generally.

01

For scripted agent runs, use Grok Build headless

The combination that matters is -p for a single prompt, --output-format json or streaming-json for parseable output, -s to resume a named session, and --no-auto-update because the docs tell you to pass it in CI. That is a real automation surface.

02

For an agent your own tooling drives, use ACP

grok agent stdio exposes a JSON-RPC agent over stdin and stdout. That is the interface a workbench or an editor integrates against, and it is why Grok Build can be hosted by something other than its own terminal UI.

03

For raw model calls, use the xAI API

Base URL api.x.ai/v1, keys from console.x.ai with the xai- prefix, read from XAI_API_KEY, OpenAI-compatible by swapping the base URL. grok-4.6 carries a 500,000-token context window and a February 2026 knowledge cutoff, priced at $2 per million input and $6 per million output, with cached input at $0.50. Watch the 200,000-token threshold: past it the entire request bills at the higher tier, not just the excess.

04

For orchestrating several labs at once, use a workbench

Grok Build is one CLI in one terminal. If the actual job is running it alongside Claude Code, Codex and Cursor, with isolation and review furniture around each session, that is a different layer of the stack.

That last step is where Continuum fits, and it is worth being precise about the relationship. Continuum does not replace Grok Build; it hosts it. It runs Grok alongside Claude Code, Codex, Cursor, Gemini, and OpenCode on a Mac, Linux or Windows machine you own, gives each Code session its own git worktree, gates writes behind a plan you approve, shows live quota gauges, records spend by repository and provider, and is driven from a native iPhone client or the web so the run continues when you close your laptop. The app is free.

If you came here for the Bot side rather than the Build side, what Grok Bot actually is covers the product in depth, and the alternatives guide ranks eight always-on options against it.

Questions people ask

Does Grok Bot have an API?

No. As of 22 August 2026 Grok Bot has no public API, no webhook and no documented programmatic surface. Neither the Grok Bot documentation nor any launch coverage describes one. Among xAI's agent products, only Grok Build, the official CLI, and the xAI API itself are programmable.

What is the difference between Grok Bot and Grok Build?

Grok Bot is an always-on teammate product launched 11 August 2026: named Bots on a shared cloud VM, driven from Mac, Windows and iOS apps, with no API. Grok Build is xAI's official coding CLI, announced 25 May 2026 and at 1.0 since around 7 August, running in your terminal, defaulting to grok-4.6, with documented headless flags, JSON output formats and an ACP agent over stdio. They are also on opposite ends of the price ladder: Grok Build needs only base SuperGrok at $30, while Grok Bot needs SuperGrok Plus or Heavy.

Is Grok Build still in beta?

No. It launched as an early beta on 25 May 2026 but reached 1.0 around 7 August, shipped 1.0.5 by 15 August, and switched its default model to Grok 4.6 on 13 August. Articles describing it as an early beta are repeating a fact that stopped being true in early August.

What subscription do I need for Grok Build?

xAI's announcement puts availability at SuperGrok and X Premium Plus subscribers, which means base SuperGrok at $30 a month is enough. You do not need SuperGrok Heavy. Several ranking pages price it at around $299 or claim there is no individual tier, and both are wrong. Alternatively, authenticate with an XAI_API_KEY and pay per token against your API account, which is what you will be doing in CI.

What is Grok arena mode?

A Grok Build command that races up to eight parallel subagents against the same task and takes the best result. It is genuinely useful for hard problems and nobody has published its cost multiplier, so treat a raced task as potentially several times the cost of a normal one, especially on API-key authentication where it lands on an invoice rather than against a subscription allowance.

What happened to Grok Tasks?

It was renamed and rebuilt as Grok Automations on 16 July 2026. Automations supports schedule triggers (once, daily, weekdays, weekly, monthly, yearly) and email triggers filtered on sender, recipient or subject. Basic scheduling is free; email triggers require SuperGrok at $30 a month. Pages still quoting "two daily tasks free" are describing the old product.

Is there a Grok CLI, and which one is official?

There are two. The official one is xAI's Grok Build, installed with the x.ai install script and defaulting to grok-4.6. The other is superagent-ai/grok-cli, a community project with roughly 3,400 stars that defaults to grok-4.3 and does not mention the official CLI anywhere in its README.

What is Grok agent mode?

The phrase covers two unrelated products. Imagine Agent Mode, from May 2026, is a creative canvas at grok.com/imagine for image and video work. Grok Build is the coding agent that runs in your terminal. If you want to ship software, you want Grok Build.

How do I automate a Grok Bot workflow?

You cannot do it programmatically today. Inside Grok Bot, the mechanism is routines: demonstrate a multi-step path once and the Bot saves it and re-runs it on a schedule or on demand. For anything you want to trigger from your own code or from CI, use Grok Build headless with --output-format json, or the xAI API directly.

What are Grok Workflows?

A Grok Build feature announced 23 July 2026, not a Grok Bot feature. You describe a task in plain language and it fans out across up to 128 parallel agents per run, and up to 1,024 for larger jobs, each with focused context. Progress checkpoints allow pause and resume, /workflows shows live per-agent token tracking, and saved workflows become custom slash commands.

Can Continuum run Grok Build?

Yes. Continuum runs Grok alongside Claude Code, Codex, Cursor, Gemini, and OpenCode on a Mac, Linux or Windows host you own, under your own authentication, with a git worktree per Code session, a plan gate before writes, live quota gauges and spend recorded by repository. The application is free on every platform.

Sources

Every figure above was read from these pages on August 2026. Vendors reprice without notice; if you find a stale number, tell us.

  1. Grok Bot overview (docs.x.ai) shared cloud computer, security-boundary warning, memory, routines, connectors and computer use
  2. Grok Bot get started (docs.x.ai) eligible plans, Cursor account requirement, platform support, Linux statement
  3. Grok Build CLI announcement (xAI) official CLI, 25 May 2026, install commands, default model
  4. Grok Build overview (docs.x.ai) interactive, headless and ACP surfaces, AGENTS.md, plugins, hooks, skills, MCP
  5. Grok Build headless scripting (docs.x.ai) verified headless flags and output formats
  6. Workflows (xAI) 23 July 2026, parallel agent fan-out, checkpoints, saved workflows
  7. Grok Automations (xAI) 16 July 2026, renamed from Tasks, schedule and email triggers
  8. Grok 4.6 (docs.x.ai) context window, knowledge cutoff, reasoning effort, surfaces it ships on
  9. xAI API pricing (docs.x.ai) per-million token rates and the 200K long-context tier
  10. superagent-ai/grok-cli on GitHub the community CLI that shares the name, star count, default models
  11. Grok Bot on Hacker News launch-day thread, 350 points, trust, prompt injection and self-hosting objections
  12. Grok Bot on the App Store iOS availability and minimum OS version
Try it

One CLI is a terminal.
Five is a workbench.

Continuum hosts Grok Build alongside Claude Code, Codex, Cursor, Gemini, and OpenCode on hardware you own, with worktree isolation, a plan gate, live quota gauges and iPhone control. Free on Mac, iPhone, web, Windows and Linux.

free app · your subscriptions · local-first