Troubleshooting

Having issues with AI grouping? We're here to help.

🐧 Linux Users: The AI grouping feature uses WebAssembly (WASM) which should work on all platforms, but some Linux browsers may need additional configuration.

AI Grouping Not Working?

If the AI grouping button doesn't respond or shows errors, follow these diagnostic steps:

Step 1: Check Console Errors

Open the ZenTree Tabs side panel
Right-click anywhere in the panel → Select "Inspect"
Go to the "Console" tab in DevTools
Click the AI grouping button (⚡ icon)
Look for error messages mentioning "WASM", "transformers", or "model"

Step 2: Verify Browser Support

The AI feature requires modern browser features. Check your setup:

Chrome/Chromium version: 91 or higher recommended
WebAssembly: Must be enabled
Internet connection: Required for first-time model download (~23MB)

                // Test WASM support in Console:
WebAssembly.validate(new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0]))
// Should return: true
            

Common Issues & Solutions

🔴 "Failed to load model"

Cause: Model download failed or was interrupted

Solution:

Check your internet connection
Reload the extension from chrome://extensions/
Try again after a few minutes

🔴 "WASM instantiation failed"

Cause: WebAssembly not properly supported

Solution:

Update Chrome/Chromium to the latest version
Enable WASM flags in chrome://flags:
- chrome://flags/#enable-webassembly
- chrome://flags/#enable-webassembly-simd
Restart your browser after enabling flags

🔴 Nothing happens when clicking AI button

Cause: Extension not fully loaded or worker crashed

Solution:

Go to chrome://extensions/
Find "ZenTree Tabs" and click the reload icon
Close and reopen the side panel

Linux-Specific Fixes

Chromium vs Chrome

Some Chromium builds on Linux have limited WebAssembly support. If you're using Chromium and experiencing issues:

Try switching to Google Chrome (official build)
Or use a more recent Chromium build from your distribution

Enable Chrome Flags

Navigate to these URLs and set to "Enabled":

                chrome://flags/#enable-webassembly
chrome://flags/#enable-webassembly-simd
chrome://flags/#enable-webassembly-baseline
            

Then restart your browser.

Still Having Issues?

If none of the above solutions work, please:

Note your Chrome/Chromium version (chrome://version)
Note your Linux distribution and version
Copy any console error messages
Open an issue on GitHub with this information

💡 Good News: Even if AI grouping doesn't work, you can still use all other ZenTree features including manual grouping, tree hierarchy, bookmarks, downloads, and themes!