juicyjuicy 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# juicyjuicy
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Publish browser games you make with Claude to [juicyjuicy.games](https://juicyjuicy.games), and get a link your friends can play.
+
+```bash
+npx juicyjuicy setup   # once: installs the Claude Code skill and logs you in (approve in the browser)
+```
+
+Then ask Claude: *"Publish this game to JuicyJuicy."* Or paste *"Run npx juicyjuicy setup, then publish this game to JuicyJuicy."* into Claude Code and skip the step above. Or do it yourself:
+
+```bash
+npx juicyjuicy publish   # upload and print the link (first time: logs in, writes juicy.json)
+npx juicyjuicy init      # create or edit juicy.json
+npx juicyjuicy check     # validate without uploading
+npx juicyjuicy list      # your games and their versions
+npx juicyjuicy open      # open the game page
+```
+
+Every command takes `--json` (one JSON object per line, the last one is the result) and `--yes` (never prompt). Exit codes: `0` ok, `1` fix the game or `juicy.json`, `2` log in, `3` network or server.
+
+Environment: `JUICY_TOKEN` (a token from juicyjuicy.games/settings/tokens, for CI) and `JUICY_API_URL` (another server, e.g. `http://localhost:3000`).
+
+Full guide: https://juicyjuicy.games/docs/publish