@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.
- package/README.md +55 -19
- package/dist/index.js +1 -1
- 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
|
-
- **
|
|
35
|
+
- **Framework**: hono, cloudflare, elysia, fastify, express
|
|
36
|
+
- **Install path**: Base directory for kitn components (defaults to `src/ai`)
|
|
36
37
|
|
|
37
|
-
|
|
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
|
-
"
|
|
139
|
-
"
|
|
140
|
-
"
|
|
141
|
-
"
|
|
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
|
|
201
|
+
Add custom registries via the CLI or by editing `kitn.json` directly:
|
|
159
202
|
|
|
160
|
-
```
|
|
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.
|
|
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 () => {
|