@kitnai/cli 0.1.16 → 0.1.18

package/README.md

@@ -27,14 +27,27 @@ pnpm dlx @kitnai/cli init
 Initialize kitn in your project. Creates `kitn.json`, installs the core engine and Hono routes, and sets up tsconfig path aliases.
 
 ```bash
+# Interactive (prompts for runtime and base directory)
 kitn init
+
+# Non-interactive with flags
+kitn init --runtime bun --base src/ai
+
+# Accept all defaults (runtime=bun, base=src/ai)
+kitn init -y
 ```
 
-Prompts for:
-- **Runtime**: bun, node, or deno
-- **Install path**: Base directory for kitn components (defaults to `src/ai`)
+**Flags:**
+
+| Flag | Description |
+|------|-------------|
+| `-r, --runtime <runtime>` | Runtime to use (`bun`, `node`, `deno`) — skips runtime prompt |
+| `-b, --base <path>` | Base directory for components (default: `src/ai`) — skips path prompt |
+| `-y, --yes` | Accept all defaults without prompting |
 
-After answering, the CLI automatically installs the core engine and HTTP routes into your project.
+When flags are provided, the corresponding prompts are skipped. This enables scripting and CI usage.
+
+After setup, the CLI automatically installs the core engine and HTTP routes into your project.
 
 ### `kitn add [components...]`
 
@@ -56,12 +69,18 @@ kitn add weather-agent@1.2.0
 # Overwrite existing files without prompting
 kitn add weather-agent --overwrite
 
-# Filter interactive selection by type
-kitn add --type agent
+# Type-first syntax — specify the type before the name
+kitn add agent weather
+kitn add tool weather
+
+# Filter by type with the --type flag
+kitn add --type agent weather
 ```
 
 Components from the default `@kitn` registry don't need a namespace prefix. Components from other registries use `@namespace/name` format.
 
+When multiple components share the same name but differ in type (e.g., a `weather` agent and a `weather` tool), you'll be prompted to choose which to install. Use the type-first syntax or `--type` flag to skip the prompt.
+
 Third-party components install into a namespace subdirectory (e.g. `src/ai/agents/acme/custom-agent.ts`).
 
 **Flags:**
@@ -69,7 +88,7 @@ Third-party components install into a namespace subdirectory (e.g. `src/ai/agent
 | Flag | Description |
 |------|-------------|
 | `-o, --overwrite` | Overwrite existing files without prompting |
-| `-t, --type <type>` | Filter components by type when browsing |
+| `-t, --type <type>` | Filter by component type during resolution |
 
 When a file already exists and differs from the registry version, you'll see a unified diff and be prompted to keep your version or overwrite.
 
@@ -180,6 +199,16 @@ kitn build
 kitn build src/components --output dist/r
 ```
 
+### `kitn check`
+
+Check for CLI updates.
+
+```bash
+kitn check
+```
+
+Shows the current version and whether a newer version is available on npm.
+
 ### `kitn registry`
 
 Manage component registries.