Repository Public
1<!-- source: https://docs.x.ai/grok-bot/get-started (from https://docs.x.ai/llms-full.txt, retrieved 2026-09-19T05:28:55Z) -->2#### Start34# Get started56Set up Grok Bot, create your first Bot, and hand it a useful task.78## Before you begin910You need:1112* An eligible plan: every paid individual Cursor plan or the Cursor Teams plan,13 or an individual SuperGrok, SuperGrok Plus, or SuperGrok Heavy subscription14 linked to your Cursor account (see15 [Plans and billing](https://cursor.com/help/grok-bot/plans))16* The Grok Bot desktop app for macOS, Windows, or Linux17* An app or website where your first Bot can do useful work1819You can also [set up and use Grok Bot on mobile](/grok-bot/mobile).2021> Grok Bot requires cloud data storage. Accounts using Legacy Privacy Mode22> must move to a supported Cursor data setting before Grok Bot can start. Open23> [Cursor privacy settings](https://cursor.com/dashboard/settings?openPrivacy=true)24> to review the account setting.2526## 1. Install the desktop app2728Open the [Grok Bot downloads page](https://x.ai/bot) and choose the download29for your computer.3031### macOS32331. Choose the Apple silicon or Intel download.342. Open the downloaded disk image.353. Drag **Grok Bot** to **Applications**.364. Open Grok Bot. If macOS asks for confirmation, choose **Open**.3738To check which download you need, open **Apple menu → About This Mac**. A39**Chip** field means Apple silicon; a **Processor** field means Intel.4041### Windows42431. Choose the x64 or Arm64 download.442. Run the installer.453. Open Grok Bot from the Start menu.4647To check the architecture, open **Settings → System → About → System type**.4849### Linux5051Linux builds publish with every stable release. Get them under52**More downloads** on [x.ai/bot](https://x.ai/bot).53541. Choose the x64 or Arm64 download in the format your distribution uses: a55 `.deb` package for Debian and Ubuntu, an `.rpm` package for Fedora and56 RHEL, or an AppImage for other distributions.572. Install the `.deb` or `.rpm` with your package manager, or make the58 AppImage executable and run it.593. Open Grok Bot from your application launcher.6061To check the architecture, run `uname -m` in a terminal: `x86_64` means x6462and `aarch64` means Arm64.6364Grok Bot checks for updates automatically. You can also use **Check for65Updates** from **Settings → Updates**.6667## 2. Sign in68691. Choose **Sign in** on the welcome screen. If you are already in the app,70 use **Sign In with Cursor** from Settings.712. Finish authentication in the browser window that opens.723. Return to Grok Bot after the browser confirms the sign-in.734. If your access comes from a SuperGrok subscription, link it when the app74 asks. On iPhone and Android, the access screen offers **Link Grok Account**75 and then **Finished Linking? Refresh My Status**; on desktop,76 **Settings → Usage & Billing** offers **Link SuperGrok Heavy** (the label77 names the SuperGrok tier that applies to your account).7879Grok Bot uses your Cursor account. If your organization requires single sign-on80(SSO), complete the normal organization sign-in flow.8182On first use, Grok Bot introduces Bots, the shared computer, and routines, then83asks which tools you use. These answers shape the first teammate suggestions;84they do not connect or modify those tools by themselves. Computer setup runs in85the background and the final step opens **Meet a future teammate**.8687## 3. Create your first Bot8889Choose a suggested teammate from **Meet a future teammate**, or choose **Create90your own** and give the Bot:9192* A short name93* One primary job94* A description of how it should work9596For example:9798> **Name:** Piper\99> **Job:** Product performance\100> **Description:** Investigate product-performance questions using our101> observability tools. Preserve links and screenshots, separate evidence from102> hypotheses, and return a short summary with the highest-impact issue first.103> Never change production settings.104105Focused Bots build more useful context than one catch-all Bot. You can add more106Bots later with **New → Create new Bot** when work naturally splits into107distinct roles.108109## 4. Give it a first task110111A strong request includes:1121131. **Outcome:** What should be finished?1142. **Sources:** Which apps, websites, files, or conversations matter?1153. **Constraints:** What must the Bot avoid or ask before doing?1164. **Deliverable:** What should it return?1175. **Review point:** When should it stop for you?118119For a five-minute first result that needs no connector or website login, attach120a document and try:121122> Summarize this document in five bullets. List every date, decision, and open123> question in a separate section. Cite the page or section for each item. Do not124> change the source file.125126Then try a task in one of your tools:127128> Open our analytics dashboard and compare new-user activation for this week129> with the previous four weeks. Identify the largest step-level change and130> draft a short investigation plan with links to the relevant charts. Do not131> change any dashboards. Ask me to sign in if needed.132133Before allowing external changes, review134[Approvals, security, and privacy](/grok-bot/approvals-security-and-privacy).135136## 5. Sign in to the tools it needs137138When the Bot reaches an app that requires authentication, it may ask you to139take over the computer.1401411. Open **Agent Computer** from the conversation.1422. Choose the takeover control.1433. Enter the password, passkey, two-factor code, or complete the CAPTCHA144 yourself.1454. Return control to the Bot.146147The browser session persists on your shared Grok Bot computer, so other Bots148can use the same signed-in session when appropriate.149150For supported services, you can also install a plugin from **Marketplace** in151the sidebar and authenticate it in your browser.152153## 6. Review the result154155Ask the Bot to revise anything that is incomplete or formatted incorrectly.156Name the lasting preference explicitly:157158> Use this format for future weekly reports: five bullets, source links inline,159> and a final section called “Decisions needed.”160161When the process is stable, ask the Bot to save it as a skill or162[create a routine](/grok-bot/skills-routines-and-automations).163164## Next steps165166* [Create and manage more Bots](/grok-bot/bots)167* [Use apps and the cloud computer](/grok-bot/computer-and-apps)168* [Attach files and review results](/grok-bot/files-and-results)169* [Set approval and privacy controls](/grok-bot/approvals-security-and-privacy)170