@kitnai/cli 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +55 -19
  2. package/dist/index.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -32,9 +32,10 @@ kitn init
32
32
 
33
33
  Prompts for:
34
34
  - **Runtime**: bun, node, or deno
35
- - **Alias directories**: Where each component type gets installed (defaults to `src/agents`, `src/tools`, `src/skills`, `src/storage`)
35
+ - **Framework**: hono, cloudflare, elysia, fastify, express
36
+ - **Install path**: Base directory for kitn components (defaults to `src/ai`)
36
37
 
37
- Also offers to install `@kitnai/hono` as a dependency.
38
+ Then run `kitn add core` to install the engine and `kitn add routes` for HTTP routes.
38
39
 
39
40
  ### `kitn add [components...]`
40
41
 
@@ -73,7 +74,7 @@ After installation, the CLI:
73
74
  List available and installed components from the registry.
74
75
 
75
76
  ```bash
76
- # List all components
77
+ # List all components from all registries
77
78
  kitn list
78
79
 
79
80
  # Only show installed components
@@ -81,6 +82,9 @@ kitn list --installed
81
82
 
82
83
  # Filter by type
83
84
  kitn list --type tool
85
+
86
+ # Filter by registry
87
+ kitn list --registry @myteam
84
88
  ```
85
89
 
86
90
  **Flags:**
@@ -88,7 +92,10 @@ kitn list --type tool
88
92
  | Flag | Description |
89
93
  |------|-------------|
90
94
  | `-i, --installed` | Only show installed components |
91
- | `-t, --type <type>` | Filter by type (`agent`, `tool`, `skill`, `storage`) |
95
+ | `-t, --type <type>` | Filter by type (`agent`, `tool`, `skill`, `storage`, `package`) |
96
+ | `-r, --registry <namespace>` | Only show components from this registry |
97
+
98
+ Shows installed version, latest registry version, and an update indicator when a newer version is available.
92
99
 
93
100
  ### `kitn diff <component>`
94
101
 
@@ -124,6 +131,39 @@ kitn update
124
131
 
125
132
  This re-fetches components from the registry and applies the same conflict resolution as `kitn add --overwrite`.
126
133
 
134
+ ### `kitn info <component>`
135
+
136
+ Show details about a component from the registry.
137
+
138
+ ```bash
139
+ kitn info weather-agent
140
+ ```
141
+
142
+ Displays the component's description, type, version, dependencies, files, and changelog.
143
+
144
+ ### `kitn registry`
145
+
146
+ Manage component registries.
147
+
148
+ ```bash
149
+ # Add a custom registry
150
+ kitn registry add @myteam https://registry.myteam.dev/r/{type}/{name}.json
151
+
152
+ # List configured registries
153
+ kitn registry list
154
+
155
+ # Remove a registry
156
+ kitn registry remove @myteam
157
+ ```
158
+
159
+ **Subcommands:**
160
+
161
+ | Subcommand | Description |
162
+ |------------|-------------|
163
+ | `add <namespace> <url>` | Add a registry (`-o` to overwrite) |
164
+ | `list` | List all configured registries |
165
+ | `remove <namespace>` | Remove a registry (`-f` to remove `@kitn`) |
166
+
127
167
  ## Configuration
128
168
 
129
169
  ### `kitn.json`
@@ -134,11 +174,13 @@ Created by `kitn init`. Controls where components are installed and which regist
134
174
  {
135
175
  "$schema": "https://kitn.dev/schema/config.json",
136
176
  "runtime": "bun",
177
+ "framework": "hono",
137
178
  "aliases": {
138
- "agents": "src/agents",
139
- "tools": "src/tools",
140
- "skills": "src/skills",
141
- "storage": "src/storage"
179
+ "base": "src/ai",
180
+ "agents": "src/ai/agents",
181
+ "tools": "src/ai/tools",
182
+ "skills": "src/ai/skills",
183
+ "storage": "src/ai/storage"
142
184
  },
143
185
  "registries": {
144
186
  "@kitn": "https://kitn-ai.github.io/registry/r/{type}/{name}.json"
@@ -149,26 +191,20 @@ Created by `kitn init`. Controls where components are installed and which regist
149
191
  | Field | Description |
150
192
  |-------|-------------|
151
193
  | `runtime` | `bun`, `node`, or `deno` |
194
+ | `framework` | `hono`, `cloudflare`, `elysia`, `fastify`, or `express` |
152
195
  | `aliases` | Directory paths for each component type |
153
196
  | `registries` | Named registries with URL templates |
154
197
  | `installed` | Auto-managed tracking of installed components (don't edit manually) |
155
198
 
156
199
  ### Custom Registries
157
200
 
158
- Add custom registries alongside or instead of the default:
201
+ Add custom registries via the CLI or by editing `kitn.json` directly:
159
202
 
160
- ```json
161
- {
162
- "registries": {
163
- "@kitn": "https://kitn-ai.github.io/registry/r/{type}/{name}.json",
164
- "@myteam": "https://registry.myteam.dev/r/{type}/{name}.json"
165
- }
166
- }
203
+ ```bash
204
+ kitn registry add @myteam https://registry.myteam.dev/r/{type}/{name}.json
167
205
  ```
168
206
 
169
- The URL template uses `{type}` and `{name}` placeholders. Components are fetched by replacing these with the component's type directory (`agents`, `tools`, `skills`, `storage`) and name.
170
-
171
- The registry index is fetched by replacing `{type}/{name}.json` with `registry.json` in the URL template.
207
+ The URL template uses `{type}` and `{name}` placeholders. Components are fetched by replacing these with the component's type directory (`agents`, `tools`, `skills`, `storage`) and name. The registry index is fetched by replacing `{type}/{name}.json` with `registry.json` in the URL template.
172
208
 
173
209
  ## Package Manager Detection
174
210
 
package/dist/index.js CHANGED
@@ -1319,7 +1319,7 @@ function startUpdateCheck(currentVersion) {
1319
1319
  }
1320
1320
 
1321
1321
  // src/index.ts
1322
- var VERSION = true ? "0.1.4" : "0.0.0-dev";
1322
+ var VERSION = true ? "0.1.5" : "0.0.0-dev";
1323
1323
  var printUpdateNotice = startUpdateCheck(VERSION);
1324
1324
  var program = new Command().name("kitn").description("Install AI agent components from the kitn registry").version(VERSION);
1325
1325
  program.command("init").description("Initialize kitn in your project").action(async () => {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kitnai/cli",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "type": "module",
5
5
  "description": "CLI for installing AI agent components from the kitn registry",
6
6
  "bin": {