Grok Bot How Tos
Short answers for organizing bots, approval cards, request IDs, and the problems that usually clear without a reset. First-time setup is on Onboarding.
How do I organize bots by project or business?
Use Sidebar Sections to group bots by project, client, or business without mixing them together.
On iOS:
- Swipe a bot row in the sidebar.
- Tap Move to.
- Choose New Section and name the section for your project or business.
- Repeat for other bots you want in the same group.
Sections sync between iOS and desktop. Deleting a section moves its bots to Unassigned without deleting the bots themselves.
Sidebar Sections require Grok Bot v1.2.0 or later. Update from the App Store if you do not see Move to.
How do I hide a Bot from the sidebar?
Choose Hide from sidebar. The Bot stays active and keeps its history. Open Hidden Bots or Show Hidden Bots, then Unhide, to show it again.
If it is missing from both lists, use the checks in My chats or bots look missing.
How do I troubleshoot Grok Bot computer, routine, connector, and startup problems?
Most operational issues clear with a full restart. Fully quit Grok Bot (on Mac, choose Quit from the menu bar, not just closing the window), reopen, and try again before anything else.
If that doesn't help, match your symptom:
| Symptom | What to try | If it persists |
|---|---|---|
| Computer says Reconnecting, Couldn't Reach Grok Bot's Computer, Backup not ready, or Bot failed to respond | Wait and Retry, then fully quit and reopen. Update if offered. Recover if it stays unreachable or the update looks stuck. | See Grok Bot computer. Use Reset only last, and only if you can lose unsynced work. |
| Chats look gone, or bots vanished from the sidebar | Fully quit and reopen. Check another device on the same account. Open Hidden Bots. | See My chats or bots look missing. Do not Reset to look for them. |
| A secret value is missing in Shell, or secrets look wiped after Update | A saved value is not shown again. If the name is still listed under Secrets, it is still stored. | See Store secrets securely. |
| A routine isn't running | Confirm the routine is Active and its schedule is correct. See Routines. | If it's Active but hasn't run for 24+ hours with no error shown, report a bug with the agent name and routine details. |
| An error or crash during a run | Copy the request ID from the message, then try the task again. See How do I copy a request ID?. | If the same prompt fails on a fresh run, report a bug and include the error text and request ID. |
| A plugin won't authorize or shows disconnected | Re-add the plugin and finish the provider login in your browser. If it shows Waiting for authorization, use Reopen. See Connect plugins. | If re-authorizing completes but the plugin still shows disconnected, contact support with the plugin name and your account email. |
| The app hangs on launch | Fully quit and relaunch. On Mac, use Quit from the menu bar. | If it hangs on every launch, contact support with your platform and Grok Bot version. |
When you contact support or report a bug, include your Cursor account email, your platform and Grok Bot version, the agent name, the exact error text or a screenshot, and the steps you already tried. Copy the version from About.
How do I copy a request ID?
Right-click the message and choose Copy request ID. You can also hover the message, open More message actions, and choose Copy request ID.
For a routine, open Run history, right-click the run, and choose Copy request ID.
Paste the full ID into the report. If Copy request ID is not in the menu, that message or run does not have one you can copy. Include the error text and a screenshot instead.
How do I find my Grok Bot version?
Open the account menu and choose About. The dialog shows Version, and Copy version info copies the version, release track, and OS. That is the version to send with a support request.
Why is the Bot asking me to approve something?
An approval card means the Bot stopped and is waiting. The turn does not continue until you choose.
Auto-review checks an action before it runs and asks when it needs you. The card may say The Bot wants to run a command, The Bot wants to use a connected service, The Bot wants to run a task, or Auto-review Paused This Action.
- Allow once lets this action run this time.
- Always allow lets this kind of action proceed later and adds a rule under Auto-review Rules.
- Deny stops this action.
Open Settings, then Bot, and use the Auto-review switch. The description there is Grok Bot checks each action before it runs and asks you first when needed. Under Auto-review Rules, write one short rule per action. Ask first wins if two rules conflict. If the switch says Required by your admin, you cannot turn it off.
A secret card, a plugin sign-in, or a page that asks you to type a password is a different prompt. Use the secure card for secrets. See Store secrets securely.
How do I stay up to date?
The desktop app checks for updates automatically. Install a desktop update when the app offers one. Phone updates come from the App Store or Google Play.
Product changes are listed on the changelog.