GROK AGENT SCHOOL
0 / 20 XP

Stop asking AI for answers. Start handing it the job.your inbox.the bug.the busywork.the mission.

You've used AI chat — you ask, it answers, you do the work. A newer kind of AI called agentic AI skips that last part: it does the work itself. This short course teaches you the difference using xAI's three tools: Grok chat, Grok Build, and Grok Bot.

No coding experience needed. About 20 minutes. Free forever.

Chat
Grok chat

The one you know. You type, it types back. Brilliant advice — but you do the doing.

Agent · your computer
Grok Build

An AI agent that lives in your terminal and works directly on your files and code.

Agent · the cloud
Grok Bot

Always-on AI teammates with their own computer in the cloud, working even while you sleep.

01Module one · 5 min

The AI you already know

Let's start on familiar ground. Grok chat — like any AI chatbot — is a conversation. And a conversation, no matter how smart, has one hard limit.

Think of chat AI as a brilliant expert locked in a room with a mail slot. You slide a note in. A great note slides back out. The expert has read half the internet, reasons well, writes fast, and never gets tired of your questions.

But the expert never leaves the room. It can't open your files, click anything, run anything, or check whether its advice actually worked. Its only tool is words. Everything it "does" happens inside the chat window — and the moment the answer needs to touch the real world, that job transfers to you.

Try it — a totally normal chat
I have 50 photos named IMG_2041.jpg, IMG_2042.jpg… Can you rename them all to Hawaii-Trip-1, Hawaii-Trip-2, and so on?
I can't touch your files from here, but here's exactly how to do it yourself:
  1. Select all 50 photos in your Finder
  2. Right-click → Rename…
  3. Choose "Format", type Hawaii-Trip-
  4. Set the counter to start at 1
  5. Click Rename
…so I still have to do it myself 😅
Correct! I'm the advice. You're the hands. 🤝
Perfect instructions. Zero renamed photos.

What chat is genuinely great at

  • Answers and explanations — "What's compound interest?" "Why is my sourdough flat?"
  • Drafts and rewrites — emails, essays, captions, code snippets you'll paste somewhere.
  • Thinking out loud — brainstorming, pros/cons, "explain this like I'm new."

None of this goes away in the agentic world. Chat stays the right tool for a huge share of what you'll do. The point of this course isn't "chat is obsolete" — it's that chat is one mode, and until recently it was the only mode you had.

Checkpoint · +1 XP
No matter how smart chat AI gets, what's the one thing it fundamentally cannot do?
02Module two · 6 min

What "agentic" actually means

An agent is AI with three things a chatbot doesn't have: a goal it owns, tools it can use, and a loop it runs until the goal is done.

Unlock the expert's door and hand them a toolbox — the ability to read and edit files, run programs, browse the web, use apps. Now instead of asking a question, you assign a task. The AI breaks it into steps, does a step, looks at what happened, and adjusts. Over and over, until it's finished or needs your input.

That "looks at what happened" part is the magic. Step through the loop below with a real example.

The agent loop — click through it
🎯Goal
🗺️Plan
🔧Act
👀Check
🔁Adjust
Press Step to walk through a real task: "rename my 50 vacation photos."

Why this is fundamentally more powerful

Not "somewhat better." A different category. Here's the honest breakdown:

  1. It acts instead of advising. Chat's finished product is instructions. An agent's finished product is the finished product. The 50 photos are renamed. The bug is fixed. The report exists.
  2. It checks its work against reality. A chatbot can't know if its advice worked. An agent runs the thing, reads the error message, and fixes its own mistake — errors become feedback instead of dead ends. This self-correction is the single biggest upgrade.
  3. It carries long chains of steps. A real task might be 40 small steps. With chat, you shepherd every one — you're the project manager. An agent holds the whole chain itself and comes back when it's done or stuck.
  4. It works with your real, current stuff. Chat only knows what you paste into the window. An agent reads the actual files, the actual inbox, the actual codebase — no copy-paste bottleneck.
  5. It scales past your attention. You can only type in one chat at a time. Agents can run while you're away, on schedules, and even in parallel. Your time stops being the ceiling.
The one-line version

Chat gives you knowledge. Agents combine knowledge × tools × iteration — and that multiplication, not just addition, is why the leap feels so big.

