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.

Once Airglow is installed, building a new app is one prompt to your coding agent. You describe the page, the action, and the result. The agent writes the manifest, the userscript, and (if needed) the server module under airglow-apps/your-app/. The local server picks it up. The app shows up on the page you targeted.
Done means a new folder appears under airglow-apps/, the local server logs it, and the app renders on the page you described.

​
Steps

​
1. Open the SDK in your coding agent

Open airglow-sdk as the workspace in Codex, Claude Code, Cursor, or another coding agent. Let it inspect the repo first — you’ll get better prompts after the agent has read airglow-apps/shared/ and one existing showcase.

​
2. Write a short, specific prompt

Name three things: page, action, result. One of each. 
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.
The shorter the better. Long prompts at this stage produce sprawling apps.

​
3. Open the target page and check

Open the page you named (news.ycombinator.com in the example above). The panel should appear without you doing anything else.
The app shows up only on the page it targets, and only uses what’s on that page.

​
4. Iterate in short rounds

The first version rarely lands. Run it on the real page, see what’s off, ask for one fix. 
The picks feel random — use the top comments to ground each
summary in 1–2 sentences.
Short rounds beat one long prompt. Each showcase page walks through 6 of these.

​
Best practices

  • One app, one page, one action. If your first prompt covers two, split it into two apps.
  • Be specific. “Summarize visible HN stories into five bullets” works better than “summarize the page”.
  • Trust the page, not the chat. The agent’s summary of what it did is not the result. Open the target site and check.
  • Start from a showcase. If your idea is shaped like an existing app (list-summarize / extract-fields / answer-from-context), tell the agent to fork that showcase and retarget it. Faster than starting blank.

​
If it does not work

CaseFix
App is missing on the target pageKeep the server running, reload the extension, then refresh the page.
Manifest changed but nothing reloadsTouch the manifest or restart pnpm airglow dev.
App appears but data looks wrongCheck what’s actually on the page — open DevTools and confirm the selectors match.
More cases in Troubleshooting.