SpyBara
Go Premium

Documentation 2026-10-07 23:59 UTC to 2026-10-08 23:58 UTC

12 files changed +157 −28. View all changes and history on the product overview
2026
Thu 29 23:01 Wed 28 23:01 Fri 23 23:57 Wed 21 23:02 Mon 19 23:59 Fri 16 22:57 Wed 14 23:01 Tue 13 23:59 Mon 12 23:02 Sun 11 23:58 Thu 8 23:58 Mon 5 22:59 Sat 3 23:58 Fri 2 23:57
Details

35save a matching rule, and **Deny** blocks it. The controls are the same on35save a matching rule, and **Deny** blocks it. The controls are the same on

36iPhone.36iPhone.

37 37 

38An Auto Review approval from a chat you are in waits for your answer. An

39approval from work that started without you, such as a routine, a trigger, or a

40message from another Bot, expires after about 10 minutes; the card then shows

41**Expired**, and the action does not run. An expired card may offer **Always allow this in

42the future**, which adds the proposed rule to your **Allow automatically** rules

43without running the expired action. To finish the task, ask the Bot to try

44again.

45 

38Do not approve an action whose target or effect you cannot identify. Ask the Bot46Do not approve an action whose target or effect you cannot identify. Ask the Bot

39to explain it in plain language or produce a draft first.47to explain it in plain language or produce a draft first.

40 48 

bots.md +6 −0

Details

100Shared Bots are created by other users, not by SpaceXAI. Adding one accepts the100Shared Bots are created by other users, not by SpaceXAI. Adding one accepts the

