ToggleX Documentation

🚀 Quick Start

Goal: Install extension → Browse normally → AI gets context automatically.

  1. 1

    Download Extension

    Click the download button below to get the Chrome extension package.

    Download .zip Package
  2. 2

    Extract the Package

    Unzip the downloaded file to a folder on your computer (e.g., ~/togglex-extension).

  3. 3

    Load in Chrome

    Open Chrome and go to:

    chrome://extensions/

    Enable "Developer mode" (toggle in top-right corner).

    Click "Load unpacked" and select the extension folder you extracted.

  4. 4

    Configure API Endpoint

    Click the ToggleX extension icon → Options → Set API Base URL:

    https://api.togglex.axxhar.site

    This is where your browsing context will be sent.

  5. 5

    Start Browsing

    That's it! ToggleX will now capture your browsing context and send it to your AI assistant automatically.

⚙️ How It Works

ToggleX runs silently in your browser and captures:

  • Page visits: URL, title, domain when you navigate to a new page
  • Tab switches: Which tab you're actively viewing
  • Duration: How long you spend on each page

This data is sent to your configured API endpoint where your AI assistant can use it to:

  • Understand what you're researching
  • Provide context-aware responses
  • Remember what you've been reading

Privacy Note:

ToggleX does NOT collect passwords, form inputs, or personal messages. It only captures page metadata (URL, title, domain).

🔧 Troubleshooting

Extension not showing up in Chrome?

Make sure you:

  • Enabled "Developer mode" in chrome://extensions/
  • Loaded the correct folder (the one containing manifest.json)
  • Restarted Chrome if needed

API errors in console?

Check that:

  • Your API endpoint is correct (default: https://api.togglex.axxhar.site)
  • The API is accessible (try opening it in browser)
  • You have an internet connection

Note: ToggleX will queue events locally if the API is offline and retry automatically.

How do I know it's working?

Open Chrome DevTools (F12) → Console tab. You should see logs like:

[ToggleX] Events sent successfully

If you see errors, they will be logged with details.

How do I uninstall?

Go to chrome://extensions/ → Find ToggleX → Click "Remove". All local data will be automatically cleared.

📚 Technical Details

API Endpoint

Events are sent to:

POST {{ apiBase }}/v1/events/ingest

Event Format

{
  "events": [
    {
      "user_id": "local-user",
      "event_type": "tab_active",
      "ts": "2026-02-27T10:00:00.000Z",
      "url": "https://example.com",
      "title": "Example Page",
      "domain": "example.com",
      "tab_id": 123,
      "window_id": 456,
      "duration_ms": 0
    }
  ],
  "user_id": "local-user",
  "extension_version": "1.0.0",
  "timestamp": "2026-02-27T10:00:00.000Z"
}

Event Types

  • tab_active - User switched to this tab
  • tab_blur - User switched away from this tab
  • navigation - Page completed loading

Offline Handling

Events are queued locally (max 100) and retried every 5 seconds when connection is restored.

💬 Support

Having issues or questions? Reach out: