This guide takes you from install to your first finished task. You’ll set up the desktop app, create a Bot with a clear job, and review its work.

Grok Bot access is included with every paid individual Cursor plan and with
the Cursor Teams plan, or through an individual SuperGrok link. See Plans and
billing. Grok Bot needs cloud data storage, so
accounts on Privacy Mode (Legacy) are prompted to switch to Privacy Mode
before starting.

Install the desktop app

Get the installer from the Grok Bot page of the Cursor
dashboard: the Download Grok Bot setup
row installs the desktop app or copies a link you can share. If you don’t
have dashboard access, ask your admin for the download link. The app runs
on macOS (Apple silicon and Intel) and Windows (x64 and Arm64) and checks
for updates automatically; there is no Linux desktop app. On iPhone,
install Grok Bot from the App Store; see
Use Grok Bot on iOS.

Sign in with your Cursor account

Choose Get started on the welcome screen and finish authentication in
your browser. Grok Bot uses your Cursor account, and there is no separate
Grok Bot login. If your organization uses single sign-on, sign in through
your normal company flow; your existing Cursor SSO configuration applies.
For sign-in problems, see Sign in to Grok Bot.

Create your first Bot

Pick a suggested teammate, or choose Create your own and give the Bot
a short name, one primary job, and a description of how it should work. A
focused Bot builds more useful context than one catch-all helper. For
example:

Name: Piper
Job: Product performance
Description: Investigate product-performance questions with our
observability tools. Preserve links and screenshots, separate evidence
from hypotheses, and lead with the highest-impact issue. Never change
production settings.

Give it a first task

A strong request states the outcome, the sources that matter, the
constraints, the deliverable, and where the Bot should stop for you. For
a five-minute first result, attach a document and try:

Summarize this document in five bullets. List every date, decision, and
open question in a separate section, and cite the section for each item.
Don’t change the source file.

Sign in to the tools it needs

When the Bot reaches an app that requires authentication, it hands you
the computer. Open Agent Computer, take over, enter the password or
two-factor code yourself, and return control. The Bot doesn’t see your
password, and the signed-in session persists on your computer for future
tasks. For supported services, you can also connect a
plugin instead.

Review the result and make it stick

Ask for revisions, and name lasting preferences explicitly, like a report
format you want reused. When the process is stable, save it as a
skill or routine.

Before you let a Bot change external systems, read Approvals and Auto Review. It covers approval prompts, the review model behind them, and how to keep credentials out of chat.

Use Grok Bot on iOS

The iPhone app (iOS 18 or later) connects to the same Bots, conversations, routines, and cloud computer as desktop. Install Grok Bot from the App Store and sign in with the same Cursor account; access from your plan or SuperGrok link carries over without a second purchase. From your phone you can message Bots, watch and take over the computer, approve actions, and pause or resume routines.

Some flows stay on desktop: teaching a workflow by demonstration, editing a routine’s schedule or instructions, viewing run history, testing or deleting routines, and updating the computer. See Grok Bot on mobile for setup details and Subscribe from the mobile app if your account doesn’t include access.

If something doesn’t work

Most setup problems clear after you fully quit and reopen the app. For symptom-by-symptom help with computers, routines, plugins, and startup, see Getting started with Grok Bot in the help center, or contact support.