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.

Build one small Hacker News app. The agent changes the code; you open the page and check the result.
Done means Airglow is installed in Chrome, the local app server is running, and the app appears on news.ycombinator.com.

​
Before you start

You need:
  • Chrome
  • Node.js
  • pnpm
  • a terminal
  • Codex, Claude Code, Cursor, or another coding agent
You do not need to understand browser extension APIs for the first run.

​
Steps

1

Clone the dev kit

Start with the public dev kit repo. It includes the Chrome extension and the local app server.
git clone https://github.com/Airglow-up/Airglow-dev-kit.git
cd Airglow-dev-kit
You will load the extension folder from this repo in Chrome in the next step.
2

Load the extension in Chrome

Load the extension from the cloned repo so Airglow apps can run on web pages.
  1. Open chrome://extensions.
  2. Turn on Developer Mode.
  3. Click Load unpacked.
  4. Select Airglow-dev-kit/extension.
Airglow appears in the Chrome extensions list and is enabled.
3

Start the local app server

The extension uses the local app server to load apps while you build and edit them.
pnpm install
pnpm airglow dev
Keep this terminal running while you test the app.
4

Open the repo in your coding agent

Open Airglow-dev-kit as the workspace in Codex, Claude Code, Cursor, or another coding agent.Let the agent inspect the repo, make the change, and explain how to test it. You describe the app; the agent edits the code.
5

Paste a short prompt

Ask for one page, one action, and one visible result.
Create a small Hacker News app.

When I open news.ycombinator.com, show a compact panel that:
- reads the visible story titles
- summarizes the main themes in 5 bullets

Keep it simple and match the existing project style.
Tell me what changed and how to test it.
6

Open Hacker News and check the result

Open the target page and check the full loop: page match, app UI, page content, and result.
  1. Open news.ycombinator.com.
  2. The app panel should appear on the page.
  3. Click Summarize.
  4. You should see five short bullets.
The app appears only on the matching page and uses the current page content.

​
If it does not work

Most first-run issues are one of three things.
CaseFix
Airglow is missing in ChromeOpen chrome://extensions and load Airglow-dev-kit/extension again.
Local apps do not loadRestart the local app server with pnpm airglow dev.
App is missing on Hacker NewsKeep the server running, reload the extension, then refresh the page.
For more cases, open Troubleshooting.