Manage and protect
Settings and notifications
Use Grok Bot settings for app-wide and desktop-local behavior, and conversation details for one Bot's profile and notifications.
Open Grok Bot settings
Open the account menu and choose Settings, or press Cmd/Ctrl+,. For
other desktop shortcuts, including Bot settings (Cmd/Ctrl+Shift+,) and
conversation details, see
Keyboard shortcuts.
The Grok Bot settings dialog has General, Computer, Usage & Billing, and Updates panes. Sections depend on your account and rollout, so some options described below may not appear.
General
Account
Sign in or out of the Cursor account used by Grok Bot. The account menu also has Get Grok Bot for mobile, which opens the App Store listing, and Support → About shows the installed Grok Bot version.
When more than one account is saved on the desktop, the account menu includes Switch account. Choose Add account to save another. Settings lists the same accounts; inactive rows include Remove.
Appearance
Choose Follow System, Light, or Dark.
Use Language to choose Follow System or one of more than 20 app languages, including English, Spanish, French, German, Japanese, Korean, Simplified Chinese, and Traditional Chinese. On iPhone and Android the follow-device option is labeled System, and the list is shorter. See Grok Bot for Mobile.
Bot
Configure shared and local Bot behavior:
- Timezone, which routines use for schedules
- Your Auto-review switch and Custom Rules
Cursor manages model selection, so there is no model picker.
Auto-review
Manage your personal Auto Review rules, plus any team rules your admin requires.
Auto Review rules shape which actions stop for your approval. When your
admin enforces Auto Review for the team, the same table also shows locked team
rules with Required by your admin. You can't edit or delete this rule. You
can add your own rules on top, but they only make behavior stricter; Ask
first wins when rules conflict. If your admin turns enforcement off, you only
see and use your own rules. Your personal rules are saved to your account, so
the same rules apply on every desktop and on iPhone. Read
Approvals, security, and privacy
before changing them.
Computer
Computer has two sections. Your computer holds settings for the desktops signed in to your account. Bot's computer holds the update and reset controls for the cloud computer your Bots share.
Run commands on your desktop
Execution on this computer controls whether Bots can run commands on a desktop. Each listed desktop under Your computer has its own setting. Until a desktop is listed, the page shows Execution on Local Computer instead. Per-command approval is the default, and the setting applies to that desktop alone. Read Approvals, security, and privacy before changing it.
Route traffic through your desktop
Under Your computer, turn on Route traffic through this computer to send your Grok Bot computer's web traffic through the current desktop. The route applies to new connections. Destinations see your desktop's IP address, and the Bot can reach networks available from that device.
The setting applies to one desktop. If your Enterprise admin turns off Allow
Local Egress Routing, the toggle turns off and locks. The setting reads
Your team admin has turned off local traffic routing. Grok Bot's computer routes traffic through the cloud.
and the switch shows Disabled by your admin. You can't turn this on. Any
active route stops within five minutes. Your choice is preserved and takes
effect again if the admin re-allows local egress.
For private network options and their tradeoffs, see Connect to private networks.
Update or reset Bot's computer
Under Bot's computer, Update Bot's Computer moves Grok Bot's computer to the latest version. A software update only refreshes Grok Bot's software and keeps installed apps. A computer update rebuilds the computer, keeping files and logins but removing installed apps and packages. The text under Update Bot's Computer says which kind is waiting.
Reset Bot's Computer is a last resort. It rebuilds the computer from your last saved data, the same as Recover computer; if the computer can't be reached to save first, very recent changes don't come back.
See Troubleshooting for the least destructive recovery order.
Plugins
Plugins are not a settings section. Open Connect apps from the sidebar to discover plugins and packaged skills. To manage installed plugins and private skills, select the connected count next to the Connect apps title.
An installed plugin may still need browser authentication. Individual plugin tools can be enabled or disabled. On the Teams plan and the Enterprise plan, team-provided plugins may be required or restricted by an admin.
See Connect plugins for the connection flow.
Usage and billing
Usage & Billing shows weekly included usage and on-demand usage for eligible accounts, and the account menu can show Weekly usage at a glance. If neither surface appears, review usage from the Cursor account page or contact your organization's admin.
For how plans, weekly usage, and on-demand spend work, see Plans and billing.
Team Setup Scripts
Team Setup Scripts is Enterprise only. Admins manage these scripts on the Grok Bot page of the Cursor dashboard, and they run on every member's computer. Members don't see them in settings. See Team Setup Scripts.
Updates
Settings → Updates handles updates to the desktop app. Grok Bot Updates shows the installed version; use Check for Updates and Restart to Update to install a new one. To update or reset Grok Bot's computer, see Update or reset Bot's computer.
Edit one Bot
Click the Bot's name at the top of the chat (View conversation details) to open its details. Click the name or the label to edit it, and click the Bot's picture to change its avatar. These belong to that Bot alone. Personal Bots don't have a description; to change what a Bot does, tell it in chat.
Execution on this computer is set per desktop, and your personal Auto-review rules are saved to your account.
Understand attention states
The sidebar distinguishes:
- Needs attention for a question, approval, or handoff
- Unread activity for a new result
- Working or typing status
Opening a conversation marks its current activity as read. Use the Bot menu to mark a conversation read or unread manually.
Control notifications
Turn on Notifications for a Bot to receive an operating-system or mobile notification when that Bot finishes or needs input. On the phone, the switch is in the Bot's profile. On desktop, ask the Bot to turn its notifications on or off. Group chats do not have the same per-Bot notification switch.
While you use the desktop app on macOS or Windows, notifications from Bots you own go to the desktop instead of your phone. The app counts as in use while it is open and signed in, the screen is unlocked, you have used the computer in the last 5 minutes, and your system settings let Grok Bot show banners or alerts. A focused window stays quiet only for the Bot on screen; other Bots still show a desktop notification. Finished replies skip your phone. When a Bot needs your input, your phone is notified about 3 minutes later unless you open that Bot, turn off its Notifications, or hide it from your sidebar first.
At other times, and always on Linux, notifications are suppressed while Grok Bot is focused, and your phone is notified as usual. The sidebar and dock badge still show unread activity.
The iPhone and Android apps also ask for notification permission during first run. Both device permission and the Bot's notification setting must allow the notification. On iPhone, push delivery is rolling out gradually.
Handle in-app errors
Errors appear above the composer under Notifications. You can dismiss one notice or clear the list. Some notices include Copy request ID for support; copy and share the complete ID with support.
Clearing a notice removes the notification, not the underlying external action or Bot history.