Common Issues

Common Issues and Solutions

This guide covers the most frequently encountered issues and their solutions.

Authentication Issues

Cannot Sign In with Google

Symptoms: OAuth popup closes without signing in, or shows error message.

Solutions:

1. Clear browser cache and cookies

   • Chrome: Settings → Privacy → Clear browsing data
   • Select “Cookies and other site data”
   • Try signing in again

2. Check popup blockers

   • Ensure your browser allows popups from app.apxlabs.ai
   • Disable browser extensions that might block OAuth

3. Try incognito/private mode

   • This helps identify if browser extensions are interfering
   • If it works, disable extensions one by one to find the culprit

Session Expired Error

Symptoms: “Your session has expired, please sign in again”

Solution:

• This is normal after extended inactivity
• Simply sign in again - your work is saved
• Sessions expire after 24 hours of inactivity for security

Agent Issues

Agent Won’t Start

Symptoms: Agent status stuck on “Starting…” or immediately goes to “Stopped”

Solutions:

1. Wait 30 seconds - Agents can take 10-30 seconds to fully start
2. Check API endpoint - Ensure the endpoint URL is correct and accessible
3. Try stopping and restarting - Click “Stop Agent” wait 5 seconds, then “Start Agent”
4. Check network connectivity - Ensure you have stable internet connection

Agent Stopped Unexpectedly

Symptoms: Agent was running but status changed to “Stopped”

Solutions:

• This can happen if the API endpoint becomes unreachable
• Verify your API is still online and accessible
• Restart the agent
• Check for any API authentication requirements

Session Issues

WebSocket Connection Lost

Symptoms: “Connection lost” message in session, no real-time updates

Solutions:

1. Check internet connection - Ensure stable connectivity
2. Refresh the page - Session state is preserved
3. Firewall/proxy issues - Ensure WebSocket connections are allowed
4. Contact support if issue persists

Session Tab Won’t Close

Symptoms: Close button doesn’t work or tab reappears

Solution:

• Refresh the page - this will close all tabs and reset the state
• Your session history is preserved
• You can reopen sessions from the Past Sessions list

Cannot Create New Session

Symptoms: “New Session” button is disabled or doesn’t work

Checklist:

• ✓ Agent must be running (status shows “Running”)
• ✓ API must be properly configured
• ✓ You must be viewing a single API (not the API list)
• ✓ Browser must have stable internet connection

Performance Issues

Slow Page Load

Solutions:

1. Clear browser cache - Old cached data can slow things down
2. Check internet speed - Run a speed test
3. Close unused tabs - Especially other session tabs
4. Disable heavy browser extensions

WebSocket Latency

Symptoms: Delayed responses in chat, slow real-time updates

Solutions:

• Check network latency (ping test)
• Close other bandwidth-heavy applications
• Switch to wired connection if on WiFi
• Contact support if latency is consistently > 500ms

UI Issues

Context Panel Won’t Open/Close

Solution:

• Click the toggle button on the right edge of the panel
• Refresh page if toggle is unresponsive
• Check browser console for errors (F12 → Console tab)

Floating Action Bar Disappeared

Solution:

• Move mouse to the far left edge of screen
• Wait 1 second for auto-show
• Click to pin it open permanently

Still Having Issues?

If these solutions don’t help:

1. Check service status - Visit status.apxlabs.ai (if available)
2. Join Discord - Get help from the community: discord.gg/TjrFRrvqhs
3. Email support - support@apxlabs.ai
4. Report a bug - Include:
   • Browser and version
   • Steps to reproduce
   • Screenshots if applicable
   • Browser console errors (F12 → Console)

Related Guides

• Connection Problems
• Agent Errors
• FAQ