Troubleshoot common Ophel Atlas problems step by step

Step-by-step fixes for the most common Ophel Atlas problems: panel not showing, empty outline, stalled prompt queue, Firefox restarts, and more.

If something isn’t working as expected, this page walks you through the most common issues and how to fix them. For problems not covered here, open a report on GitHub Issues with your browser version, extension version, and any errors from the browser console.

---

Panel not appearing

The Ophel side panel should appear automatically when you open a supported AI platform. If it doesn’t show up:

1. Confirm the extension is enabled

   Click the puzzle-piece icon in your browser toolbar and verify that Ophel Atlas is toggled on. If it’s disabled, enable it and reload the page.

2. Hard-reload the page

   Press Ctrl+Shift+R (Mac: Cmd+Shift+R) to force a full page reload. A standard reload sometimes does not reinitialize the Ophel panel on the page.

3. Check the supported site list

   Ophel only activates on its supported platforms. Confirm you’re on one of the 15 supported sites (Gemini, ChatGPT, Claude, DeepSeek, Grok, and others). If the URL doesn’t match, Ophel will not inject the panel.

4. Use the keyboard shortcut as a fallback

   If the panel was previously closed, press Alt+P (Mac: Option+P) to reopen it. This toggles the panel regardless of the state of any floating buttons.

---

Outline is empty or not updating

1. Refresh the outline manually

   Press Alt+R (Mac: Option+R) to force the outline to re-scan the conversation. Some AI platforms update the DOM asynchronously, so the outline may not populate on its own immediately after the page loads.

2. Wait for the AI to finish responding

   The outline rebuilds after each AI reply completes. If the AI is still generating, the outline won’t update until it finishes.

3. Check the auto-update setting

   Go to Settings → Features → Outline and confirm that Auto update is enabled. If it’s off, the outline only refreshes when you trigger it manually with Alt+R (Mac: Option+R).

---

Outline not tracking scroll position

If the outline doesn’t highlight the section you’re currently reading as you scroll:

1. Enable scroll sync in Settings

   Go to Settings → Features → Outline and set Follow mode to current. When this is set to manual, the outline does not automatically track your scroll position.

---

Floating buttons disappeared

The floating action buttons auto-collapse into a compact pill shape after 5 seconds of inactivity. They are not gone — they’re just minimized.

1. Move your mouse near the buttons

   Move your cursor within approximately 150 px of the collapsed pill. The buttons will expand automatically.

2. Use the keyboard shortcut if the pill is not visible

   If the buttons are completely missing from the screen, press Alt+P (Mac: Option+P) to open the panel. The floating buttons reappear alongside it.

---

Panel covering page content

If the Ophel panel is positioned over something you need to click on the underlying page:

1. Use ghost mode for temporary click-through

   Hold Ctrl (Windows/Linux) or Command (Mac) alone for about 0.2 seconds. The panel becomes transparent and lets clicks pass through to the page behind it. Release the key to restore the panel to normal.

2. Drag the panel to a screen edge

   Drag the panel toward any screen edge. When it snaps into place, it hides against the edge and only slides out when you hover over it — freeing up the rest of the screen. To undock it, drag it away from the edge.

---

Conversations tab is empty

1. Make sure the AI platform's sidebar has loaded

   The Conversations tab reads directly from the AI platform’s own sidebar. If that sidebar hasn’t loaded yet, Ophel has nothing to display.

2. Scroll the native sidebar

   Open the AI platform’s built-in conversation list and scroll down to trigger it to load more items. After it loads, Ophel’s Conversations tab will reflect the updated list.

---

Prompt queue stalled

The Prompt Queue advances to the next prompt by detecting when the AI page becomes idle — specifically, when no active generation spinner is visible for two consecutive polling intervals (roughly 2 seconds).

1. Check whether the AI has actually finished

   Some platforms briefly show a loading indicator even after generation is complete. Wait a few seconds to see if the queue advances on its own.

2. Use the manual Send next button

   If the AI platform uses an unusual loading indicator that Ophel cannot detect, the queue may stall. Click the Send next button in the queue overlay to manually advance to the next prompt.

3. Check that the queue is not paused

   Make sure the queue is in the Running state, not Paused. If it’s paused, click Resume in the queue overlay.

---

Firefox: extension removed after browser restart

Firefox treats extensions loaded via Load Temporary Add-on (through about:debugging) as temporary add-ons. They are automatically removed every time you restart Firefox.

1. Install from Firefox Add-ons for a permanent install

   Install Ophel Atlas from the Firefox Add-ons store. Store-installed extensions persist across restarts.

2. Use the userscript as an alternative

   If you need to use a local build or cannot use the Add-ons store, install the userscript version via Tampermonkey. Userscripts managed by Tampermonkey are not affected by Firefox’s temporary add-on limitation.

---

Something else is broken

If none of the above applies, follow these steps to diagnose the issue before reporting it:

1. Test in an incognito window

   Open an incognito (private) window with only Ophel enabled and no other extensions. If the problem disappears, another extension is likely interfering.

2. Check the browser DevTools console

   Right-click anywhere on the page, choose Inspect, and open the Console tab. Look for red error messages that mention Ophel or the AI platform. Copy any errors you find — they’re essential for a bug report.

3. Note your versions

   Before reporting, note your browser name and version, your Ophel Atlas version (shown in the extension popup), and the affected AI platform URL.

4. Report on GitHub Issues

   Open a new issue at github.com/urzeye/ophel/issues with the information from the steps above. Include the console output and a description of how to reproduce the problem.

---

Report an issue on GitHub

Open a bug report or feature request on the Ophel Atlas GitHub Issues page. Include your browser version, extension version, and any console errors to help the team reproduce the problem.