Skip to content

Commit ee53c1e

Browse files
committed
docs: expand Troubleshooting section with global scope and Windows path info
1 parent b462984 commit ee53c1e

1 file changed

Lines changed: 6 additions & 1 deletion

File tree

README.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,12 @@ AetherForge should kick in automatically.
4949
If the extension is not found or fails to activate in certain directories, check the following:
5050

5151
- **Safe Mode:** Gemini CLI may restrict extension execution in untrusted folders. If you trust the current workspace, run `gemini trust` to enable all extension features.
52-
- **Workspace Overrides:** Check your `extension-enablement.json` file. Local workspace configurations can sometimes override global settings, causing specific extensions to be disabled. Ensure AetherForge is permitted in your project's configuration.
52+
- **Global Scope:** Ensure the extension is enabled at the user level to be available across all projects:
53+
```bash
54+
gemini extensions enable aetherforge --scope user
55+
```
56+
- **Workspace Overrides:** Check your `extension-enablement.json` file. Local workspace configurations can sometimes override global settings. Ensure AetherForge is permitted in your project's configuration.
57+
- **Drive-Specific Issues (Windows):** If working across multiple drives, ensure your `USERPROFILE` environment variable is correctly set (typically `C:\Users\YourName`), as this is where the CLI looks for the global `.gemini` config and extensions.
5358

5459
---
5560

0 commit comments

Comments
 (0)