create-dynamicagents 0.1.0 → 0.2.0

package/README.md

@@ -7,7 +7,70 @@ Create gates, leaders and agents on
 npm create dynamicagents@latest
 ```
 
-For now it only says hello; scaffolding comes next. Requires Node 24 or later.
+It asks what you want to build. **Agent** writes a complete, deployable project:
+one agent in a Cloudflare Worker of its own, with its own wrangler config,
+bindings, migration tag and signing key, reached over A2A as its own tenant.
+Gates and leaders are a work in progress; follow them at
+[dynamicagents.dev](https://dynamicagents.dev).
+
+Requires Node 24 or later, and a **paid Cloudflare Workers plan**: the models a
+generated agent runs on are not served on the free tier, and neither is Browser
+Rendering. There is no free-tier path.
+
+The CLI itself has no dependencies: `npm create` downloads one package, runs it,
+and the only install it then does is the one for the project it wrote.
+
+## What you get
+
+```
+support/
+  src/agents/support/   the agent: its soul, plugins, sub-agent, card, pipeline
+  src/index.ts          one Worker, this agent mounted as the tenant `support`
+  wrangler.jsonc        its own bindings, its own migration v1
+  test/                 the A2A lifecycle on a scripted model, and the edge
+```
+
+Then `npm run keygen`, fill in `.env`, and `npm run deploy`. The generated
+`README.md` carries the rest, and its `AGENTS.md` carries the rules — including
+how to bring a second generated agent into the same Worker later.
+
+## Answering without the questions
+
+```bash
+npm create dynamicagents@latest agent generic support -- \
+  --name support --description "Answers product questions" --yes
+```
+
+The `--` is npm's, not ours: without it, npm keeps the flags for itself.
+
+| flag            | what it answers                                                        |
+| --------------- | ---------------------------------------------------------------------- |
+| `--name`        | The tenant id. Every class, binding and workflow name derives from it. |
+| `--description` | One line for the card, and the first line of the soul.                 |
+| `--dir`         | Where to write it. Defaults to the name.                               |
+| `--model`       | A Workers AI model id. Defaults to one that calls tools reliably.      |
+| `--no-subagent` | Leave out the sub-agent it hands research to.                          |
+| `--browser`     | Install the browser plugin, its binding and its skill.                 |
+| `--yes`         | Do not ask for confirmation.                                           |
+| `--dry-run`     | Print what would be written, and write nothing.                        |
+| `--help`        | Usage, both ways in, and every flag. Also `-h`.                        |
+| `--version`     | The version that would run. Also `-v`.                                 |
+
+The directory may already exist as long as it is empty. These do not count as
+content, so a repository you made with `git init` first is fine, as is one an
+editor or Finder has already touched:
+
+`.git` · `.hg` · `.svn` · `.gitkeep` · `.keep` · `.idea` · `.vscode` ·
+`.DS_Store` · `Thumbs.db` · `desktop.ini`
+
+The project is written around them: nothing of yours is moved or removed.
+Anything else in there and it asks you for a different directory.
+
+A usable answer given up front is not asked for. One that will not do — a tenant
+id that could not become a class name, a model id that is not one — is said
+where it was given rather than after every other question: the question comes
+back with the value in it where there is a terminal, and the run stops naming
+the flag where there is not.
 
 ## License