evolutionary-arcade 0.0.1 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.1
+
+- Every game on Evolutionary Arcade is open source under MIT. `arcade publish` says so before it publishes, and refuses an `arcade.json` whose `license` is anything but `"MIT"` (leaving it out means MIT).
+- `arcade new`, `fork`, `blend`, and `regen` write a `LICENSE` in your name. A fork keeps its parent's LICENSE under `licenses/<slug>/`, and `pull` and `blend` add the creator's LICENSE to a download that has none. If you weren't logged in yet, `arcade publish` puts your handle in.
+- `arcade publish` stops on a license file at the top of the folder (`LICENSE`, `COPYING`, and the like) that isn't MIT. The arcade checks the same thing when it receives a publish.
+- The package no longer links to a source repository. Questions and bug reports: hello@evolutionaryarcade.com.
+
+## 0.1.0
+
+- First release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Evolutionary Arcade
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,84 @@
-# Evolutionary Arcade
+<p align="center"><img src="https://evolutionaryarcade.com/brand/readme-banner.jpg" width="640" alt="Evolutionary Arcade"></p>
 
-Coming soon. This placeholder reserves the package name for the Evolutionary Arcade creator CLI. It does not contain a working CLI yet.
+# evolutionary-arcade
+
+The `arcade` CLI for [Evolutionary Arcade](https://evolutionaryarcade.com), an arcade of open-source, AI-made browser games. Publish, update, regen, fork, and blend games with your own coding agent.
+
+## Quickstart
+
+```bash
+npm i -g evolutionary-arcade
+arcade skills install      # give your coding agent the four arcade skills
+arcade login               # approve a code in your browser
+arcade fork starwake       # start your own game from Starwake
+cd starwake-remix
+arcade dev                 # play it locally, under the arcade's rules
+arcade publish --dry-run   # see exactly what will go public
+arcade publish --yes       # and it's live
+```
+
+## Hand it to your agent
+
+The CLI is built for coding agents like Claude Code and Codex. Paste this in:
+
+```text
+Run `arcade guide` and follow it to fork starwake into a new game. Show me the dry run before you publish.
+```
+
+`arcade guide` prints the getting-started skill. `arcade skills install` puts all four skills (getting started, building games, remix and blend, publishing) where your agent looks for them.
+
+## Four ways to build on a game
+
+- **Update** your own game: `arcade pull <slug>`, make it better, `arcade publish`. Players get v2 at the same address.
+- **Regen** a game: `arcade regen <slug>` hands you its prompt and no code, so your model makes its own take. It joins that version's stack, next to the other takes.
+- **Fork** a game: `arcade fork <slug>` starts a new game of yours from someone's code, and its page links back to where it came from.
+- **Blend** games: `arcade blend <a> <b>` puts 2 to 8 games in one folder for your agent to combine into one new game.
+
+Everything you publish is public, including the source, and every game is open source under the MIT license. `arcade new`, `fork`, `blend`, and `regen` write a `LICENSE` in your name, and a fork keeps its parent's under `licenses/<slug>/`. Code or assets you bundle from others keep their own license and must be yours to share. The CLI never uploads `.env` files, keys, `.git`, or `node_modules`, and it stops if a file looks like it holds an API key.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `arcade guide` | Prints the getting-started skill. Agents read this first. |
+| `arcade skills install [--target claude\|codex\|all] [--dir <path>]` | Copies the four skills into `~/.claude/skills` and/or `~/.agents/skills`. |
+| `arcade login` / `arcade logout` / `arcade whoami` | Sign in with a device code, sign out, or see who you are. |
+| `arcade search <query>` | Find games by title, slug, @handle, or model. |
+| `arcade info <slug>` | A game's versions, generation ids, which one is main, and its parents. |
+| `arcade new <slug> [dir]` | Start a new game folder. |
+| `arcade dev [dir] [--port 5173] [--host]` | Serve your game locally with the arcade's CSP, so outside network calls fail early. |
+| `arcade pull <slug> [dir]` | Download your own game to make its next version. |
+| `arcade fork <slug> [dir]` | Download someone's game as the start of your new one. |
+| `arcade blend <slug> <slug> [...] [--into <dir>]` | Download 2 to 8 games to blend into one. |
+| `arcade regen <slug> [dir]` | Get a game's prompt, and no code, to build a fresh take. |
+| `arcade publish [dir] [--dry-run] [--yes]` | Check everything, list every file that goes public, and publish. |
+| `arcade media preview [dir]` | Make the 12-second hover preview from your demo (needs ffmpeg). |
+| `arcade main <slug> <generation>` | (Owner) Pick the main generation for a version. |
+| `arcade unpublish <slug>` / `arcade republish <slug>` | (Owner) Take your game down, or bring it back. |
+| `arcade profile show` / `set` / `avatar` / `banner` | See and edit your public profile. |
+
+When `arcade.json` has no token counts, `arcade publish` fills them in from your local Claude Code session logs, uploading only the numbers (`--no-stats` skips it). Subagent token counts aren't recorded reliably, so only the orchestrator's tokens are filled in. Subagents are listed by model and count.
+
+`arcade --help` and `arcade <command> --help` have every option. `--json` works on `whoami`, `info`, `search`, `publish`, and `profile show`.
+
+## Requirements
+
+- Node.js 20 or newer.
+- [ffmpeg](https://ffmpeg.org) (optional) for hover previews. Without it, cards show your thumbnail.
+
+## Settings, login, and exit codes
+
+- `ARCADE_API_URL` points the CLI at another arcade (default `https://evolutionaryarcade.com`).
+- `ARCADE_TOKEN` uses a token instead of the saved login, for CI.
+- `ARCADE_DEBUG=1` prints the full error when something unexpected breaks.
+- `arcade login` saves your token in `~/.config/evolutionary-arcade/credentials.json` (or under `$XDG_CONFIG_HOME`), readable only by you. Logins last 90 days.
+- Exit codes: `0` it worked, `1` something went wrong, `2` something in `arcade.json`, the files, or the options needs fixing (every problem is listed).
+
+## Links
+
+- Play and publish: [evolutionaryarcade.com](https://evolutionaryarcade.com)
+- Publishing guide: [evolutionaryarcade.com/publish](https://evolutionaryarcade.com/publish)
+- Discord: [evolutionaryarcade.com/discord](https://evolutionaryarcade.com/discord)
+- Questions and bug reports: [hello@evolutionaryarcade.com](mailto:hello@evolutionaryarcade.com)
+
+The CLI is MIT licensed, like every game published with it.