diff --git a/README.md b/README.md index f96a6bf..e7f4ba1 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,19 @@ files. (You supply the two things only you have: your **git remote + credentials --- +## Deploying it — the one link to hand your agent + +Give your agent this single link and say *"read it and deploy your weave — ask me what you need"*: + +> `https://git.jhestyr.net/admin/chalupa/raw/branch/master/agent/DEPLOY.md` + +That file's first step pulls the whole kit down for it (a no-account `git clone` — the repo is public), then +it builds your weave from the templates and interviews you (**session zero**) for the rest. If you re-host +this kit, hand over your own `agent/DEPLOY.md` link instead. *(Prefer to drive it yourself? Start +with [`human/`](human/).)* + +--- + ## Who reads what There are two readers, and the kit is split for them: diff --git a/agent/DEPLOY.md b/agent/DEPLOY.md index 5ccef2c..335194d 100644 --- a/agent/DEPLOY.md +++ b/agent/DEPLOY.md @@ -9,6 +9,22 @@ Companion files: [`WEAVE-REFERENCE.md`](WEAVE-REFERENCE.md) (what each part is a --- +## Step 0 — get this whole kit onto the machine first +You're probably reading this over the web (your human handed you a link). You can't deploy from a single web +page — the `templates/` are **files you copy**, not text to fetch one at a time. So pull the whole kit local +first — the repo is public, **no account needed**: + +``` +git clone https://git.jhestyr.net/admin/chalupa.git ~/chalupa +# fallback, if clone is unavailable (a plain archive download, also no account): +# curl -sL -o /tmp/chalupa.zip "https://git.jhestyr.net/admin/chalupa/archive/master.zip" && unzip -q /tmp/chalupa.zip -d ~/ +``` +(If your human re-hosted the kit somewhere else, use their URL instead.) Confirm `~/chalupa/templates/` exists, +then run everything below **from your local `~/chalupa/` copy** — the companion docs and templates are all +there now. Remember: this kit is the *instructions*; the **weave you build is a separate, new repo** (Step 1). + +--- + ## First, understand the two failure modes you're building against 1. **You wake up empty.** The weave is your continuity — read it back at wake, and trust the *files* over any recollection.