@kitnai/cli 0.1.31 → 0.1.33

package/README.md

@@ -235,7 +235,65 @@ Generate or regenerate AI coding assistant rules files (e.g. `AGENTS.md`, `.curs
 kitn rules
 ```
 
-Fetches the latest rules template from the registry and writes files for each AI tool selected during `kitn init`. If no `aiTools` selection exists in `kitn.json`, prompts for one.
+Prompts you to select which AI coding tools you use, then fetches the latest rules template from the registry and generates the corresponding files. Works in any directory — uses project aliases from `kitn.json` if available, otherwise uses defaults.
+
+### `kitn chat <message>`
+
+AI-powered scaffolding assistant. Describe what you need in plain English and the assistant will generate a plan to add, create, link, or remove components.
+
+```bash
+# Basic usage
+kitn chat "I want a weather agent with a tool"
+
+# Override the chat service URL
+kitn chat "add a calculator tool" --url http://localhost:4002
+```
+
+**Flags:**
+
+| Flag | Description |
+|------|-------------|
+| `--url <url>` | Chat service URL (overrides config and default) |
+
+The chat service URL is resolved in this order:
+1. `--url` flag
+2. `KITN_CHAT_URL` environment variable
+3. User config (`~/.kitn/config.json` `chat-url` key)
+4. Project config (`kitn.json` `chatService.url`)
+5. Default: `https://chat.kitn.dev`
+
+### `kitn config`
+
+Manage user-level configuration stored at `~/.kitn/config.json`.
+
+```bash
+# Set a config value
+kitn config set chat-url https://chat.acme.com
+kitn config set api-key sk_my_secret_key
+
+# Get a config value
+kitn config get chat-url
+
+# List all config values
+kitn config list
+```
+
+**Subcommands:**
+
+| Subcommand | Description |
+|------------|-------------|
+| `set <key> <value>` | Set a config value |
+| `get <key>` | Get a config value |
+| `list` | List all config values |
+
+**Valid keys:**
+
+| Key | Description |
+|-----|-------------|
+| `chat-url` | Chat service URL for `kitn chat` |
+| `api-key` | API key for authenticated chat service requests |
+
+API key values are masked in output for security.
 
 ### `kitn build`
 
@@ -329,7 +387,6 @@ Created by `kitn init`. Controls where components are installed and which regist
 | `framework` | `hono` |
 | `aliases` | Directory paths for each component type |
 | `registries` | Named registries — each value is a URL string or an object with `url`, `homepage`, `description` |
-| `aiTools` | (optional) Selected AI coding tools for `kitn rules` — e.g. `["claude-code", "cursor"]` |
 
 > Installed component tracking (file paths, content hashes, versions) is stored separately in `kitn.lock`. This file is auto-managed — don't edit it manually.