Add setup wizard, CI workflow, and a why-section in the README

'glaze-dev setup' walks through the whole installation - machine, Glaze,
bundled Node, Claude Code, linked skills, plugin, Raycast - explains the
four AI engines apps can offer their users, and points at the next step
wherever something is missing. It runs without Glaze installed too, so it
can guide from zero. install.sh offers to run it at the end.

CI (GitHub Actions, macOS runner) syntax-checks every shell script, scans
tracked files for smart punctuation, verifies skill frontmatter, and
validates the plugin manifest on each push and pull request.

README leads with what the project actually gives you: free development on
your own Claude subscription, apps whose users choose whether AI costs
anything, takeover of interrupted Glaze agent work including the paused
queue, and support for other coding agents.

Author: CloudHugger

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  checks:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Syntax-check shell scripts
+        run: |
+          zsh -n install.sh
+          zsh -n plugins/glaze-coder/scripts/glaze-dev
+          zsh -n plugins/glaze-coder/scripts/terminal-launch.sh
+          for f in plugins/glaze-coder/scripts/raycast/*.sh; do zsh -n "$f"; done
+
+      - name: Typography scan (plain punctuation only)
+        run: |
+          git ls-files -z | tr '\0' '\n' | grep -vE '\.(png|gif|ico|icns)$' > /tmp/files.txt
+          perl -CSD -ne 'if (/[\x{2014}\x{2013}\x{2026}\x{201C}\x{201D}\x{2018}\x{2019}\x{00A0}]/) { print "$ARGV:$.: smart punctuation\n"; $bad = 1 } END { exit 1 if $bad }' $(cat /tmp/files.txt)
+
+      - name: Skills have frontmatter
+        run: |
+          for f in plugins/glaze-coder/skills/*/SKILL.md; do
+            head -1 "$f" | grep -q '^---$' || { echo "Missing frontmatter: $f"; exit 1; }
+          done
+
+      - name: Plugin manifest is valid JSON
+        run: python3 -m json.tool plugins/glaze-coder/.claude-plugin/plugin.json > /dev/null

README.md

