Skip to main content

​
Overview

The grab remove command disconnects React Grab from your coding agent, removing agent-specific integrations while keeping React Grab itself installed.

​
Usage

grab remove [agent]

​
Arguments

ArgumentDescription
[agent]Optional agent name to disconnect: cursor, claude, copilot, windsurf, or mcp

​
Options

OptionAliasDescriptionDefault
--yes-ySkip confirmation promptsfalse
--cwd <cwd>-cWorking directoryCurrent directory

​
Examples

​
Interactive Mode

Run without arguments to select from installed agents: 
grab remove
1

Select agent to remove

Choose from your installed agents:
? Which agent would you like to disconnect?
❯ Cursor
  Claude Desktop
2

Review changes

Preview the file changes:
--- app/layout.tsx
+++ app/layout.tsx
@@ -10,7 +10,6 @@
       <Script
         src="//unpkg.com/react-grab/dist/index.global.js"
-        data-agent="cursor"
         crossOrigin="anonymous"
       />
     )}
3

Confirm removal

Confirm to remove the agent integration:
? Apply these changes? (Y/n)

​
Remove Specific Agent

Specify the agent directly: 
grab remove cursor

​
Non-Interactive Mode

Remove an agent without prompts: 
grab remove cursor --yes

​
What Gets Removed

When you remove an agent integration:
1

Agent packages uninstalled

Agent-specific packages are removed:
✔ Removing @react-grab/cursor.
2

Configuration cleaned

Agent attributes are removed from your code:
--- app/layout.tsx
+++ app/layout.tsx
-  data-agent="cursor"
3

Package.json updated

Dependencies are removed from package.json:
--- package.json
+++ package.json
@@ -5,7 +5,6 @@
   "dependencies": {
     "react": "^18.0.0",
-    "@react-grab/cursor": "^0.0.1",
     "react-grab": "^0.0.1"
   }
Note: React Grab itself remains installed. Only the agent integration is removed.

​
Output Example

$ grab remove cursor
✿ React Grab 0.0.1

✔ Preflight checks.
✔ Preparing to remove Cursor.

--- app/layout.tsx
+++ app/layout.tsx
@@ -10,7 +10,6 @@
       <Script
         src="//unpkg.com/react-grab/dist/index.global.js"
-        data-agent="cursor"
         crossOrigin="anonymous"
       />
     )}

--- package.json
+++ package.json
@@ -5,7 +5,6 @@
   "dependencies": {
     "react": "^18.0.0",
-    "@react-grab/cursor": "^0.0.1",
     "react-grab": "^0.0.1"
   }

? Apply these changes? (Y/n)

✔ Removing @react-grab/cursor.
✔ Applying changes to app/layout.tsx.
✔ Applying changes to package.json.

Success! Cursor has been removed.

​
Troubleshooting

​
React Grab Not Installed

✖ Preflight checks.

✗ React Grab is not installed.
Run react-grab init first to install React Grab.
Solution: There’s nothing to remove if React Grab isn’t installed.

​
No Agents Installed

✔ Preflight checks.

⚠ No agent connections are installed.
Solution: No action needed. You have no agents to remove.

​
Agent Not Installed

✗ Agent cursor is not installed.
Installed agents: Claude Desktop
Solution: Check installed agents and specify a valid one.

​
Missing Agent Argument

In non-interactive mode: 
✗ Please specify an agent to disconnect.
Installed agents: cursor, claude
Solution: Provide an agent name or remove --yes flag for interactive mode.

​
Remove vs Uninstall

The grab remove command only removes agent integrations: 
# Remove agent integration (keeps React Grab)
grab remove cursor

# To completely uninstall React Grab, manually:
# 1. Remove the script tag or import
# 2. Run: npm uninstall react-grab

Build docs developers (and LLMs) love

Get started for freeTalk to us