@opentiny/tiny-robot-cli 0.5.2-alpha.13 → 0.5.2-alpha.14

package/README.md

@@ -7,22 +7,49 @@ A lightweight CLI for scaffolding TinyRobot-based product projects.
 ```bash
 npx @opentiny/tiny-robot-cli create my-app
 pnpm dlx @opentiny/tiny-robot-cli create my-app
-npx @opentiny/tiny-robot-cli add chat
+npx @opentiny/tiny-robot-cli add chat --yes
 ```
 
 ## Options
 
-- `-t, --template <name>`: template name, currently supports `basic`
+- `-t, --template <name>`: template name; `basic` generates the Chat Basic project
 - `-h, --help`: show help
 
-`add chat` adds a self-contained floating Chat component, including its runtime, UI configuration, composables, component-scoped styles, and supporting components. It updates these OpenTiny dependencies to `0.5.2-alpha.10`:
+`create` is an overall project scaffold. The `basic` template is aligned with `packages/chat-basic` and is copied into a new project.
+
+`add chat` is a local feature injection for an existing Vue project. It creates the isolated `src/tiny-robot-chat/` feature from `packages/cli/templates/chat`, adds the runtime dependencies (including `@vueuse/core`), and imports the feature CSS. It does not modify the host project's Vite configuration. Existing files with different contents are reported as conflicts and are never silently overwritten.
+
+By default, `add chat` mounts `TinyRobotChat` into a standard `src/App.vue` when a safe template and script setup block are available, so the generated project includes the floating AI trigger. Use `--no-mount` to keep `App.vue` unchanged and print the mount snippet. Use `--dry-run` to inspect the plan without changing files and `--yes` to skip prompts:
+
+```bash
+npx @opentiny/tiny-robot-cli add chat --dry-run
+npx @opentiny/tiny-robot-cli add chat --yes
+npx @opentiny/tiny-robot-cli add chat --yes --no-mount
+```
+
+The feature adds or preserves these dependencies. Compatible versions are kept, and higher versions are not downgraded:
 
 - `@opentiny/tiny-robot`
 - `@opentiny/tiny-robot-chat`
 - `@opentiny/tiny-robot-kit`
 - `@opentiny/tiny-robot-svgs`
-
-It also adds `@vueuse/core@13.9.0`. The command does not modify the application entry file or create `src/index.css`. Configure a private environment file from the generated `.env.example` before starting the project; the generated example only includes the Qwen and DeepSeek API key variables. Their API URL variables remain optional overrides for proxies, private gateways, or other regions. The CLI never creates or modifies `.env`.
+- `@vueuse/core`
+
+Copy the generated `.env.example` to `.env.local`, then configure the provider API URL and API key before starting the project. `add chat` does not create or modify `.env`.
+
+The Model Context MCP example uses `/modelcontextprotocol-mcp`. Add this proxy manually to the existing `vite.config.*` file under `server.proxy`, then restart Vite:
+
+```ts
+server: {
+  proxy: {
+    '/modelcontextprotocol-mcp': {
+      target: 'https://modelcontextprotocol.io/mcp',
+      changeOrigin: true,
+      rewrite: (path) => path.replace(/^\/modelcontextprotocol-mcp/, ''),
+    },
+  },
+},
+```
 
 ## Template Documentation