Same request, two worlds
You asked: "my website's contact form is broken — fix it"
  1. Open your browser's developer console
  2. Look for red error messages when you submit the form
  3. It's probably the form's "action" URL — check that…
  4. …or a JavaScript error — paste it here and I'll take a look
Genuinely helpful. Also: your form is still broken, and steps 1–4 are now your evening.
You asked: "my website's contact form is broken — fix it"
✓ Reproduced the bug — submit button dies silently
✓ Found it: a typo in contact.js (line 31) broke the submit handler
✓ Fixed the typo, re-tested the form — submission works
✓ Also noticed the "thanks" page 404s — flagged it, didn't touch it
The form works. Your evening is yours. Note the last line: a good agent reports what it found but doesn't wander beyond the job.
Fair trade warning

Power for trust — that's the deal. An AI that can edit files can edit the wrong file. This is why every serious agent tool asks permission before risky actions, shows you what it changed, and starts with limited access. You'll see these guardrails in both tools ahead — treat them as a feature, not friction.

Checkpoint · +1 XP
What separates an agent from a chatbot?
Checkpoint · +1 XP
An agent runs a command and gets an error message. What happens next?
03Module three · 6 min

Meet Grok Build — the agent on your computer

Grok Build is xAI's coding agent. It runs in your terminal, inside your project folder, with its hands on your actual files.

First: what's a terminal? (30 seconds)

The terminal is the text-only window where you control your computer by typing commands instead of clicking icons. It looks intimidating — black screen, blinking cursor — but it's just another way to talk to your machine, and it's where programmers live. Grok Build moved in there for a reason: the terminal is where you can do anything — create files, run programs, install software. An agent living there inherits all of that reach.

Here's the workflow: you open a terminal, go to a project folder, and type one word — grok. A full-screen session opens. Then you talk to it in plain English, and it works on the code around it. Watch:

terminal — ~/side-project
Press ▶ to watch Grok Build fix a real bug.
Scripted replay of a typical Grok Build session.

Read that back and you'll spot every part of Module 2's loop: it ran the tests (act), read the failure (check), found the cause in the code, asked permission before editing, then re-ran the tests to prove the fix. Chat could only have guessed at that bug. Build watched it fail and watched it pass.

The spec sheet, in plain English

Lives
On your machine
Works inside whatever project folder you start it in — your files never need to be uploaded to a chat window.
You start it with
grok
One command in your project folder opens the full-screen, mouse-friendly session (the "TUI").
Reads a lot
Whole repositories
A million-plus-token context window means it can take in an entire codebase, not one pasted file.
Delegates too
Sub-agents
For big jobs it spins up parallel helper agents that split the work and share notes.
Also runs
Headless
grok -p "explain this codebase" runs one task with no interactive screen — the building block for automation.
Open source
Since July 2026
Launched in beta May 2026 for subscribers; xAI later published the CLI's source on GitHub, including its skills, plugins, hooks, and MCP extension system.

So how is this different from asking Grok chat about code?

  • Chat sees what you paste. Build reads the actual project — all of it — and keeps its understanding as it works.
  • Chat suggests an edit. Build makes the edit, in the real file, and shows you the diff.
  • Chat can't run your tests. Build runs them before and after, so "fixed" means verified fixed, not "probably fixed."
  • Chat forgets your project tomorrow. Build works where your project lives, so every session starts in context.
Checkpoint · +1 XP
Where does Grok Build do its work?
Checkpoint · +1 XP
In the demo, why did Build re-run the tests after editing the file?
04Module four · 6 min

Meet Grok Bot — the crew in the cloud

Grok Bot flips the setup. Instead of an agent visiting your computer, xAI gives your agents their own computer — a dedicated machine in the cloud where they work around the clock, whether or not you're online.

Launched in August 2026, Grok Bot is less "a chatbot" and more "a small staff." You create named bots — think of them as teammates with job descriptions — and message them the way you'd message a coworker. Behind each friendly chat window is a real computer with a browser, a file system, and a terminal, shared by your whole crew.

A sample crew — click a bot to see its overnight log

Notice Pixel messaging Scout — bots hand work to each other, so one "chief of staff" bot can coordinate specialists and report back to you in a single thread.

