1#### Start1#### Get started
2 2
3# Get Started3# Get started
4 4
5This guide takes you from install to your first finished task. You'll set up the5Grok Bot gives you Bots that do work for you on a cloud computer they share. In
6desktop app, create a Bot with a clear job, and review its work.6this guide, you'll install the app, sign in, hand your first Bot a real task,
7and set it to repeat that task on a schedule.
7 8
8## Before you begin9## 1. Install the desktop app
9 10
10You need an eligible plan: Premium, Super, or Ultra on The X Subscription, for11Download Grok Bot from [x.ai/bot](https://x.ai/bot) and open it.
11an individual or a team seat. On a legacy Cursor plan, every paid individual
12plan and Cursor Teams include Grok Bot. You can also link an individual
13SuperGrok, SuperGrok Plus, SuperGrok Heavy, or X Premium+ subscription, or sign
14in with a seat on a self-serve Grok Business plan. See
15[Grok Bot on The X Subscription](/x-subscription/grok-bot) and
16[Plans and billing](https://cursor.com/help/grok-bot/plans).
17 12
18Grok Bot needs cloud data storage, so accounts on Privacy Mode (Legacy) are13**Other downloads and supported systems**
19prompted to switch to Privacy Mode before starting.
20 14
21## 1. Install the desktop app15On a team, the Grok Bot page of the
16[Cursor dashboard](https://cursor.com/dashboard/bot) has a **Download Grok Bot**
17row that installs the app or copies a link you can share. If you don't have
18dashboard access, ask your admin for the link. If you're the admin, see
19[Deploy Grok Bot to your organization](/grok-bot/deployment).
22 20
23Get the installer from the Grok Bot page of the21The app runs on macOS (Apple silicon and Intel), Windows (x64 and Arm64), and
24[Cursor dashboard](https://cursor.com/dashboard/bot): the **Download Grok Bot**22Linux (x64 and Arm64). It checks for updates automatically. Linux `.deb` and
25setup row installs the desktop app or copies a link you can share. If you don't23`.rpm` installs update through your package manager instead.
26have dashboard access, ask your admin for the download link. You can also
27download the app from [x.ai/bot](https://x.ai/bot). The app runs on macOS
28(Apple silicon and Intel), Windows (x64 and Arm64), and Linux (x64 and Arm64)
29and checks for updates automatically. On a phone, install Grok Bot from the App
30Store or Google Play; see
31[Use Grok Bot on your phone](#use-grok-bot-on-your-phone).
32 24
33## 2. Sign in25## 2. Sign in
34 26
35Choose **Sign in** on the welcome screen and finish authentication in your27Choose **Sign in** on the welcome screen and finish in your browser.
36browser. Grok Bot uses your Cursor account, and there is no separate Grok Bot28
37login. If your organization uses single sign-on, sign in through your normal29**Which plans include Grok Bot**
38company flow; your existing Cursor SSO configuration applies.30
31Premium, Super, and Ultra on The X Subscription include Grok Bot, for an
32individual or a team seat. On a legacy Cursor plan, every paid individual plan
33and self-serve Cursor Teams include it. You can also link an individual SuperGrok,
34SuperGrok Plus, SuperGrok Heavy, or X Premium+ subscription, or use a seat on a
35self-serve Grok Business plan. See
36[Grok Bot on The X Subscription](/x-subscription/grok-bot) and
37[Plans and billing](https://cursor.com/help/grok-bot/plans).
38
39Grok Bot needs cloud data storage, so if your account is on Privacy Mode
40(Legacy), the app asks you to switch to Privacy Mode first. On a team, a team
41admin changes the team's privacy setting.
42
43**Single sign-on and Grok accounts**
44
45Grok Bot uses your Cursor account, so there's no separate login. If your company
46uses single sign-on, sign in the usual way; your Cursor SSO setup applies.
39 47
40If your access comes from a seat on a self-serve Grok Business plan, choose48If your access comes from a seat on a self-serve Grok Business plan, choose
41**Sign in with Grok** in the browser and use the Grok account that holds the49**Sign in with Grok** in the browser and use the Grok account that holds the
42seat. If your access comes from a SuperGrok or X Premium+ subscription, link it50seat.
43when the app asks. On iPhone and Android, the access screen offers **Link Grok51
44Account** and then **Finished Linking? Refresh My Status**; on desktop,52If your access comes from a SuperGrok or X Premium+ subscription, add a Grok
45**Settings → Usage & Billing** offers **Get Access with Grok**. For sign-in53account link. On desktop, choose **Link Grok Account** on the **Get Started with
46problems, see [Sign-in does not complete](/grok-bot/troubleshooting#sign-in-does-not-complete).54Grok Bot** page at [cursor.com/bot/onboarding](https://cursor.com/bot/onboarding).
55On iPhone and Android, choose **Link Grok Account** on the access screen, finish
56signing in to Grok, then choose **Finished Linking? Refresh My Status**.
57
58If you already have access, open **Settings → Usage & Billing** and look under
59**Manage Plan** for **Get Access with Grok**. It appears only when linking would
60raise your usage.
61
62If sign-in doesn't finish, see
63[Sign-in does not complete](/grok-bot/troubleshooting#sign-in-does-not-complete).
47 64
48## 3. Meet your first Bot65## 3. Meet your first Bot
49 66
50After you sign in, click through a short intro. Grok Bot then sets up your first67After a short intro, the app sets up your first Bot, named **Grok Bot**, and
51Bot, named **Grok Bot**, and opens a chat with it.68opens a chat with it.
69
70You can also start from a Bot that's already set up for a job.
71
72* [Overheard](https://x.ai/bot/marketplace/bots/overheard) — Watches Reddit, Hacker News, news sites, and X for third-party mentions of your name, brand, and URLs, then sends a short weekday digest when something clears the bar. Stays quiet on dead days and never posts on your behalf.
73
74* [Tradbot](https://x.ai/bot/marketplace/bots/tradbot-2) — Watches your personal email and calendar so school forms, bills, and RSVPs don't slip. Drafts the reply, catches the pickup clash, and never sends without you.
75
76* [Meeting Recap Deck](https://x.ai/bot/marketplace/bots/echo) — Turns your meeting notes into a recap deck in your slide template. Works from notes you paste or upload, and never invents a quote.
77
78* [Pitch Deck Coach](https://x.ai/bot/marketplace/bots/pitch-deck-coach) — Reviews a pitch deck and reports what an investor is likely to understand, believe, question, and remember, then helps strengthen the story, evidence, and slides.
79
80[Browse the marketplace](https://x.ai/bot/marketplace)
81
82**Set up more Bots**
52 83
53To add more Bots, choose the **+** button in the sidebar, then **Create a Bot**,84Choose **New Bot** (the **+** button) at the top of the sidebar, or press
54name the Bot, and choose **Create**. On a Cursor team, share a Bot to let85`Cmd/Ctrl+N`. Name the Bot and choose **Create**. On a Cursor team, **+** opens
55teammates chat with it, and choose **Browse shared Bots** under **+** to find86a menu. Choose **Create a Bot** to make one, or **Browse shared Bots** to use a
56Bots shared with you; see [Shared Bots](/grok-bot/shared-bots).87Bot a teammate shared. To share your own Bot with teammates, see
88[Shared Bots](/grok-bot/shared-bots).
57 89
58Give each Bot one primary job in its first message and ask it to remember how90To rename a Bot later, click its name at the top of the chat to open its
59it should work. To rename it, click its name at the top of the chat to open its91details, then click the name again to edit it.
60details. A focused Bot builds more useful context than one catch-all helper.
61For example:
62 92
63> Your job is product performance. Investigate product-performance questions93Give each Bot one job in its first message and ask it to remember how you want
64> with our observability tools. Preserve links and screenshots, separate94the work done. A Bot with one job builds more useful context than a catch-all
65> evidence from hypotheses, and lead with the highest-impact issue. Never95helper. See
66> change production settings. Remember this for future work.96[Your primary Bot and Bots with one job](/grok-bot/how-grok-bot-works#your-primary-bot-and-bots-with-one-job).
67 97
68## 4. Give it a first task98## 4. Hand it a first task
69 99
70Type in the composer, or dictate with **Start voice input** (`Cmd/Ctrl+D` on100Ask the way you'd ask a coworker. Say what you want back, which sources to use,
71desktop; **Start dictation** on iPhone and Android). You can also choose101any limits, and when to check with you. When an action needs your OK, the Bot
72**Start voice chat** for a live conversation.102shows an [approval card](/grok-bot/approvals-security-and-privacy#review-an-action)
103and waits.
73 104
74A strong request states the outcome, the sources that matter, the constraints,105### Morning briefing
75the deliverable, and where the Bot should stop for you. For a five-minute first
76result, attach a document and try:
77 106
78> Summarize this document in five bullets. List every date, decision, and open107Your morning brief of what needs you, ready to post.
79> question in a separate section, and cite the section for each item. Don't
80> change the source file.
81 108
82## 5. Sign in to the tools it needs109**Starter prompt**
83 110
84When the Bot reaches an app that requires authentication, it uses a login saved111> Sum up what changed since yesterday in my inbox, calendar, Slack, and docs, and flag what needs me. Draft it as a post for #team; don't send it.
85in [Vault](/grok-bot/vault) or a connected password manager, or asks you for it112
86with a [Secure Form](/grok-bot/vault#secure-forms). The Bot never sees the113### Inbox manager
87password, and the signed-in session persists on your computer for future tasks.114
88For single sign-on, a passkey, or another step a form can't handle, it hands you115Urgent threads first, with replies drafted for your OK.
89the computer: click **Open computer**, finish that step, and return control. For116
90supported services, you can also117**Starter prompt**
118
119> Sort my unread email into urgent, needs a reply, and FYI. Draft replies to the urgent ones and don't send anything.
120
121### Competitive intelligence
122
123What competitors launched or repriced this week, with links.
124
125**Starter prompt**
126
127> Check these three competitors for anything they launched or repriced this week. Send me a short list with links and what it means for our messaging.
128
129### Travel coordinator
130
131The two best flights and hotels, ready for you to pick.
132
133**Starter prompt**
134
135> Find flights to Austin for Thursday, back Sunday, with no red-eyes, and a hotel near downtown. Send me the two best options; don't book anything.
136
137**Talk instead of typing**
138
139To dictate, choose **Start voice input** (`Cmd/Ctrl+D`) on desktop or
140**Start dictation** on iPhone and Android. For a live conversation, choose
141**Start voice chat**.
142
143**When a task needs a login**
144
145To sign in, the Bot uses a login saved in [Vault](/grok-bot/vault) first, then a
146connected password manager such as
147[1Password](/grok-bot/computer-and-apps#connect-1password), then asks you with a
148[Secure Form](/grok-bot/vault#secure-forms). It never sees the password, and the
149session usually stays signed in on the Bot's computer for next time. For
150supported services, you can
91[connect an app](/grok-bot/computer-and-apps#connect-an-app) instead.151[connect an app](/grok-bot/computer-and-apps#connect-an-app) instead.
92 152
93## 6. Review the result and make it stick153For single sign-on, a passkey, or another step a form can't handle, the Bot
154hands you the computer. Choose **Open computer** on the request, then **Take
155control**, finish the step, and tell the Bot to continue.
94 156
95Ask for revisions, and name lasting preferences explicitly, like a report157## 5. Make it a routine
96format you want reused. When the process is stable, save it as a
97[skill or routine](/grok-bot/skills-routines-and-automations).
98 158
99Before you let a Bot change external systems, read159Tell the Bot what to fix and which preferences to keep, like a report format.
100[Approvals and Auto Review](/grok-bot/security#approvals-and-auto-review). It160When the result is right, ask it to do the task on a schedule, and it becomes a
101covers approval prompts, the review model behind them, and how to keep161[routine](/grok-bot/skills-routines-and-automations#create-a-routine).
102credentials out of chat.
103 162
104## Use Grok Bot on your phone163## What's next
105 164
106The iPhone app (iOS 18 or later) and the Android app (Android 9 or later)165Your Bot now runs that task on a schedule. Next, connect more of the apps you
107connect to the same Bots, conversations, routines, and cloud computer as166use, turn the tasks you keep repeating into Bots of their own, then put a few
108desktop. Install Grok Bot from the App Store or Google Play and sign in with the167Bots on a team with a bigger goal.
109same Cursor account; access from your plan or SuperGrok link carries over
110without a second purchase. From your phone you can message Bots, watch and take
111over the computer, approve actions, and pause or resume routines.
112 168
113Some flows stay on desktop: teaching a workflow by demonstration, testing1691. [An assistant](/grok-bot/use-cases#connect-your-apps-and-get-help-with-your-work) — Finds information and drafts work in your apps
114routines, and updating the computer. See [Grok Bot on mobile](/grok-bot/mobile)
115for setup details and for subscribing from the mobile app if your account
116doesn't include access.
117 170
118## If something doesn't work1712. [A Bot with a job](/grok-bot/use-cases#turn-tasks-you-repeat-into-a-bot) — Takes over a task you keep repeating
119 172
120Most setup problems clear after you fully quit and reopen the app. For1733. [A team of Bots](/grok-bot/use-cases#build-a-team-of-bots-for-a-bigger-goal) — Works together toward a bigger goal
121symptom-by-symptom help with computers, routines, connected apps, and startup,174
122see [Troubleshooting](/grok-bot/troubleshooting), or175On your phone, install Grok Bot from the App Store or Google Play and sign in
123[contact support](/grok-bot/troubleshooting#before-contacting-support).176with the same account. See [Grok Bot on mobile](/grok-bot/mobile).
177
178**What works on your phone**
124 179
125## Related pages180The iPhone app needs iOS 18 or later, and the Android app needs Android 9 or
181later.
126 182
127* [Work with Grok Bot](/grok-bot/bots)183Both apps reach the same Bots, conversations, routines, and cloud computer as
128* [Grok Bot use cases](/grok-bot/use-cases)184desktop. Access from your plan or Grok account link carries over without a
129* [Deploy Grok Bot to your organization](/grok-bot/deployment)185second purchase. From your phone you can message Bots, watch and take over the
130* [Plans and billing](https://cursor.com/help/grok-bot/plans)186computer, approve actions, and pause or resume routines.
187
188If something doesn't work, quit and reopen the app. If that doesn't fix it, see
189[Troubleshooting](/grok-bot/troubleshooting) or
190[contact support](/grok-bot/troubleshooting#before-contacting-support).