search-with-chatgpt-powered.../README.md

4.2 KiB

Search with ChatGPT Powered by OpenAI Firefox Extension

This extension adds ChatGPT as a configurable Firefox search provider. Type gpt <query> in the address bar to open the query in a new ChatGPT session. It uses no API key, custom server, or intermediary handler.

This is an unofficial extension provided by Zavage Software Inc.

See LICENSE.txt for licensing terms.

Options

Open about:addons, select this extension, and choose the Options tab (Preferences on macOS and Linux). Available settings:

  • Model (experimental) — a model slug such as auto. ChatGPT may ignore it and use your account default; leave blank to always use the account default.
  • Request a temporary chat — asks ChatGPT not to save the conversation. ChatGPT may not honour this; check its own indicator before relying on it.
  • Ask ChatGPT to use web search — a hint to ChatGPT's interface, not a guarantee.
  • Open in — a new tab, a new background tab, or a new window.
  • Prompt template — wraps your text, for example Explain simply: {query}.

These settings apply to the new entry points: selecting text and choosing Ask ChatGPT from the right-click menu, or pressing Alt+Shift+G. Rebind the shortcut under Manage Extension Shortcuts in the Add-ons gear menu.

The gpt <query> address-bar search is unchanged and does not read these settings.

The options panel, the right-click item, and the keyboard shortcut require Firefox 112 or newer. On older versions the extension still installs and the gpt <query> address-bar search still works; only these newer features are inactive.

Why you press Enter twice

ChatGPT no longer submits prompts that are passed to it in a URL — it fills them into the composer and waits. So gpt <query> opens ChatGPT with your query filled in, and you press Enter there to send it.

This is a change OpenAI made to chatgpt.com, not a fault in this extension, and it is outside our control. It was a deliberate security measure: automatically running a prompt that arrived in a link let malicious links execute instructions in a signed-in ChatGPT session. The extra keypress is the checkpoint that prevents that. No API key, server, or intermediary is involved either way.

Browser Support

Firefox Desktop is the current development and release target. Chrome, Brave, other Chromium browsers, and additional WebExtension platforms may be evaluated after the Firefox feature set is more substantial; they are not current targets.

Development

Install Node.js 22 or newer, Firefox, and the locked development dependencies:

npm ci

Available commands:

  • npm run dev launches the extension in a temporary Firefox profile and reloads it when files change.
  • npm run lint validates the extension and treats warnings as errors.
  • npm run test:unit runs the node:test unit tests over test/.
  • npm run build creates web-ext-artifacts/search-with-chatgpt-firefox-<version>.zip.
  • npm test runs the same lint, unit test, and build checks used by Gitea Actions.

The generated ZIP is unsigned. Use npm run dev for local testing; signing and submission to Mozilla Add-ons remain a separate release step.

Before submitting a change, confirm that gpt <query> opens https://chatgpt.com?q=<query>, the provider remains non-default, and it can be configured in Firefox search settings.

Privacy Policy

This extension has no server, no API key, and no intermediary. Nothing is reported to Zavage Software.

  • Your settings are stored in your own browser profile. If you use Firefox Sync with Add-ons enabled, they sync end-to-end encrypted through your own Mozilla account.
  • When you choose Ask ChatGPT or press the shortcut, the text you selected is placed in the chatgpt.com URL the extension opens for you. It goes nowhere else.
  • The extension reads a page's selected text only at the moment you invoke it, and never reads page addresses or titles.