The three ideas that make it click

  1. One shared cloud computer. All your bots work on the same dedicated machine, with the same browser, files, and connected accounts. Connect Gmail or Slack once and the whole crew can use it. When there's no official connector, a bot shows you the login screen so you sign in yourself — bots don't collect your passwords.
  2. Routines. A routine is a standing instruction: run on a schedule ("every weekday at 8am") or on an event ("when a new email arrives," "when someone pushes a commit"). This is the moment AI stops waiting for your message.
  3. Teach by showing. Record yourself doing a task once — stepping through your expense tool, say — and Grok Bot turns the recording into a repeatable skill the bot can run and refine on its own.
Routine builder — assemble one yourself
Your routine
Pick a trigger and a task above.
This is exactly the shape of a real Grok Bot routine.

How is this different from Grok chat?

  • Chat starts when you type and stops when you close the tab. A bot has a standing job. Close the app; it keeps working.
  • Chat is one anonymous window. Bots are named, persistent teammates that remember their role and your preferences.
  • Chat can describe an email you paste in. A bot is in your inbox (with your permission), triaging the real thing.
  • Chat answers. A bot delivers — drafts sent for approval, reports posted, trackers updated.
Checkpoint · +1 XP
What's a Routine in Grok Bot?
Checkpoint · +1 XP
Where do your Grok Bot teammates actually run?
05Module five · the deep dive

Build vs Bot: same brain, different body

Here's the graduate-level insight: Grok Build and Grok Bot run on the same Grok models and the same agent loop you learned in Module 2. What differs is where the agent lives, what it can reach, and how it relates to your time. Those three differences change everything about when you'd use each.

1 · Where it lives decides what it touches

Build lives on your machine. Its world is the project folder you start it in — your real files, your installed tools, your code. Nothing needs to leave your computer, which is exactly what you want when the work is your computer: a codebase, a folder of files, a local project.

Bot lives on xAI's cloud. Its world is a dedicated online computer plus the accounts you've connected — email, Slack, calendar, the web. That's exactly what you want when the work lives in your accounts and apps rather than on your disk.

2 · Session vs standing job

Build is a session. You sit down, open the terminal, work with it — often watching, steering, approving — and when you close it, it's done. It's a power tool: enormous leverage while your hands are near it.

Bot is a standing job. You hire it once, give it routines, and it runs whether you're present or asleep. It's less a power tool than an employee — the value shows up on a schedule, not per-session.

3 · Driver's seat vs delegation

With Build, you're in the loop by default: it proposes an edit, you approve; it shows a diff, you read it. With Bot, autonomy is the point — you review the outputs (a draft held for approval, a posted report) more than the steps. That's also why Bot's guardrails center on account access and approval queues, while Build's center on file edits and command permissions.

DimensionGrok BuildGrok Bot
Lives onYour computer, in your project folderA dedicated cloud computer at xAI
InterfaceThe terminal (full-screen TUI, or headless commands)A chat app — you message named bots like coworkers
Its world isFiles, code, tests, git — the local projectYour connected accounts, the web, its own files & terminal
Works whenYou start a sessionAlways — schedules, event triggers, and while you sleep
Memory shapeFresh session each time, in your project's contextPersistent teammates with names, roles, and ongoing memory
Your roleDriver — steer, review diffs, approve actionsManager — set routines, review deliverables
Scaling trickParallel sub-agents inside one taskMultiple bots that message and hand off to each other
Made forPeople building software (or brave beginners with a project folder)Anyone with recurring digital work — no code required
Cost of a mistakeA bad file edit — visible in the diff, undoable with gitA bad action in a real account — why approvals matter more here
Rule of thumb

Ask two questions. Where does the work live? On your disk → Build. In your accounts/apps → Bot. When should it happen? Now, with you watching → Build (or chat). Repeatedly, without you → Bot.

Prove it — the scenario game

Six real-life situations. Pick the right tool: Chat Build Bot

0 / 6 answered
You're settling a dinner-table debate: is a hot dog a sandwich? You want a funny, well-argued take in the next thirty seconds.
Chat. Pure words in, words out — no files, no accounts, no schedule. Agents would be overkill; this is chat's home turf.
Your side project's tests started failing after last night's changes, and you can't figure out why.
Build. The work lives in a project folder on your disk, and you want to be in the driver's seat: it runs the tests, reads the failure, proposes the fix, you approve.
Every Monday morning you spend an hour compiling last week's customer emails into a summary for your team.
Bot. Recurring + lives in your inbox + shouldn't need you at all. One routine ("every Monday 7am, summarize last week's customer email") and your hour comes back forever.
You keep hearing the term "context window" and want it explained simply, with an analogy.
Chat. A question with a spoken answer. Learning, explaining, and brainstorming stay chat jobs even after you go agentic.
You want every new commit your teammate pushes to be checked and summarized into your Slack channel — automatically, forever.
Bot. The trigger is an event (a new commit) and the destination is an account (Slack), with no human in the loop. That's a routine. (Build could check the code in a session — but it won't be awake at 3am when the commit lands.)
You need one variable renamed across 40 files in your repo — and proof that nothing broke afterward.
Build. Forty real files on your disk plus a test run to verify — exactly the "act, check, adjust" loop, exactly where Build lives. Chat would hand you 40 manual edits.

Scored all six? Then you've internalized the real lesson: it's never "which AI is best" — it's where does the work live, and when should it happen.

06Module six · graduation

Your first mission

You now understand agentic AI better than most people on the internet. Here's how to turn that into hands-on experience this week — safely.

The four golden rules for new agent users

  1. Start read-only. Your first tasks should look, not touch: "explain this codebase," "summarize my unread email." Zero risk, instant feel for how agents think.
  2. Review before you approve. When an agent asks "apply this change?", actually read it. You're training your own judgment, not just the AI.
  3. Small jobs first. One bug, one routine, one folder. Trust is earned in both directions.
  4. Treat it like a talented new hire. Clear instructions, low-stakes assignments, check the early work. Autonomy grows with track record — the agent's and yours.

Path A · Try Grok Build

For you if: you have (or want) a project folder — code, a website, even a messy documents directory.
  1. Install it — the install script and docs are at docs.x.ai (it's open source on GitHub).
  2. Open a terminal and go to a low-stakes project.
  3. Type grok, sign in, and start with: "Explain what this project does and how it's organized."
  4. Then one small real task: fix a typo, add a comment, write one test.
  5. Read every diff before approving. Graduate to bigger tasks as it earns trust.

Path B · Try Grok Bot

For you if: your repetitive work lives in email, Slack, calendars, and browser tabs.
  1. Get access via x.ai — it's included with xAI's top-tier plans, with standalone pricing reported around $200/month (check current details; it's new and moving fast).
  2. Create one bot with one clear job — inbox triage is the classic starter.
  3. Connect only the accounts that job needs.
  4. Set one routine: "Every weekday at 8am, brief me on what's new."
  5. Watch it for a week, keep approvals on for anything outgoing, then add a second routine — or a second bot.

Words you can now use at parties

Agent
AI given a goal, tools, and a loop: plan, act, check the result, adjust, repeat until done. The difference between advice and action.
Tool (in AI-speak)
Anything an agent can operate besides generating text: reading and editing files, running commands, browsing the web, calling apps. Tools are the agent's hands.
Terminal / CLI
The type-commands-instead-of-clicking way to control a computer. CLI means "command-line interface." Grok Build is a CLI tool: you launch it by typing grok.
TUI
"Terminal user interface" — a full-screen, interactive app that runs inside the terminal. Grok Build's TUI even supports the mouse, so it feels like an app, not a wall of text.
Headless
Running without an interactive screen — fire one instruction, get the result, done. grok -p "…" is headless Grok Build; it's how agents get wired into scripts and automations.
Context window
How much material the AI can consider at once — its working memory. Grok Build leans on a million-plus-token window to take in whole codebases.
Sub-agent
A helper agent spawned by a main agent to work on part of a job in parallel. Grok Build uses crews of them for big tasks.
Routine
Grok Bot's standing instruction: run a task on a schedule ("every weekday at 8am") or on an event ("when a new email arrives"). The feature that makes AI proactive instead of reactive.
MCP
Model Context Protocol — a standard plug for connecting agents to outside tools and services, so any agent can use any compatible tool. Both Grok tools support extension ecosystems built around it.
Final exam · 1 of 3 · +1 XP
Your friend says "agentic AI is just a smarter chatbot." Your correction?
Final exam · 2 of 3 · +1 XP
The cleanest one-line split between Grok Build and Grok Bot?
Final exam · 3 of 3 · +1 XP
Best very first task to give any agent?
Grok Agent School · Certificate of Completion

Certified Agent-Ready

has completed all six modules and can correctly explain the difference between an AI that answers and an AI that acts — and knows which one to hire for the job.
Progress: 0 / 20 XP