Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.airglow.cc/llms.txt

Use this file to discover all available pages before exploring further.

Get Airglow running on your machine. You’ll need Chrome, Node.js, pnpm, and a terminal.
Done means the Airglow icon is in Chrome’s extension list and pnpm airglow dev is serving manifests on http://localhost:3001.

Pick a path

Have an agent install it

Paste a prompt into Codex / Claude Code / Cursor. They do the clone and the server start; you do the one Chrome click.

Install it yourself

Three steps in a terminal — clone the SDK, load the extension, start the local server. ~3 minutes.

Have an agent install it

Paste this into Codex, Claude Code, Cursor, or another agent:
Clone https://github.com/airglow-inc/airglow-sdk, then:
1. Walk me through loading the unpacked extension at airglow-sdk/extension
   in Chrome (chrome://extensions, developer mode, load unpacked).
2. Walk me through enabling user scripts for the Airglow extension —
   open its Details page and toggle on "Allow user scripts".
   (Required in Chrome 138+ for Airglow apps to run.)
3. Run `pnpm install` and `pnpm airglow dev` from the repo root and keep
   the server running.
4. Confirm http://localhost:3001/api/apps/manifests returns JSON.

Then stop and tell me Airglow is ready.
The agent does the cloning and the server start. You do the two Chrome-side clicks (load unpacked + allow user scripts) — Chrome blocks programmatic extension changes.

Install it yourself

1. Clone the SDK repo

The public SDK repo ships the Chrome extension and the local app server.
git clone https://github.com/airglow-inc/airglow-sdk.git
cd airglow-sdk
You’ll load the extension folder from this repo in the next step.

2. Load the extension in Chrome

  1. Open chrome://extensions.
  2. Turn on Developer Mode.
  3. Click Load unpacked.
  4. Select airglow-sdk/extension.
  5. Click the new Airglow card’s Details, then toggle on Allow user scripts.
Airglow appears in the Chrome extensions list, is enabled, and has user scripts allowed. (Chrome 138+ requires the user-scripts toggle before Airglow apps can run on pages.)

3. Start the local app server

The extension talks to a local app server to pick up apps while you build and edit them.
pnpm install
pnpm airglow dev
Keep this terminal running while you build or use apps.
curl http://localhost:3001/api/apps/manifests returns JSON.

Next

You have Airglow installed. Two paths from here:
  • Use a prebuilt app. The SDK ships five showcase apps under airglow-apps/ — they’re running on your local server right now. Open the page each one targets (news.ycombinator.com, Gmail, a GitHub repo, a LinkedIn profile, Google Ads) and the app appears.
  • Build your own. Prompt your coding agent for a new app on any page. See Build your own.

If it does not work

CaseFix
Airglow is missing in ChromeRe-open chrome://extensions and load airglow-sdk/extension again.
Manifests endpoint doesn’t respondRestart the server with pnpm airglow dev from airglow-sdk/.
More cases in Troubleshooting.