@@ -5,9 +5,9 @@ type: feature
55 status: review
66 priority: p2
77 created: 2026-11-08T06:26:18Z
8-updated: 2026-11-08T07:08:43Z
8+updated: 2026-11-08T15:09:16Z
99 source: human
10-moves: 2026-11-08T06:26:22Z inbox doing drag; 2026-11-08T06:27:05Z doing review agent; 2026-11-08T06:57:08Z review doing drag; 2026-11-08T07:00:33Z doing review agent; 2026-11-08T07:01:42Z review todo note; 2026-11-08T07:01:44Z todo doing drag; 2026-11-08T07:04:04Z doing review agent
10+moves: 2026-11-08T06:26:22Z inbox doing drag; 2026-11-08T06:27:05Z doing review agent; 2026-11-08T06:57:08Z review doing drag; 2026-11-08T07:00:33Z doing review agent; 2026-11-08T07:01:42Z review todo note; 2026-11-08T07:01:44Z todo doing drag; 2026-11-08T07:04:04Z doing review agent; 2026-11-08T15:04:59Z review todo note; 2026-11-08T15:05:05Z todo doing drag; 2026-11-08T15:09:16Z doing review agent
1111 area: import
1212 ---
1313
@@ -67,3 +67,17 @@ Can we make this more formal, like a cli with the server bin? We could build on
6767 Not checked: the push over real SSH. Adding a test key to ~/.ssh/authorized_keys was blocked, so I pushed by path, which runs the same receive-pack and hook. Over SSH, only the transport differs.
6868 Important: repos/ is git-ignored, and this VM gets recreated. A hosted repo on the VM lives only there, so it would be lost on reset. Run new on the machine that serves xonecas.io, and back up repos/xonecas.io/.
6969 1043 (mirror path in published .git/config) also applies to hosted repos.
70+
71+- 2026-11-08 15:04Z (human): How do I use it? Am I suppoed to guess? What a incomtepentence fest.
72+
73+- 2026-11-08 15:09Z (agent): bin/site help now explains itself. Run make site, then bin/site help (or just bin/site). It shows every command, what it does, and two worked examples:
74+
75+ push a new repo: bin/site remote new my-thing
76+ git remote add origin sacenox@vm:/home/sacenox/repos/www-xonecas-io/repos/xonecas.io/my-thing.git
77+ git push -u origin main (each push rebuilds public/)
78+ show a repo: bin/site remote add ~/code/other-thing && bin/site index && bin/site build
79+ see it: make serve, open http://vm:8080
80+
81+ bin/site <command> -h adds that command's flags. Code: cmd/site/help.go, called from main.go.
82+ Checked from scratch in a temp site folder: remote new, two pushes, the hook rebuilt public/, the home page lists my-thing, /projects/my-thing/ returns 200, and git clone over HTTP from the served site gives both commits. go vet and go test pass. Temp files removed.
83+ Not checked: a push over real SSH from your host (I can't add a key here). Still true: this VM is recreated, so a repo made with remote new here is lost on reset.