In one line: a website deployment runbook for AI agents — probe the sandbox environment, collect three required credentials (tokens / Git integration auth / Access control), and automate everything else (GitHub repo, Netlify deploy, PWA, 4-way version sync) to form the continuous delivery loop of "edit code → push → auto-deploy → live in ~1 minute". Real-world pitfalls are baked into executable steps and a one-command publish.sh, so any agent can take a static site / PWA from zero to live.
Enables any AI Agent to complete the full delivery loop: "edit code → push → auto-deploy → website live update". For: static sites / single-file web apps / PWA (GitHub private repo + Netlify static hosting). This repository is a privacy-scrubbed generic version — no credentials, accounts, or personal data. Obtain credentials from the actual user before use.
This runbook has been fully tested only in the RikkaHub built-in Agent workspace (proot sandbox · Ubuntu 24.04 aarch64).
If you run in other agent platforms / sandboxes (Docker, VMs, other app workspaces):
- CLI behavior, network reachability, mirror sources, architecture (x86_64 vs arm64), and API responses may differ
- Always run environment detection & network probing first per
沙箱环境准备-通用版.mdbefore executing this runbook - Not validated outside RikkaHub; adapt as needed and feel free to report back
- Full automation: env prep → GitHub private repo → Netlify site/deploy → live verification
- Only 3 manual steps (tokens / Git integration auth / Access control → Public), each with reason + exact guidance (verified: APIs cannot do these)
- One-command publish
publish.sh: version 4-way sync + sw cache name + regression test + commit + push - PWA kit: manifest + Service Worker (offline) + icons (pure Python stdlib, zero deps)
- Ready-to-use assets:
req.pyHTTP tool, API cheat sheet, icon generator
| File | Content | Must-read |
|---|---|---|
部署流程指南-v3.0通用版.md |
Core: full pipeline (env → project → GitHub → Netlify → verify) + 3 manual steps + API cheat sheet + publish.sh + PWA | ✅ read first |
沙箱环境准备-通用版.md |
Env detection / tool setup / network probing / one-shot setup template | ✅ pair with above |
Core docs are currently in Simplified Chinese; an English translation is planned — contributions welcome.
- Read §0 "Before You Start" and §3 "Manual Steps" in
部署流程指南-v3.0通用版.md - Use
ask_userto collect: GitHub Token, Netlify Token, git identity (the user may write the files themselves, or paste them to you) - Everything else is automated: create repo → push → create site → deploy → PWA → publish script
- End-to-end verify: edit one line → push → confirm the site auto-updates (~1 min)
| Step | Why |
|---|---|
| Token provisioning | Account security; credentials must come from the user |
| Netlify Git integration auth | Private repo requires GitHub App OAuth; API config silently rejected (build_settings returns empty) |
| Netlify Access control → Public | No public API (401 troubleshooting in guide §11) |
Details & guidance in the core guide, §3.
req.py(HTTP request tool, curl-free) — guide appendix Apublish.sh(one-command publish script template) — guide §8- PWA icon generator (pure Python stdlib) — guide appendix C
- GitHub / Netlify API cheat sheet (tested OK / FAIL) — guide appendix B
- RikkaHub: this runbook was developed and fully tested in its built-in Agent workspace (proot-based lightweight Linux env). github.com/rikkahub/rikkahub (by @re-ovo, AGPL-3.0)
- Netlify: netlify.com — free static hosting + Git-integrated auto-deploy
- GitHub: github.com — private repos + Actions ecosystem
| Version | Date | Notes |
|---|---|---|
| v3.0 | 2026-08-08 | Privacy-scrubbed generic release; renamed to agent-site-deploy-runbook (agent · site · deploy) |
Agent Site Deploy Runbook · generic privacy-scrubbed version · distilled from real deployments (Git integration / Access control / PWA / one-command publish, all end-to-end verified)
License: MIT · free to use, modify and commercialize with attribution.