xgoose logoxgoose

Support

How can we help?

xgoose is a Safari Web Extension that drops a floating chat launcher onto every page in Safari. Tap it and a chat panel slides up. This page covers the most common things people run into; for anything else, email [email protected] or open an issue on GitHub.

Enable the extension

iPhone / iPad

  1. Open Settings.
  2. Go to Apps → Safari → Extensions and turn on xgoose.
  3. Tap xgooseAll Websites Allow.
  4. Open any web page in Safari. A floating sparkle button appears bottom-right.

Mac

  1. Open Safari → Settings → Extensions and turn on xgoose.
  2. On the xgoose row, click Permissions and choose Allow on Every Website.
  3. Open any web page in Safari. A floating sparkle button appears bottom-right.

Set up an AI provider

xgoose is BYO key — we never hold one for you. The first time you open the chat panel, it asks for credentials. The fastest path:

  1. Open the chat panel and tap Settings.
  2. Pick Google Gemini as the provider (free tier works fine for testing).
  3. Get a free key at aistudio.google.com/apikey and paste it into the API Key field.
  4. Tap Save. Return to the page and type a message.

Any OpenAI-compatible endpoint also works (OpenAI itself, LiteLLM, Together, Azure OpenAI, Ollama, etc.) — pick OpenAI-compatible, paste the base URL, the model name, and the key.

Troubleshooting

The sparkle button doesn’t appear

  • Check the extension is enabled (see above).
  • Check Permissions are set to Allow on Every Website.
  • Reload the page (some pages still cache the old document).
  • On iOS, also verify that Settings → Apps → Safari → Advanced → Web Inspector isn’t blocking extensions on the active site.

The chat says “no API key configured”

  • Open the panel, tap Settings, paste the key, tap Save. Keys live in browser.storage.local on your device only.

The chat replies with an error from the provider

  • That error came from your LLM provider, not from xgoose. Common causes:
  • Invalid key — regenerate one at the provider’s console.
  • Quota exceeded — check your provider’s usage page.
  • Model name typo — for OpenAI-compatible providers, the model name must match exactly (e.g. gpt-4o-mini, not gpt-4o mini).

I want to delete everything xgoose stored

Remove the extension from Safari. iOS / macOS will wipe its browser.storage.local at the OS level along with the extension. Nothing is synced off-device, so there is nothing to delete on a server.

Privacy

xgoose collects nothing — full policy at /privacy.

Contact

Bug report, feature request, or App Store review question: [email protected] or GitHub Issues.