diff --git a/packages/vscode-ide-companion/README.md b/packages/vscode-ide-companion/README.md
index ebc751e6..6e6db38d 100644
--- a/packages/vscode-ide-companion/README.md
+++ b/packages/vscode-ide-companion/README.md
@@ -1,6 +1,6 @@
 # Gemini CLI Companion
 
-The Gemini CLI Companion extension seamlessly integrates [Gemini CLI](https://github.com/google-gemini/gemini-cli) into your IDE.
+The Gemini CLI Companion extension pairs with [Gemini CLI](https://github.com/google-gemini/gemini-cli). This extension is compatible with both VS Code and VS Code forks.
 
 # Features
 
diff --git a/packages/vscode-ide-companion/development.md b/packages/vscode-ide-companion/development.md
new file mode 100644
index 00000000..0fdc93f2
--- /dev/null
+++ b/packages/vscode-ide-companion/development.md
@@ -0,0 +1,30 @@
+# Local Development
+
+## Running the Extension
+
+To run the extension locally for development:
+
+1.  From the root of the repository, install dependencies:
+    ```bash
+    npm install
+    ```
+2.  Open this directory (`packages/vscode-ide-companion`) in VS Code.
+3.  Compile the extension:
+    ```bash
+    npm run compile
+    ```
+4.  Press `F5` (fn+f5 on mac) to open a new Extension Development Host window with the extension running.
+
+To watch for changes and have the extension rebuild automatically, run:
+
+```bash
+npm run watch
+```
+
+## Running Tests
+
+To run the automated tests, run:
+
+```bash
+npm run test
+```
diff --git a/packages/vscode-ide-companion/package.json b/packages/vscode-ide-companion/package.json
index 4cbf9bb1..187da3e8 100644
--- a/packages/vscode-ide-companion/package.json
+++ b/packages/vscode-ide-companion/package.json
@@ -1,7 +1,7 @@
 {
   "name": "gemini-cli-vscode-ide-companion",
   "displayName": "Gemini CLI Companion",
-  "description": "Enable Gemini CLI with direct access to your VS Code workspace.",
+  "description": "Enable Gemini CLI with direct access to your IDE workspace.",
   "version": "0.1.19",
   "publisher": "google",
   "icon": "assets/icon.png",