shared-bots.md +0 −317 deleted
File Deleted View Diff
1#### Use Grok Bot
2
3# Shared Bots
4
5A Bot is either personal or shared. Share a Bot with your Cursor team the way
6you'd share a doc: with everyone on the team, or only with certain people and
7groups. Sharing doesn't make a copy, and each person's chat with a shared Bot is
8private.
9
10Shared Bots always run in the cloud. A Bot that runs on your own computer can't
11be shared.
12
13## Who can use shared Bots?
14
15Shared Bots are for members of a Cursor team who have Grok Bot. Choose **+** in
16the sidebar to see **Create a Bot** and **Browse shared Bots**. If **Browse
17shared Bots** isn't there, you aren't on a Cursor team, or your Grok Bot app
18needs an update.
19
20## How do I create a Bot for my team?
21
221. Choose **+** in the sidebar, then **Create a Bot**, and give it a name.
232. Tell the Bot what it should help the team with. A sentence is enough.
243. Follow its setup steps for apps, secrets, skills, and files. Only add keys
25 and files you're happy for everyone you share it with to use.
264. Share it. See [How do I share a Bot with my
27 team?](#how-do-i-share-a-bot-with-my-team)
28
29You can also share a Bot you already have. Sharing doesn't duplicate it. Before
30you share, check its apps, secrets, skills, and files, since they work in every
31teammate's chat.
32
33## How do I share a Bot with my team?
34
35Choose **Share** at the top right of the Bot's chat. In **Share this Bot**:
36
37* Under **Who has access**, choose your team to share the Bot with everyone on
38 the team. If your team is part of an organization, choose the organization
39 to share it with everyone in it. Choose **People you invite** to share it only with the people
40 and groups you add. Limiting it asks you to confirm with **Limit access**.
41 The owner and Managers can always use the Bot.
42* Search under **Add people or groups** to add someone. People you add can chat
43 with the Bot as a **Collaborator**. In the list of people who have access,
44 open a person's role and choose **Manager** to let them also change how the
45 Bot works and share it with others.
46
47To stop sharing, the owner can choose **Only you** under **Who has access**.
48This removes everyone else after you confirm with **Remove**. To remove one
49person or group, open their role in the list and choose **Remove**.
50
51## How do teammates find a shared Bot?
52
53* Choose **+** in the sidebar, then **Browse shared Bots**. The list shows Bots
54 shared with you, and each one shows who made it. Choose **Add** to keep a Bot
55 in your sidebar.
56* In the desktop app, press `Cmd/Ctrl+K` and choose **Browse shared Bots** at
57 the bottom of the list. You can also type a shared Bot's name and choose it
58 to add it.
59* Ask one of your Bots in your own chat, for example "Is there a shared Bot
60 for on-call triage?" It searches the shared Bots you can use by what they do,
61 and tells you which ones you've already added.
62* On your phone, tap **+**, then **Browse shared Bots**.
63* Open a link a teammate sent you, then choose **Start a chat**.
64
65A shared Bot's link opens the same Bot for everyone. It's different from
66[sharing a Bot template](/grok-bot/bots#share-a-bot), which gives each person
67their own copy.
68
69## Can the owner see my chats with a shared Bot?
70
71No. Each person's chat with a shared Bot is private. The owner and Managers
72can't read your chats, and you can't read the owner's or anyone else's.
73
74The Bot can save things it learns for the whole team, and it tells you when it
75does. It doesn't save anything about you personally for the team. What it
76remembers about working with you stays between you and the Bot.
77
78## Whose apps and secrets does a shared Bot use?
79
80A shared Bot uses the apps and secrets its owner added. Those work the same for
81everyone who chats with it.
82
83In your own chat with a shared Bot, it can also use your apps. It asks before it
84uses one of your personal accounts. The card says **Allow**, then the app name:
85
86* **Allow once** lets it use that account this time.
87* **Always allow** remembers your answer. Its menu has **Always allow for your
88 messages to this Bot** and **Always allow for your messages to every Shared
89 Bot**.
90* **Skip** means it doesn't use that account this time.
91
92In Slack channels, threads, and group chats, a shared Bot uses only its owner's
93apps, and asks before it uses your accounts.
94
95To make every shared Bot ask again, open **Settings** > **General** > **Shared
96Bots** and choose **Clear** next to **Clear connector preferences**.
97
98## Which computer does a shared Bot use?
99
100In your own chat with a teammate's shared Bot, the Bot usually works on your
101Grok Bot computer. That means it can use the files there and the sites you're
102signed in to there. Sometimes it uses a separate computer just for that
103conversation, for example when your privacy mode is stricter than the owner's.
104
105When you DM a shared Bot in Slack, it also works on your own computer. In Slack
106channels, threads, group DMs, and group chats, a shared Bot uses one shared
107computer of its own.
108
109## Whose usage pays for a shared Bot chat?
110
111A shared Bot reply uses the Grok Bot usage of the person it's answering. That's
112true in your own chat, in Slack, and in group chats. Your own limits apply. The
113owner's usage pays for the owner's own messages, and for Slack posts from apps
114or workflows that aren't linked to a Cursor account. See [How much does Grok Bot
115cost?](/grok-bot/faq#how-much-does-grok-bot-cost)
116
117## How do approvals work on a shared Bot?
118
119A shared Bot asks the person it's answering before risky actions.
120
121* In your own chat with a shared Bot, you answer its approval cards.
122* In a Slack thread, the Bot posts a **Review an action** card with **Allow
123 once**, **Deny**, and **View details**. Only the person who asked can answer
124 it.
125* In a group chat, only the person whose message the Bot is answering can
126 answer.
127
128It also asks before it uses your personal accounts. See [Whose apps and secrets
129does a shared Bot use?](#whose-apps-and-secrets-does-a-shared-bot-use) For the
130rest of the approval model, see [Approvals, security, and
131privacy](/grok-bot/approvals-security-and-privacy).
132
133## How do I add a shared Bot to Slack?
134
135The owner or a Manager adds it, after sharing:
136
1371. Open the Bot's details, or choose **Manage** and look under **Channels**.
1382. Find **Bring to your team's Slack** or **Slack**, and choose **Connect**.
1393. If it says **Awaiting admin approval**, a Slack workspace admin needs to
140 approve the app.
141
142Once it says **Connected**, teammates can message the Bot directly or mention it
143in channels.
144
145In a channel thread or a DM, the shared Bot acts for the teammate who mentioned
146it. It can hand work to that person's own Bots, and their replies are posted
147back into the same thread. A personal Bot doesn't hand work to other Bots from a
148channel thread. See [Let Bots hand work
149off](/grok-bot/chat-and-collaboration#let-bots-hand-work-off).
150
151Bots record who asked for each message they post in Slack, so anyone in the
152thread can ask the Bot who requested it. When a shared Bot's routine replies in a
153Slack thread, the Bot follows that thread and answers later replies without an
154@mention.
155
156Each teammate needs to link their Slack account first. Open **Settings** >
157**General** > **Shared Bots** and choose **Link**. If you message the Bot before
158you link, it replies with steps to link your account.
159
160## How do I add a shared Bot to Microsoft Teams?
161
162A team admin first enables Microsoft Teams for the team on the Grok Bot page of
163the dashboard. See [Microsoft
164Teams](/grok-bot/teams-and-enterprises#microsoft-teams). Then the owner or a
165Manager adds the Bot, after sharing:
166
1671. Open the Bot's details and find **Bring to your team’s Microsoft Teams**, or
168 choose **Manage** and look under **Channels**. Choose **Connect**.
1692. Finish signing in with Microsoft in the browser window that opens, then
170 choose the teams the Bot should join.
1713. While it says **Waiting on admin approval**, a Microsoft Teams admin needs to
172 approve the Bot in the Teams admin center, under **Teams apps** > **Manage
173 apps** > **Pending approval**. Microsoft doesn't notify them, so send them
174 the link the dialog shows. Setup finishes by itself once they approve.
175 Choose **Check again** to check right after they approve, or
176 **Cancel request** to stop.
177
178If the dialog says **Microsoft Teams didn't accept the app**, your organization
179may not allow custom apps in Microsoft Teams. A Teams admin can allow them, and
180the dialog offers **Download app package** for the admin.
181
182If **Channels** shows **Not connected · Blocked by your organization's Teams app
183policy**, a Microsoft Teams admin needs to allow the app in the Teams admin
184center.
185
186Once it's connected, teammates can chat with the Bot or mention it in a channel
187of a team it joined, and it replies in the same conversation.
188
189If you change the Bot's name or avatar, choose **Update in Teams**. Updates also
190wait for a Teams admin, and show **An update is waiting for your Teams admin**
191until they approve. If the admin declines the Bot, choose **Resubmit**.
192
193Each teammate links their Microsoft Teams account under **Settings** >
194**General** > **Shared Bots**: choose **Link** next to **Microsoft Teams
195account**.
196
197## How do I edit or delete a shared Bot?
198
199The owner and the Bot's Managers can change a shared Bot. Its details show in
200the panel on the right of the chat:
201
202* **Plugins** (the Bot's connected apps), **Secrets**, **Skills**, and
203 **Files** hold what the Bot uses for everyone.
204* Click the name to rename the Bot. Edit the description under **About**.
205* **Share** controls who can use the Bot and who manages it.
206
207Choose the wrench, **Manage**, for the rest:
208
209* **General** has the Bot's settings, such as whether Collaborators can set up
210 routines, its channels such as Slack and Microsoft Teams, and the **Bot's
211 accounts** it signs in to apps with.
212* **Knowledge** shows what the Bot learned for everyone, and its skills. New
213 learnings wait under **To review** until you choose **Approve** or
214 **Reject**.
215* **Analytics**, when shown, has the Bot's messages, hours saved, and top users.
216
217The owner can also rename the Bot by right-clicking it in the sidebar and
218choosing **Rename Bot**.
219
220Only the owner can delete a shared Bot. Right-click the Bot in the sidebar and
221choose **Delete**. This deletes the Bot for your whole team. Teammates lose it,
222along with their chats and routines on it. It can't be undone.
223
224## How do I remove a shared Bot from my sidebar?
225
226Right-click the Bot and choose **Remove from sidebar**. To add it back, choose
227**+** in the sidebar, then **Browse shared Bots**, and choose **Add** next to
228it.
229
230If your admin added the Bot to your sidebar for you, **Remove from sidebar**
231isn't in its menu, and you can't remove it.
232
233## Can I use shared Bots on my phone?
234
235Yes. Shared Bots you've added appear in the [phone app](/grok-bot/mobile). To
236find another, tap **+**, then **Browse shared Bots**. Each Bot in the list
237shows how many people use it, and **Add** keeps it in your list. You can chat
238with shared Bots and answer their **Allow** cards. A shared Bot can't be your
239[primary Bot](/grok-bot/bots#your-primary-bot).
240
241To remove a teammate's Bot from your list, touch and hold it and choose
242**Remove from sidebar**.
243
244The owner and Managers can also manage a shared Bot from its profile on the
245phone:
246
247* **Share** opens **Share this Bot**, where you choose who has access and add
248 people. If you're on more than one team, choose a team before you share.
249* **Tools** has the Bot's service accounts, and **Slack** adds the Bot to Slack
250 with your own Slack connection. See [How do I add a shared Bot to
251 Slack?](#how-do-i-add-a-shared-bot-to-slack)
252* **Skills** lists the Bot's skills. Tap **+** to choose **Add Custom Skill**
253 or **Import Existing Skill**, and open a skill to edit it and choose **Save
254 changes**.
255* **Learnings** shows how many learnings are waiting, for example "3 to
256 review". Choose **Approve** or **Reject** on each one.
257* **Routines** lists the Bot's routines, with **Add routine** and the
258 **Collaborators can create routines** switch.
259* **Analytics**, when shown, has weekly and daily active users, messages, hours
260 saved, and top users, over **7 days**, **30 days**, or **90 days**.
261
262When you ask one of your own Bots on the phone to work with your team, it shows
263a **Team access** card. **Share** moves that Bot to the team with its chat and
264memories, or **Copy** makes a team copy and keeps the original private. **Start
265fresh** creates a new shared Bot without this chat or its memories.
266
267## Can I voice chat with a teammate's shared Bot?
268
269Yes, on desktop. In your own chat with the Bot, choose **Start voice chat**. See
270[Start a voice chat](/grok-bot/chat-and-collaboration#start-a-voice-chat).
271
272## Can a shared Bot join a group chat?
273
274Yes. You can add a Bot a teammate shared with you to your own group chat. It
275can't share a group with Bots that run on your own computer. See [Start a group
276chat](/grok-bot/chat-and-collaboration#start-a-group-chat).
277
278## How do admins manage shared Bots?
279
280On the Grok Bot page of the [Cursor dashboard](https://cursor.com/dashboard/bot),
281open **Manage Bots** under **Shared Bots**.
282
283* **Access** shows who can use each shared Bot. Click it to change who can use
284 the Bot.
285* **Auto-add** puts the Bot in members' sidebars automatically. Pick **All
286 team** or one or more groups. Those members can't hide it. Auto-add only
287 applies to groups that have access.
288
289See [Grok Bot for teams and
290enterprises](/grok-bot/teams-and-enterprises#manage-bots).
291
292## Why can't I see or use a shared Bot?
293
294| What you see | What it means |
295| --- | --- |
296| **Browse shared Bots** isn't under **+** | You aren't on a Cursor team, or your Grok Bot app needs an update. |
297| **Shared Bots Not Available** | Your account doesn't have access to shared Bots. |
298| **Bot Not Found** | The Bot may have been removed, or it isn't shared with you. |
299| **No Access to This Bot** | The Bot is shared only with certain people. Ask its owner or a Manager for access. |
300| A teammate's Bot isn't in **Browse shared Bots** | The owner hasn't shared it with you yet. |
301| **Your usage limit has been reached** | Your Grok Bot usage ran out. Your chats with a teammate's shared Bot use your usage. See [How much does Grok Bot cost?](/grok-bot/faq#how-much-does-grok-bot-cost) |
302| **This Bot's owner has reached their usage limit** | This reply was billed to the owner's account, and the owner's usage ran out. Ask the owner to check their plan. |
303| **This conversation can't run on your computer because your privacy mode is stricter than the bot owner's.** | Your privacy mode setting is stricter than the owner's, so this chat can't use your computer. |
304| In Slack, the Bot asks you to link a Cursor account | Link your Slack account under **Settings** > **General** > **Shared Bots**, using the Cursor account on the Bot's team. |
305
306If none of these match, [contact support](/grok-bot/troubleshooting) with the
307Bot's name, the exact message, and your Grok Bot version.
308
309## Related pages
310
311* [Create and manage Bots](/grok-bot/bots)
312* [Message and collaborate](/grok-bot/chat-and-collaboration)
313* [Use the computer and apps](/grok-bot/computer-and-apps)
314* [Vault and secure sign-in](/grok-bot/vault)
315* [Approvals, security, and privacy](/grok-bot/approvals-security-and-privacy)
316* [Grok Bot for teams and enterprises](/grok-bot/teams-and-enterprises)
317* [Troubleshooting](/grok-bot/troubleshooting)