fix(uninit): scope import removal to exact lines, gate layout patch on ownership

- removeImport now matches the exact import string instead of any line
  containing 'agent-react-devtools', preventing accidental removal of
  unrelated comments or imports
- unpatchViteConfig filters the exact import line inserted by init
- unpatchNextJs only removes the layout's import './devtools' when
  devtools.ts was confirmed to be ours, preventing corruption of
  pre-existing imports with the same name
- Add changeset and README entry for uninit command

Author: piotrski

.changeset/uninit-command.md

@@ -0,0 +1,11 @@
+---
+"agent-react-devtools": minor
+---
+
+Add `uninit` command to reverse framework configuration
+
+`agent-react-devtools uninit` removes the changes made by `init` — restoring your config files to their original state.
+
+- Supports all frameworks: Vite, Next.js (Pages Router and App Router), CRA
+- `--dry-run` flag previews what would be removed without writing any files
+- Safe to run on projects not configured by `init` (no-op)

README.md

@@ -178,6 +178,12 @@ npx agent-react-devtools init
 
 This detects your framework (Vite, Next.js, CRA) and patches the appropriate config file.
 
+To undo these changes:
+
+```sh
+npx agent-react-devtools uninit
+```
+
 ### One-line import
 
 Add a single import as the first line of your entry point (e.g. `src/main.tsx`):

packages/agent-react-devtools/src/init.ts

@@ -40,14 +40,14 @@ function prependImport(filePath: string, importLine: string, dryRun: boolean): s
   return filePath;
 }
 
-function removeImport(filePath: string, dryRun: boolean): string | null {
+function removeImport(filePath: string, importLine: string, dryRun: boolean): string | null {
   const content = readFileSync(filePath, 'utf-8');
-  if (!content.includes('agent-react-devtools')) {
+  if (!content.includes(importLine)) {
     return null; // not configured
   }
   const newContent = content
     .split('\n')
-    .filter((line) => !line.includes('agent-react-devtools'))
+    .filter((line) => line !== importLine)
     .join('\n');
   if (!dryRun) {
     writeFileSync(filePath, newContent, 'utf-8');
@@ -207,7 +207,7 @@ function unpatchViteConfig(cwd: string, dryRun: boolean): string[] {
 
   let newContent = content
     .split('\n')
-    .filter((line) => !line.includes('agent-react-devtools'))
+    .filter((line) => line !== "import { reactDevtools } from 'agent-react-devtools/vite';")
     .join('\n');
 
   // Remove reactDevtools() call from plugins array (with optional trailing comma)
@@ -235,27 +235,32 @@ function unpatchNextJs(cwd: string, dryRun: boolean): string[] {
 
   if (layoutPath) {
     const devtoolsPath = join(dirname(layoutPath), 'devtools.ts');
+    let devtoolsIsOurs = false;
     if (existsSync(devtoolsPath)) {
       const content = readFileSync(devtoolsPath, 'utf-8');
       if (content.includes('agent-react-devtools')) {
+        devtoolsIsOurs = true;
         if (!dryRun) {
           unlinkSync(devtoolsPath);
         }
         modified.push(devtoolsPath);
       }
     }
 
-    // Remove the import of ./devtools from layout
-    const layoutContent = readFileSync(layoutPath, 'utf-8');
-    if (layoutContent.includes("'./devtools'") || layoutContent.includes('agent-react-devtools')) {
+    // Only remove the layout import if we confirmed devtools.ts was created by us,
+    // to avoid corrupting a pre-existing import './devtools' that we don't own.
+    if (devtoolsIsOurs) {
+      const layoutContent = readFileSync(layoutPath, 'utf-8');
       const newContent = layoutContent
         .split('\n')
-        .filter((line) => !line.includes("'./devtools'") && !line.includes('agent-react-devtools'))
+        .filter((line) => line !== "import './devtools';")
         .join('\n');
-      if (!dryRun) {
-        writeFileSync(layoutPath, newContent, 'utf-8');
+      if (newContent !== layoutContent) {
+        if (!dryRun) {
+          writeFileSync(layoutPath, newContent, 'utf-8');
+        }
+        modified.push(layoutPath);
       }
-      modified.push(layoutPath);
     }
   }
 
@@ -270,7 +275,7 @@ function unpatchNextJs(cwd: string, dryRun: boolean): string[] {
     'src/pages/_app.js',
   );
   if (pagesEntry) {
-    const result = removeImport(pagesEntry, dryRun);
+    const result = removeImport(pagesEntry, "import 'agent-react-devtools/connect';", dryRun);
     if (result) modified.push(result);
   }
 
@@ -286,7 +291,7 @@ function unpatchCRA(cwd: string, dryRun: boolean): string[] {
   );
   if (!entryPath) return [];
 
-  const result = removeImport(entryPath, dryRun);
+  const result = removeImport(entryPath, "import 'agent-react-devtools/connect';", dryRun);
   return result ? [result] : [];
 }