101[third-party bot terms](https://x.ai/legal/bot-sharing-terms).101[third-party bot terms](https://x.ai/legal/bot-sharing-terms).

102 102 

103## Add a Bot from Marketplace

104 

105**Marketplace** in the sidebar also lists Bots that you can add. Choose **Add**

106on a Bot, or open it and choose **Import Bot**, to create your own copy from

107its template.

108 

103## Delete a Bot109## Delete a Bot

104 110 

105Deleting a Bot removes its active profile, conversation, and routines from Grok111Deleting a Bot removes its active profile, conversation, and routines from Grok

Details

76 76 

77* Write normally to let the participating Bots decide who should respond.77* Write normally to let the participating Bots decide who should respond.

78* Type `@` and select a Bot when one teammate owns the request.78* Type `@` and select a Bot when one teammate owns the request.

79* Choose **Reply** on a Bot's message to direct your answer to that Bot.

79* Mention multiple Bots when the request genuinely needs each of them.80* Mention multiple Bots when the request genuinely needs each of them.

80* Use `@everyone` sparingly for a group-wide update.81* Use `@everyone` sparingly for a group-wide update.

81 82 


86> findings into a launch draft. @Reviewer check the draft against the sources87> findings into a launch draft. @Reviewer check the draft against the sources

87> and list only blocking issues. Do not publish anything.88> and list only blocking issues. Do not publish anything.

88 89 

89Your messages in a group can include attachments. Bot-to-group handoff messages90Your messages in a group can include attachments. A Bot's replies there can

90are currently text-only, so a Bot should send an image directly to another Bot91include files, questions, and forms, as in a one-to-one conversation, and your

91when that teammate must inspect it.92answer to a question or form goes back to the Bot that asked. Approval

93requests, secret and login requests, and email or Slack drafts do not appear in

94a group. Bot-to-group handoff messages are currently text-only, so a Bot should

95send an image directly to another Bot when that teammate must inspect it.

92 96 

93## Let Bots hand work off97## Let Bots hand work off

94 98 

Details

77Installed connectors are account-wide. Their availability is not isolated to77Installed connectors are account-wide. Their availability is not isolated to

78one Bot.78one Bot.

79 79 

80## Search and read X

81 

82Bots can search and read what's public on X without you connecting an X

83account. Ask a Bot to search posts, open a post from its link, read an

84account's posts and mentions, see who quoted or reposted a post, count recent

85posts on a topic, or check trends and news.

86 

87This access is read-only and doesn't sign in as you. For your DMs, bookmarks,

88home timeline, or who liked your posts, add the X plugin from **Marketplace**

89and sign in with X.

90 

80## Work with files91## Work with files

81 92 

82The computer has a shared workspace at `/workspace`. Ask Bots to keep durable93The computer has a shared workspace at `/workspace`. Ask Bots to keep durable

mobile.md +1 −2

Details

39list.39list.

40 40 

41Enable notifications if you want to know when a Bot has a result, question, or41Enable notifications if you want to know when a Bot has a result, question, or

42approval request. Push delivery is still rolling out; in-app attention states42approval request.

43remain available when push is not enabled for the account.

44 43 

45## Message a Bot44## Message a Bot

46 45 

overview.md +9 −0

Details

61finished work looks like. Review the result, correct it, and turn the stable61finished work looks like. Review the result, correct it, and turn the stable

62process into a [skill or routine](/grok-bot/skills-routines-and-automations).62process into a [skill or routine](/grok-bot/skills-routines-and-automations).

63 63 

64## Tag @bot on X

65 

66You can also start work from X. Tag [@bot](https://x.com/bot) in a post or

67reply, and your main Bot picks up the post as a task while @bot confirms with a

68short public reply. Tagging requires an X account connected to your Grok

69account and is not available in every region yet.

70[Tag @bot on X](/grok-bot/tag-on-x) covers setup, regional availability, and

71why @bot might not reply.

72 

64## FAQ73## FAQ

65 74 

66### Does Grok Bot keep working when my laptop is closed?75### Does Grok Bot keep working when my laptop is closed?

Details

39 39 

40### Route through a member's desktop40### Route through a member's desktop

41 41 

42In the Grok Bot desktop app, open **Settings → Computer** and turn on **Route42In the Grok Bot desktop app, open **Settings → Computer → Network** and turn on

43egress through this desktop**. The route uses the current device's network and43**Route traffic through this computer**. The route uses the current device's

44IP address. It stops when the setting is turned off or an Enterprise admin44network and IP address. It stops when the setting is turned off or an Enterprise

45disables **Allow Local Egress**.45admin disables **Allow Local Egress**.

46 46 

47Each member controls their own desktop route. Enterprise admins can remove this47Each member controls their own desktop route. Enterprise admins can remove this

48option for the whole team from48option for the whole team from

Details

161 161 

162The iPhone and Android apps also ask for notification permission during first162The iPhone and Android apps also ask for notification permission during first

163run. Both device permission and the Bot's notification setting must allow the163run. Both device permission and the Bot's notification setting must allow the

164notification. Mobile push delivery is rolling out and may not yet be enabled164notification.

165for every account.

166 165 

167## Handle in-app errors166## Handle in-app errors

168 167 

Details

127* Delete it127* Delete it

128 128 

129A Bot can own up to 50 routines, and the app keeps the 20 most recent run129A Bot can own up to 50 routines, and the app keeps the 20 most recent run

130records for each routine. Deleting a routine is immediate and has no undo.130records for each routine. Routine schedules must be at least five minutes

131Deleting a Bot also removes routines owned by that Bot.131apart. Deleting a routine is immediate and has no undo. Deleting a Bot also

132removes routines owned by that Bot.

132 133 

133To control unattended usage, Grok Bot may ask whether to keep routines running134To control unattended usage, Grok Bot may ask whether to keep routines running

134after a long period away and pause them if there is no response. Review paused135after a long period away and pause them if there is no response. Review paused

tag-on-x.md +69 −0 created

Details

1#### Work with Grok Bot

2 

3# Tag @bot on X

4 

5Tag [@bot](https://x.com/bot) in a post or reply on X to hand that post to your

6Grok Bot as a task. For example, reply to a thread with:

7 

8> @bot summarize this thread and send the key points to my Slack

9 

10@bot answers on X with a short reply confirming that your Grok Bot has the

11request, and your main Bot starts working on its cloud computer. The work and

12its results stay in that Bot's conversation in the Grok Bot app; @bot posts only

13the confirmation on X.

14 

15Your Bot receives your post, the post you replied to, and any post either of

16them quotes, including still photos. The first time a request goes through, X

17sends you a notification that tagged requests start work automatically and use

18your Grok Bot usage.

19 

20## Before you start

21 

22You need:

23 

24* A Grok account with your X account connected. On grok.com, open

25 **Settings → Account** and choose **Connect** next to **𝕏 Account**.

26* Grok Bot access on that same Grok account. Download the app from

27 [x.ai/bot](https://x.ai/bot); if your access comes from a SuperGrok

28 subscription, link it as described in

29 [Get started](/grok-bot/get-started#2-sign-in).

30* At least one Bot of your own. Bots that someone shares with you can't take

31 tagged requests.

32* An X account based in a region where tagging is available.

33 

34The X for Grok Bot plugin is optional. It lets your Bot search posts, read

35timelines, check mentions, and use trends and bookmarks, and @bot forwards

36requests with or without it. For X's own explanation of @bot, see

37[About @bot](https://help.x.com/en/using-x/about-bot) in the X Help Center.

38 

39## Where tagging is available

40 

41Tagging @bot works for X accounts based in most countries. It is not yet

42available for accounts based in Australia, the United Kingdom, the European

43Union, Iceland, Liechtenstein, or Norway.

44 

45@bot goes by the country X has on record for your account, so your current

46location and any VPN have no effect. If X lists only a broader region for your

47account, such as "South Asia," or no country at all, tagging is not available

48yet either. In all of these cases @bot does not reply.

49 

50## What @bot's reply means

51 

52| @bot replies | What it means | What to do |

53| --- | --- | --- |

54| A short line saying it sent your request to your Grok Bot | Your main Bot has the task. | Open Grok Bot to follow the work and review the result. |

55| "Sign up for Grok Bot: https://x.ai/bot" | No Grok account is connected to the X account you posted from. | Connect your X account on grok.com, set up Grok Bot, and tag @bot again. |

56| "Grok Bot isn't set up yet. Open https://x.ai/bot" | Your accounts are connected, but you don't have a Bot of your own yet. | Open Grok Bot, create a Bot, and tag @bot again. |

57 

58## When @bot stays quiet

59 

60If @bot doesn't reply, your Bot didn't get the request. Common causes:

61 

62* Your X account is in a region where

63 [tagging isn't available yet](#where-tagging-is-available).

64* You replied in a thread that already includes @bot, but didn't tag @bot

65 yourself.

66* The post also tags @grok.

67* The post, the post it replies to, or a quoted post has a video or GIF.

68* The post doesn't pass internal moderation.

69* Grok Bot isn't linked to your Grok account, or your weekly usage is used up.

team-bots.md +29 −14

Details

37| | Personal Bot | Public template | Team Bot |37| | Personal Bot | Public template | Team Bot |

38| --- | --- | --- | --- |38| --- | --- | --- | --- |

39| Who talks to it | Only you | Each person who adds it talks to their own copy | Everyone on your team, each in their own chat |39| Who talks to it | Only you | Each person who adds it talks to their own copy | Everyone on your team, each in their own chat |

40| Who maintains it | You | Each copy's new owner, separately | The owner, and changes reach everyone |40| Who maintains it | You | Each copy's new owner, separately | The owner and any managers, and changes reach everyone |

41| Memory | Yours | Starts from what the template shares, then separate per copy | Team memory, plus private notes with each person |41| Memory | Yours | Starts from what the template shares, then separate per copy | Team memory, plus private notes with each person |

42 42 

43## How to access43## How to access


95The Bot's info pane shows a **Setup** section with cards for **Plugins**,95The Bot's info pane shows a **Setup** section with cards for **Plugins**,

96**Secrets**, **Skills**, and **Files**. Each card shows what you added, or96**Secrets**, **Skills**, and **Files**. Each card shows what you added, or

97**None**. Choose a card to add to it or manage what it holds, or ask the Bot in97**None**. Choose a card to add to it or manage what it holds, or ask the Bot in

98chat. Only the owner can change this setup, and every change reaches all98chat. Only the owner and the Bot's [managers](#add-managers) can change this

99teammates.99setup, and every change reaches all teammates.

100 100 

101### Plugins101### Plugins

102 102 


152* A Team Bot holds up to 25 secrets. Each value is at least 8 characters, so152* A Team Bot holds up to 25 secrets. Each value is at least 8 characters, so

153 it can be redacted reliably, and at most 4,096 bytes.153 it can be redacted reliably, and at most 4,096 bytes.

154 154 

155When the Bot needs a key it doesn't have, it asks the owner with a secret155When the Bot needs a key it doesn't have, it sends a secret request in the

156request in the owner's chat. A teammate who needs one hears that the owner156owner's or a manager's own chat in the Grok Bot app. Any other teammate who

157adds it.157needs one hears that the owner or a manager adds it.

158 158 

159### Skills and files159### Skills and files

160 160 


168in. Supported formats are .txt, .md, .markdown, .csv, .json, .yaml, and .yml,168in. Supported formats are .txt, .md, .markdown, .csv, .json, .yaml, and .yml,

169up to 256,000 characters per file.169up to 256,000 characters per file.

170 170 

171Only the owner saves a team skill. When a teammate teaches the Bot a new171Only the owner or a manager saves a team skill. When another teammate teaches

172process in their own chat, the Bot keeps it in its notes with that person and172the Bot a new process in their own chat, the Bot keeps it in its notes with that

173tells them the owner can make it a team how-to.173person and tells them the owner or a manager can make it a team how-to.

174 174 

175### Memory175### Memory

176 176 


206when they find the Bot, so write it in the Bot's own voice: “I answer206when they find the Bot, so write it in the Bot's own voice: “I answer

207questions about our Datadog alerts.”207questions about our Datadog alerts.”

208 208 

209### Add managers

210 

211Once the Bot is published, you can make teammates its managers. In the Bot's

212details, the **Managers** section sits under **Setup**. Choose **Add**, pick a

213teammate, then choose **Add manager**. A manager can change the Bot's setup,

214like its profile, skills, plugins, secrets, and Slack app, and every change

215reaches the whole team. Publishing, unpublishing, and deleting the Bot stay

216with you.

217 

218To remove a manager, choose the trash icon (**Remove manager**) next to their

219name, then **Remove**.

220 

209## Use a Team Bot221## Use a Team Bot

210 222 

2111. Choose **New chat**, then **Team Bots** at the bottom of it.2231. Choose **New chat**, then **Team Bots** at the bottom of it.


221teammates said to it.233teammates said to it.

222 234 

223As a teammate, you can pin a Team Bot, hide it from your sidebar, and set up235As a teammate, you can pin a Team Bot, hide it from your sidebar, and set up

224your own routines with it. You can't change its setup or delete it. Ask the236your own routines with it. You can't delete it, and you can't change its setup

225owner for changes to shared plugins, secrets, skills, or files.237unless the owner makes you a [manager](#add-managers). Ask the owner or a

238manager for changes to shared plugins, secrets, skills, or files.

226 239 

227### Routines on a Team Bot240### Routines on a Team Bot

228 241 


281with the same plugins, context, and memories it has in the Grok Bot app. It294with the same plugins, context, and memories it has in the Grok Bot app. It

282posts as itself, not as the owner.295posts as itself, not as the owner.

283 296 

284Only the owner adds a Team Bot to Slack, and the Bot must be published first.297The owner adds a Team Bot to Slack, and the Bot must be published first. A

298[manager](#add-managers) can add it too. The setup then uses the owner's Slack

299connection, so the owner connects Slack first.

285 300 

2861. In the Bot's details, choose **Bring to your team's Slack**.3011. In the Bot's details, choose **Bring to your team's Slack**.

2872. Choose **Connect Slack workspace** and approve Cursor in the Slack page3022. Choose **Connect Slack workspace** and approve Cursor in the Slack page


369Members who get a Team Bot this way see **Required by your admin. You can't384Members who get a Team Bot this way see **Required by your admin. You can't

370turn this off.**385turn this off.**

371 386 

372Admins choose who gets a Team Bot by default. Only the Bot's owner changes its387Admins choose who gets a Team Bot by default. Only the Bot's owner and its

373plugins, secrets, skills, and files.388managers change its plugins, secrets, skills, and files.

374 389 

375### Delete a Team Bot as an admin390### Delete a Team Bot as an admin

376 391 

Details

101. Keep Grok Bot open while authentication runs in your browser.101. Keep Grok Bot open while authentication runs in your browser.

112. Confirm the browser shows a successful Cursor sign-in.112. Confirm the browser shows a successful Cursor sign-in.

123. Return to the app manually if it does not regain focus.123. Return to the app manually if it does not regain focus.

134. Try **Get started** or **Sign In with Cursor** again.134. Choose **Sign in** on the welcome screen again. If you are already in the

14 app, use **Sign In with Cursor** from Settings.

145. Confirm that your account has Grok Bot access.155. Confirm that your account has Grok Bot access.

15 16 

16If your organization uses SSO, complete the organization login rather than17If your organization uses SSO, complete the organization login rather than


148Keep local access disabled unless the task specifically requires files or149Keep local access disabled unless the task specifically requires files or

149commands on the computer in front of you.150commands on the computer in front of you.

150 151 

152## @bot did not reply on X

153 

154Tagging @bot isn't available in every region yet, and @bot also stays quiet

155when a post has a video, tags @grok as well, or doesn't pass internal

156moderation. [Tag @bot on X](/grok-bot/tag-on-x#when-bot-stays-quiet) lists the

157common causes and what each @bot reply means.

158 

151## Update Grok Bot159## Update Grok Bot

152 160 

153The Grok Bot app and the Agent Computer have separate updates.161The Grok Bot app and the Agent Computer have separate updates.