@standardagents/cli 0.14.1 → 0.15.2

package/README.md

@@ -10,26 +10,66 @@ pnpm add -D @standardagents/cli
 
 ## Usage
 
-### Initialize AgentBuilder Configuration
+### Create And Connect A Project
 
 ```bash
-pnpm exec agents init
+npx @standardagents/cli@latest init
 ```
 
+The package is published publicly so this one-liner works without a prior npm
+login.
+
 This command will:
-- Detect your `wrangler.jsonc` or `wrangler.json` file
-- Add the required Durable Object bindings (`AGENT_BUILDER_THREAD`, `AGENT_BUILDER`)
-- Configure Durable Object migrations
+- Open Standard Agents in your browser for GitHub sign-in, billing, GitHub App setup, and repo creation
+- Clone the created private GitHub repo into the directory where you ran the command
+- Write `STANDARD_AGENTS_API_KEY`, `PLATFORM_ENDPOINT`, and `STANDARD_AGENTS_API_URL` to `.dev.vars`
+- Install dependencies with the detected package manager, start the local dev server, and open the local instance
 
-For new projects, `agents init` also normalizes the scaffolded Vite,
-TypeScript, Cloudflare Vite plugin, Wrangler version, and Cloudflare
-compatibility date to the set tested with the current Standard Agents release.
+For local platform development, point the same command at your local platform API:
 
-If no wrangler config is found, it will provide an example configuration.
+```bash
+STANDARD_AGENTS_API_URL=https://platform.agentbuilder-platform.orb.local pnpm exec agents init
+```
+
+When testing unreleased workspace package changes, keep the same platform flow
+and add `STANDARDAGENTS_WORKSPACE=1`. With `pnpm`, the CLI rewrites the cloned
+project's generated `@standardagents/*` dependencies to local workspace links
+before installing. If you are running a packed or globally installed local CLI,
+also set `STANDARDAGENTS_WORKSPACE_ROOT` to the monorepo root:
+
+```bash
+STANDARDAGENTS_WORKSPACE=1 STANDARD_AGENTS_API_URL=https://platform.agentbuilder-platform.orb.local pnpm exec agents init
+STANDARDAGENTS_WORKSPACE=1 STANDARDAGENTS_WORKSPACE_ROOT=/path/to/agentbuilder STANDARD_AGENTS_API_URL=https://platform.agentbuilder-platform.orb.local cli init
+```
+
+From the monorepo root, `pnpm onboarding:verify:local` runs both no-publish
+verification modes against a fake platform API: the pnpm workspace-dev path and
+a local-registry run of the literal `npx @standardagents/cli@latest init` shape
+that serves locally packed packages in place of the unpublished npm registry
+packages. Use `-- --mode=workspace` or `-- --mode=npx` when you only need one
+side.
+
+After the GitHub publish workflow completes, run
+`pnpm onboarding:verify:production` to exercise the real production one-liner
+against the npm registry without touching GitHub, Stripe, or the production
+platform. It runs `npx @standardagents/cli@latest init` against a fake platform
+API and requires the generated project to install `@standardagents/*` packages
+from npm. The publish workflow also runs this verifier after `publish-cli`.
+All Standard Agents package publishes must go through that workflow. The
+workflow publishes with public access, repairs package visibility if a scoped
+version already exists, sets the release dist-tag, and then runs the production
+onboarding verifier. Do not run manual npm publishes to test this flow.
+
+Use `agents init --local my-agent-project` for the legacy local-only template scaffold that does not create a platform repo or billing connection.
 
 #### Options
 
-- `--force` - Overwrite existing Standard Agents configuration
+- `-y, --yes` - Skip prompts and use defaults
+- `--api-url <url>` - Platform API URL. Also available through `STANDARD_AGENTS_API_URL` or `PLATFORM_ENDPOINT`
+- `--package-manager <manager>` - Override package manager detection (`npm`, `pnpm`, `yarn`, or `bun`)
+- `--local` - Use the legacy local-only scaffold flow
+
+Set `STANDARD_AGENTS_BROWSER="Google Chrome"` or another macOS browser app name when you need the browser handoff to use a specific browser during local development. Set `STANDARD_AGENTS_BROWSER=none` for headless verification.
 
 ### Scaffold Project Structure
 
@@ -37,7 +77,11 @@ If no wrangler config is found, it will provide an example configuration.
 pnpm exec agents scaffold
 ```
 
-Creates the `agents/` directory structure with documentation files.
+Adds Standard Agents to an existing Vite project. The command updates
+`package.json` with the current `@standardagents/builder` and
+`@cloudflare/vite-plugin` versions, wires the Vite and Wrangler config, creates
+the Worker entry point, and creates the `agents/` directory structure with
+documentation files.
 
 ### Install The AgentBuilder Skill