@@ -14,6 +14,23 @@ Node runtime Glaze already ships. Editing and building cost you nothing in Glaze
 ![macOS](https://img.shields.io/badge/macOS-Tahoe%2B-black)
 ![Apple Silicon](https://img.shields.io/badge/Apple%20Silicon-required-black)
 ![License](https://img.shields.io/badge/license-MIT-green)
+![CI](https://github.com/GaimsDevSoftware/glaze-coder/actions/workflows/ci.yml/badge.svg)
+
+## Why glaze-coder
+
+- **Development costs 0 Glaze credits.** Glaze's built-in agent spends credits for
+  every change. glaze-coder does the same work with the Claude subscription you
+  already pay for: create, code, build and run apps for free.
+- **Your app users choose whether AI costs them anything.** Apps built with
+  glaze-coder ship with an engine picker: built-in Glaze AI (their credits), a free
+  Google Gemini key, OpenRouter free models, or their own Claude subscription via
+  the local CLI. When Glaze credits run out, the app switches to a configured free
+  engine on its own.
+- **Pick up where Glaze's agent stopped.** Ran out of credits mid-task? Continue in
+  Claude Code with full project context, and pull the paused prompt queue straight
+  out of the Glaze window with `glaze-dev queue`.
+- **Not locked to one agent.** Works with codex, opencode, gemini and the desktop
+  apps too.
 
 ## What you get
 
@@ -55,6 +72,13 @@ Then create your first app and jump straight into Claude Code:
 glaze-dev start "Habit Tracker"
 ```
 
+The installer ends with a guided check of the whole setup. You can rerun it any
+time to see what is installed, what is missing, and what to do next:
+
+```bash
+glaze-dev setup
+```
+
 That is all most people need. The sections below show the individual methods if you
 prefer to do it by hand.
 
@@ -110,6 +134,8 @@ glaze-dev run   <app>        Open the built app
 glaze-dev br    <app>        Build then run
 glaze-dev rm    <app>        Remove an app (bundle, source, profile)
 glaze-dev agents             List the coding agents you have installed
+glaze-dev setup              Guided check of the whole setup
+glaze-dev queue <app>        Read the paused prompt queue out of the Glaze window
 ```
 
 `<app>` matches on the folder name or product name, so partial names work.

install.sh

@@ -145,6 +145,17 @@ else
 fi
 print ""
 
+# 6. Guided check of the whole setup (Glaze, Claude Code, skills, AI engines).
+print ""
+if [[ -t 0 ]]; then
+  if ask y "Run the setup check now? (verifies Glaze, Claude Code and the AI engines)"; then
+    "$HOME/.local/bin/glaze-dev" setup || true
+  fi
+else
+  print "Tip: run 'glaze-dev setup' for a guided check of the whole setup."
+fi
+
+print ""
 green "Done."
 print "Start a new app now:"
 print '   glaze-dev start "My App"'

plugins/glaze-coder/scripts/glaze-dev

@@ -27,8 +27,14 @@ if [[ -z "$GLAZE_BASE" ]]; then
   done
 fi
 if [[ -z "$GLAZE_BASE" || ! -d "$GLAZE_BASE/apps" ]]; then
-  print -u2 "❌ Fant ikke Glaze. Sett GLAZE_BASE manuelt, eller start Glaze én gang."
-  exit 1
+  # setup/help skal kunne veilede selv uten Glaze installert.
+  case "${1:-}" in
+    setup|doctor|help|-h|--help|"") GLAZE_BASE="" ;;
+    *)
+      print -u2 "❌ Fant ikke Glaze. Sett GLAZE_BASE manuelt, eller start Glaze én gang."
+      print -u2 "   Ny her? Kjør: glaze-dev setup"
+      exit 1 ;;
+  esac
 fi
 
 APPS_DIR="$GLAZE_BASE/apps"
@@ -207,6 +213,98 @@ cmd_buildrun(){ cmd_build "$1"; cmd_run "$1"; }
 cmd_path()    { _need "$1"; print -r -- "$SRC"; }
 cmd_finder()  { _need "$1"; open "$SRC"; }
 
+# Interaktiv onboarding og helsesjekk: verifiser hele oppsettet steg for steg,
+# forklar AI-motorvalgene, og pek på neste steg der noe mangler. Trygg å kjøre
+# når som helst; endrer ingenting uten å spørre.
+cmd_setup() {
+  local pass="%F{green}✓%f" fail="%F{red}✗%f" note="%F{yellow}!%f"
+  print -P "%B== glaze-dev setup: onboarding og helsesjekk ==%b"
+  print ""
+
+  # 1) Maskin
+  if [[ "$(uname -m)" == arm64 ]]; then
+    print -P "$pass Apple Silicon-Mac"
+  else
+    print -P "$fail Krever Apple Silicon (arm64). Denne maskinen: $(uname -m)"
+  fi
+
+  # 2) Glaze selv
+  if [[ -n "$GLAZE_BASE" && -d "$GLAZE_BASE/apps" ]]; then
+    local napps; napps="$(ls -1 "$APPS_DIR" 2>/dev/null | wc -l | tr -d ' ')"
+    print -P "$pass Glaze er installert ($napps app(er))"
+    if (( napps == 0 )); then
+      print "   Neste steg: lag din første app -> glaze-dev start \"Min App\""
+    fi
+  else
+    print -P "$fail Glaze er ikke installert (eller aldri startet)."
+    print "   Last ned fra https://www.glaze.app, åpne den én gang, og kjør setup igjen."
+    print ""
+    print "Resten av sjekkene hopper vi over til Glaze er på plass."
+    return 0
+  fi
+
+  # 3) Medfølgende Node (kreves for gratis bygg)
+  if command -v node >/dev/null 2>&1 && [[ "$(node -v 2>/dev/null)" == v2[4-9]* ]]; then
+    print -P "$pass Node $(node -v) (Glaze sin medfølgende runtime)"
+  else
+    print -P "$note Fant ikke Glaze sin Node >= 24 på PATH. Bygg kan feile."
+    print "   Den følger med Glaze; åpne Glaze én gang så lastes den ned."
+  fi
+
+  # 4) Claude Code (gratis utvikling via ditt abonnement)
+  if command -v claude >/dev/null 2>&1; then
+    print -P "$pass Claude Code $(claude --version 2>/dev/null | head -1)"
+    print "   NB: --version beviser ikke innlogging. Aldri logget inn? Kjør: claude"
+  else
+    print -P "$fail Claude Code er ikke installert."
+    print "   Installer fra https://claude.com/product/claude-code og kjør 'claude' for innlogging."
+    print "   Uten den koster utvikling Glaze-kreditter; med den er den gratis via abonnementet ditt."
+  fi
+
+  # 5) Glaze-skills lenket inn i ~/.claude
+  local nlinked=0
+  [[ -d "$HOME/.claude/skills" ]] && nlinked="$(ls -1 "$HOME/.claude/skills" 2>/dev/null | grep -c "^glaze" || true)"
+  if (( nlinked > 5 )); then
+    print -P "$pass Glaze-skills lenket inn i ~/.claude/skills ($nlinked stk)"
+  else
+    print -P "$note Glaze-skills ser ikke ut til å være lenket."
+    if [[ -t 0 ]]; then
+      read "ans?   Lenke dem nå? [Y/n]: "
+      [[ -z "$ans" || "$ans" == [Yy]* ]] && { _link_skills; print -P "$pass Lenket."; }
+    else
+      print "   Kjør: glaze-dev skills"
+    fi
+  fi
+
+  # 6) Claude Code-plugin
+  if command -v claude >/dev/null 2>&1; then
+    if claude plugin list 2>/dev/null | grep -q "glaze-coder"; then
+      print -P "$pass Claude Code-pluginen (/glaze-coder:glaze) er installert"
+    else
+      print -P "$note Claude Code-pluginen mangler. Kjør: claude plugin install glaze-coder"
+    fi
+  fi
+
+  # 7) Raycast (valgfritt)
+  if [[ -d "/Applications/Raycast.app" || -d "$HOME/Applications/Raycast.app" ]]; then
+    print -P "$pass Raycast finnes. Kommandoer settes opp med: glaze-dev raycast"
+  else
+    print -P "$note Raycast ikke funnet (valgfritt). Kommandoene virker fint uten."
+  fi
+
+  # 8) AI i appene dine
+  print ""
+  print -P "%BAI-motorer i appene du bygger:%b"
+  print "  Apper laget med glaze-coder gir sluttbrukeren et valg om AI skal koste noe:"
+  print "  - Glaze AI       innebygd, null oppsett, bruker brukerens Glaze-kreditter"
+  print "  - Google Gemini  gratis med egen nøkkel (https://aistudio.google.com/apikey)"
+  print "  - OpenRouter     gratis modeller med egen nøkkel (lav dagskvote)"
+  print "  - Claude Code    gratis via brukerens Claude-abonnement (lokal CLI)"
+  print "  Tomme Glaze-kreditter? Reservemotoren bytter automatisk til en gratis motor."
+  print ""
+  print -P "%BKlar. Neste steg:%b  glaze-dev start \"Min App\"    (ny app + Claude Code, 0 kreditter)"
+}
+
 # Les ut koede (pausede) prompts fra Glaze-vibekoderens chatvindu for en app.
 # Koen finnes bare i Glaze-UIets minne (ikke i db/localStorage), så vi leser den
 # fra accessibility-treet. CSS-avkutting kutter ikke DOM-teksten, så vi får
@@ -442,6 +540,7 @@ ALLE KOMMANDOER:
   glaze-dev finder <app>                Åpne app-mappen i Finder
   glaze-dev rm     <app>                Fjern app fullstendig (bundle+kilde+profil)
   glaze-dev raycast                     Sett opp Raycast (kopier sti + åpne Raycast)
+  glaze-dev setup                       Onboarding/helsesjekk av hele oppsettet
   glaze-dev skills                      Koble Glaze-skills inn i ~/.claude/skills
 
 <app> matcher på mappenavn eller produktnavn (delvis treff er ok).
@@ -471,6 +570,7 @@ case "$cmd" in
   finder|reveal)        cmd_finder "$@" ;;
   rm|delete|remove)     cmd_rm "$@" ;;
   raycast|raycast-setup) cmd_raycast "$@" ;;
+  setup|doctor)         cmd_setup "$@" ;;
   skills|link-skills)   cmd_skills ;;
   help|-h|--help)       cmd_help ;;
   *) print -u2 "Ukjent kommando: $cmd"; cmd_help; exit 1 ;;