Quick start

1. 1

   Install the xgoose extension

   Grab the extension for your browser from the xgoose repo. Safari and Chrome are supported; the Firefox build is in preview. On iPhone and iPad, grab it from the App Store. The extension ships with a small set of built-in skills so you can verify the install before pulling anything from the registry.

   Download for iOS Get the extension
2. 2

   Sign in at xgoose.org

   Open /login and pick GitHub, magic link, or email + password. Every method ends with an email round-trip — you will receive a magic link in your inbox before the first session is issued. See Sign in for the full flow.

3. 3

   Pair the extension with your account

   Open the xgoose extension popup and click Connect to xgoose.org. It will show a short user code and open /account in a new tab so you can approve it. This is a standard OAuth 2.0 device authorization. Once approved, the extension can talk to the registry and the AI gateway as you.

4. 4

   Install a skill

   Browse /skills and pick one whose @match pattern fits the site you want to automate. Click Install in xgoose. The button opens the canonical .xgs.js source URL — the extension's install banner intercepts that navigation and shows a confirmation screen with the parsed header and per-function summaries. Confirm to save it under window.xgoose.skills.

   See Browse and install for what the install banner shows and how versioning works on re-install.

5. 5

   Run the agent

   Navigate to a page the skill matches, open the xgoose popup, and type a task — for example, “extract the top 10 results into a table.” The agent will pick the right skill from its tool list, call its functions, and stream the result back. Chat completions go through the free AI gateway by default — you do not need an API key to start.

What next?