@ywldan/kiro 0.2.7 → 0.2.9

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 CHANGED
@@ -129,6 +129,15 @@ Key handling for `kiro model add`:
129
129
  - `--api-key-env <VAR>` with no key stores nothing; it references the variable, which must already be set in the environment or in `~/.kiro/.env`.
130
130
  - Omitting both creates a profile with no key, suitable for local servers.
131
131
 
132
+ ### Staying up to date
133
+
134
+ ```bash
135
+ kiro check # installed version vs the latest on npm
136
+ kiro update # npm install -g @ywldan/kiro@latest
137
+ ```
138
+
139
+ `check` exits `0` when current, `1` when an update is available, `2` when the registry cannot be reached. `update` shows the npm output and needs the same permissions as a global npm install.
140
+
132
141
  ### Where keys live
133
142
 
134
143
  The config file contains only `apiKeyEnv`, the *name* of a variable. Values live in the environment or in `~/.kiro/.env`:
@@ -241,6 +250,9 @@ kiro [options]
241
250
  --no-alt-screen Do not switch to the terminal's alternate screen
242
251
  -h, --help Show help
243
252
  -v, --version Show version
253
+
254
+ kiro check Compare the installed version with the latest on npm
255
+ kiro update Install the latest version from npm globally
244
256
  ```
245
257
 
246
258
  `--flag=value` works as well. CLI overrides last for the current process only.
@@ -320,6 +332,8 @@ Slash commands:
320
332
  | `/model list --remote` | List models offered by the active endpoint's `GET /models` |
321
333
  | `/context` | Show approximate context use by message role plus session token totals |
322
334
  | `/usage` | Show or hide the Usage card, giving the transcript the full width |
335
+ | `/skills` | List installed skills, their source, and any skipped entries |
336
+ | `/skill <name>` | Load a skill and apply its instructions to your next request |
323
337
  | `/compact` | Summarize older turns now, keeping the last four user turns verbatim |
324
338
  | `/sessions` | List saved sessions for this working directory |
325
339
  | `/resume <n\|id>` | Resume a session by list number or id (prefixes work) |
@@ -408,6 +422,30 @@ Checkpoints are best effort: if a snapshot cannot be taken, the tool still runs.
408
422
 
409
423
  If an `AGENTS.md` file exists in the working directory, its contents are appended to the system prompt for every turn, so project-specific instructions apply immediately, including after edits.
410
424
 
425
+ ## Skills
426
+
427
+ A skill is a folder of instructions that Kiro loads only when it is needed. Kiro looks in four places, in this order, and the first definition of a name wins:
428
+
429
+ 1. `<cwd>/.kiro/skills/`
430
+ 2. `<cwd>/.claude/skills/`, so skills installed for Claude Code work unchanged
431
+ 3. `~/.kiro/skills/`
432
+ 4. `~/.claude/skills/`
433
+
434
+ Each skill is a directory with a `SKILL.md`:
435
+
436
+ ```md
437
+ ---
438
+ name: anti-slop
439
+ description: Remove AI-slop patterns from prose before answering.
440
+ ---
441
+
442
+ Delete "delve", "tapestry", and stacked em dashes. Prefer concrete nouns.
443
+ ```
444
+
445
+ Only the name and description reach the system prompt (up to 30 skills, descriptions clipped at 300 characters). When a request matches, the model calls `read_skill` to load the body, so twenty installed skills cost a few hundred tokens instead of their full text. `read_skill` is read-only: it needs no approval and can run alongside other reads. Supporting files in the skill directory can be opened with `read_file` or run with `run_command`, which still goes through the usual approval.
446
+
447
+ `/skills` lists what was found, whether it came from the project or the user, and any skipped entry with the reason (missing description, duplicate name, oversized file). `/skill anti-slop` loads a skill immediately: the transcript shows a compact `/skill anti-slop` line while the model receives the full instructions. The index is rebuilt every turn, so edits to `SKILL.md` apply on the next message. Set `KIRO_SKILLS_DIR` to replace both user roots. A skill is instructions, not code, so it cannot bypass approvals.
448
+
411
449
  ## How it works
412
450
 
413
451
  - The OpenAI provider posts to `{baseUrl}/chat/completions` with `stream: true`, parses SSE incrementally, and assembles tool-call deltas by index. It also accepts a plain JSON response from servers that ignore streaming, and reads `usage` when the endpoint sends it.
@@ -442,7 +480,7 @@ The suite covers streaming, multiple tool calls per response, approvals and deni
442
480
 
443
481
  Model workflow tests use a temp `$HOME` so the real `~/.kiro` is never touched. They cover atomic config saves that preserve unknown fields, profile-name and URL validation, corrupt-config backup/recovery, `.env` parsing and real-environment precedence, `0600` writes, masking, the exact preset list, discovery success/401/missing-`/models`/timeout, the connection test, and wizard add/edit/select/remove/last-profile refusal/cancel/manual-model fallback. Scripted `kiro model add`, `list`, `use`, `test`, and `remove` run through the real CLI against the in-process mock; a failed test saves nothing, keys never appear in `config.json`, and generated keys land in `.env`. The wizard screen renderer is unit-tested against a fake stream: alternate-screen enter/leave, a new menu replacing the previous one, the breadcrumb of answered prompts (menu title instead of `Choose`, the value kept by pressing Enter, confirmation of a `Y/n` default, and the reset on Escape or a return to the root menu), stale errors dropped at a step change, log trimming to the terminal height with the prompt always visible, keyboard scrolling of an over-long list (page, top, bottom, clamping, reset on new output), and replaying results after the screen is restored. `/model` groups profiles by endpoint so several models behind one base URL are listed as siblings.
444
482
 
445
- The newer paths have their own coverage: `max_completion_tokens` selection for reasoning models and recovery from a `max_tokens` rejection, `reasoning_content` deltas reaching the agent and collapsing in the renderer, the stream idle timeout, checkpoint edit/create undo with backup files outside the manifest, and prompt-history dedupe/capping/redaction. A spawned `kiro -p` test runs a tool with `--yolo`, checks the reply and saved session, feeds a piped prompt through `-p -`, and verifies the non-TTY hint without `-p`.
483
+ The newer paths have their own coverage: `max_completion_tokens` selection for reasoning models and recovery from a `max_tokens` rejection, `reasoning_content` deltas reaching the agent and collapsing in the renderer, the stream idle timeout, checkpoint edit/create undo with backup files outside the manifest, and prompt-history dedupe/capping/redaction. Skills are covered from the file to the model: frontmatter with quoted and continued values, CRLF input, `.kiro` overriding `.claude`, duplicate and invalid entries, an index in the system prompt that excludes the body, and the read-only `read_skill` tool. A spawned `kiro -p` test runs a tool with `--yolo`, checks the reply and saved session, feeds a piped prompt through `-p -`, and verifies the non-TTY hint without `-p`.
446
484
 
447
485
  ## Project layout
448
486
 
@@ -456,8 +494,8 @@ src/
456
494
  sessions.ts atomic session save/load/list
457
495
  model/ presets, discovery/test, context-window inference, shared wizard, CLI + screen renderer
458
496
  providers/ Provider interface, OpenAI-compatible implementation
459
- agent/ system prompt, agent loop, token estimates, compaction
460
- tools/ tool registry, fs/search/patch/shell tools, checkpoints, glob/gitignore matching
497
+ agent/ system prompt, skill discovery/parsing, agent loop, token estimates, compaction
498
+ tools/ tool registry, fs/search/patch/shell/skill tools, checkpoints, glob/gitignore matching
461
499
  ui/ Ink app, markdown, command palette, prompt history, scrolling, approvals, status bar, export
462
500
  test/
463
501
  mock-server.ts scripted OpenAI-compatible SSE server + /models variants
@@ -1,6 +1,7 @@
1
1
  import { readFile } from 'node:fs/promises';
2
2
  import { platform, release } from 'node:os';
3
3
  import path from 'node:path';
4
+ import { formatSkillIndex, loadSkills } from './skills.js';
4
5
  const MAX_AGENTS_MD_BYTES = 200_000;
5
6
  function osName() {
6
7
  switch (platform()) {
@@ -12,6 +13,21 @@ function osName() {
12
13
  return `${platform()} (${release()})`;
13
14
  }
14
15
  }
16
+ async function readAgentsSection(cwd) {
17
+ const agentsPath = path.join(cwd, 'AGENTS.md');
18
+ try {
19
+ const content = await readFile(agentsPath, 'utf8');
20
+ const clipped = content.length > MAX_AGENTS_MD_BYTES
21
+ ? content.slice(0, MAX_AGENTS_MD_BYTES) + '\n\n[AGENTS.md truncated by Kiro]'
22
+ : content;
23
+ return `# Project instructions from AGENTS.md\n\n${clipped.trimEnd()}`;
24
+ }
25
+ catch (error) {
26
+ if (error.code === 'ENOENT')
27
+ return '';
28
+ return `[Could not read AGENTS.md: ${error.message}]`;
29
+ }
30
+ }
15
31
  export async function buildSystemPrompt(cwd) {
16
32
  const base = [
17
33
  'You are Kiro, a terminal-based coding agent working in the user\'s current directory.',
@@ -36,18 +52,8 @@ export async function buildSystemPrompt(cwd) {
36
52
  '',
37
53
  'You have these tools: read_file, write_file, edit_file, multi_edit, apply_patch, list_dir, glob, grep, run_command.',
38
54
  ].join('\n');
39
- const agentsPath = path.join(cwd, 'AGENTS.md');
40
- try {
41
- const content = await readFile(agentsPath, 'utf8');
42
- const clipped = content.length > MAX_AGENTS_MD_BYTES
43
- ? content.slice(0, MAX_AGENTS_MD_BYTES) + '\n\n[AGENTS.md truncated by Kiro]'
44
- : content;
45
- return `${base}\n\n# Project instructions from AGENTS.md\n\n${clipped.trimEnd()}\n`;
46
- }
47
- catch (error) {
48
- if (error.code === 'ENOENT')
49
- return base;
50
- return `${base}\n\n[Could not read AGENTS.md: ${error.message}]\n`;
51
- }
55
+ const [agents, inventory] = await Promise.all([readAgentsSection(cwd), loadSkills(cwd)]);
56
+ const sections = [base, agents, formatSkillIndex(inventory.skills)].filter(Boolean);
57
+ return sections.length === 1 ? base : `${sections.join('\n\n')}\n`;
52
58
  }
53
59
  //# sourceMappingURL=prompt.js.map
@@ -0,0 +1,294 @@
1
+ import { readdir, readFile, stat } from 'node:fs/promises';
2
+ import { homedir } from 'node:os';
3
+ import path from 'node:path';
4
+ export const MAX_SKILLS_IN_PROMPT = 30;
5
+ export const MAX_SKILL_DESCRIPTION_CHARS = 300;
6
+ export const MAX_SKILL_BODY_CHARS = 50_000;
7
+ export const MAX_SKILL_FILE_BYTES = 200_000;
8
+ export const MAX_SKILLS_INDEX_CHARS = 8_000;
9
+ const MAX_SKILL_NAME_CHARS = 64;
10
+ const SKILL_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
11
+ /** `.claude/skills` is read too, so skills installed for other CLIs work unchanged. */
12
+ export function skillRoots(cwd) {
13
+ const roots = [
14
+ { root: path.join(cwd, '.kiro', 'skills'), source: 'project' },
15
+ { root: path.join(cwd, '.claude', 'skills'), source: 'project' },
16
+ ];
17
+ const override = process.env.KIRO_SKILLS_DIR?.trim();
18
+ if (override) {
19
+ roots.push({ root: path.resolve(override), source: 'user' });
20
+ }
21
+ else {
22
+ const home = homedir();
23
+ roots.push({ root: path.join(home, '.kiro', 'skills'), source: 'user' });
24
+ roots.push({ root: path.join(home, '.claude', 'skills'), source: 'user' });
25
+ }
26
+ const seen = new Set();
27
+ return roots.filter(({ root }) => {
28
+ if (seen.has(root))
29
+ return false;
30
+ seen.add(root);
31
+ return true;
32
+ });
33
+ }
34
+ function cleanValue(raw) {
35
+ const value = raw.trim();
36
+ if (value.length >= 2) {
37
+ const first = value[0];
38
+ const last = value[value.length - 1];
39
+ if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
40
+ return value.slice(1, -1).trim();
41
+ }
42
+ }
43
+ return value;
44
+ }
45
+ /** Reads the simple `key: value` frontmatter skills use; nested YAML is ignored. */
46
+ function parseMeta(lines) {
47
+ const meta = new Map();
48
+ let key = null;
49
+ let continuation = [];
50
+ const commit = () => {
51
+ if (key !== null && continuation.length > 0)
52
+ meta.set(key, cleanValue(continuation.join(' ')));
53
+ key = null;
54
+ continuation = [];
55
+ };
56
+ for (const line of lines) {
57
+ const match = /^([A-Za-z][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(line);
58
+ if (match) {
59
+ commit();
60
+ const name = match[1].toLowerCase();
61
+ const value = (match[2] ?? '').trim();
62
+ const quote = value[0];
63
+ const quotedOpen = (quote === '"' || quote === "'") &&
64
+ !(value.length > 1 && value.endsWith(quote));
65
+ if (value === '' || /^[>|][+-]?$/.test(value) || quotedOpen) {
66
+ key = name;
67
+ continuation = value === '' || /^[>|][+-]?$/.test(value) ? [] : [value];
68
+ }
69
+ else {
70
+ meta.set(name, cleanValue(value));
71
+ }
72
+ continue;
73
+ }
74
+ if (key !== null && /^\s+\S/.test(line)) {
75
+ continuation.push(line.trim());
76
+ continue;
77
+ }
78
+ commit();
79
+ }
80
+ commit();
81
+ return meta;
82
+ }
83
+ export function parseSkillFile(raw) {
84
+ const text = raw.replace(/^\uFEFF/, '').replace(/\r\n?/g, '\n');
85
+ const lines = text.split('\n');
86
+ if (lines[0]?.trim() !== '---') {
87
+ return { ok: false, reason: 'missing frontmatter: the file must start with ---' };
88
+ }
89
+ let close = -1;
90
+ for (let index = 1; index < lines.length; index++) {
91
+ if (lines[index]?.trim() === '---') {
92
+ close = index;
93
+ break;
94
+ }
95
+ }
96
+ if (close === -1)
97
+ return { ok: false, reason: 'unterminated frontmatter block' };
98
+ const meta = parseMeta(lines.slice(1, close));
99
+ const description = (meta.get('description') ?? '').replace(/\s+/g, ' ').trim();
100
+ if (!description)
101
+ return { ok: false, reason: 'frontmatter is missing a description' };
102
+ const body = lines.slice(close + 1).join('\n').trim();
103
+ if (!body)
104
+ return { ok: false, reason: 'the skill has no instructions after the frontmatter' };
105
+ return {
106
+ ok: true,
107
+ value: { name: meta.get('name')?.trim() || undefined, description, body },
108
+ };
109
+ }
110
+ async function readSkillDir(root, source, entry) {
111
+ const file = path.join(root, entry, 'SKILL.md');
112
+ let info;
113
+ try {
114
+ info = await stat(file);
115
+ }
116
+ catch (error) {
117
+ const code = error.code;
118
+ if (code === 'ENOENT' || code === 'ENOTDIR')
119
+ return {};
120
+ return { invalid: { name: entry, file, reason: error.message } };
121
+ }
122
+ if (!info.isFile())
123
+ return {};
124
+ if (info.size > MAX_SKILL_FILE_BYTES) {
125
+ return {
126
+ invalid: {
127
+ name: entry,
128
+ file,
129
+ reason: `SKILL.md is larger than ${MAX_SKILL_FILE_BYTES.toLocaleString()} bytes`,
130
+ },
131
+ };
132
+ }
133
+ let raw;
134
+ try {
135
+ raw = await readFile(file, 'utf8');
136
+ }
137
+ catch (error) {
138
+ return { invalid: { name: entry, file, reason: error.message } };
139
+ }
140
+ const parsed = parseSkillFile(raw);
141
+ if (!parsed.ok)
142
+ return { invalid: { name: entry, file, reason: parsed.reason } };
143
+ const name = parsed.value.name ?? entry;
144
+ if (name.length > MAX_SKILL_NAME_CHARS || !SKILL_NAME_PATTERN.test(name)) {
145
+ return {
146
+ invalid: {
147
+ name,
148
+ file,
149
+ reason: 'the name may only contain letters, digits, dots, dashes, and underscores',
150
+ },
151
+ };
152
+ }
153
+ return {
154
+ skill: {
155
+ name,
156
+ description: parsed.value.description,
157
+ body: parsed.value.body,
158
+ dir: path.join(root, entry),
159
+ file,
160
+ },
161
+ };
162
+ }
163
+ /** Project roots win over user roots; the first definition of a name is kept. */
164
+ export async function loadSkills(cwd) {
165
+ const roots = skillRoots(cwd);
166
+ const skills = [];
167
+ const invalid = [];
168
+ const byName = new Map();
169
+ for (const { root, source } of roots) {
170
+ let entries;
171
+ try {
172
+ entries = await readdir(root, { withFileTypes: true });
173
+ }
174
+ catch (error) {
175
+ const code = error.code;
176
+ if (code !== 'ENOENT' && code !== 'ENOTDIR') {
177
+ invalid.push({
178
+ name: path.basename(root),
179
+ file: root,
180
+ source,
181
+ reason: `cannot read the directory: ${error.message}`,
182
+ });
183
+ }
184
+ continue;
185
+ }
186
+ const names = entries
187
+ .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
188
+ .map((entry) => entry.name)
189
+ .sort((a, b) => a.localeCompare(b, 'en'));
190
+ for (const entryName of names) {
191
+ const result = await readSkillDir(root, source, entryName);
192
+ if (result.invalid) {
193
+ invalid.push({ ...result.invalid, source });
194
+ continue;
195
+ }
196
+ const skill = result.skill;
197
+ if (!skill)
198
+ continue;
199
+ const existing = byName.get(skill.name.toLowerCase());
200
+ if (existing) {
201
+ invalid.push({
202
+ name: skill.name,
203
+ file: skill.file,
204
+ source,
205
+ reason: `duplicate name; ${existing.file} already defines it`,
206
+ });
207
+ continue;
208
+ }
209
+ const complete = { ...skill, source };
210
+ skills.push(complete);
211
+ byName.set(skill.name.toLowerCase(), complete);
212
+ }
213
+ }
214
+ skills.sort((a, b) => a.name.localeCompare(b.name, 'en'));
215
+ return { skills, invalid, roots: roots.map(({ root }) => root) };
216
+ }
217
+ export function findSkill(skills, name) {
218
+ const needle = name.trim().toLowerCase();
219
+ return skills.find((skill) => skill.name.toLowerCase() === needle);
220
+ }
221
+ export function shortPath(target, cwd) {
222
+ const relative = path.relative(cwd, target);
223
+ if (relative === '')
224
+ return '.';
225
+ if (!relative.startsWith('..') && !path.isAbsolute(relative))
226
+ return relative;
227
+ const home = homedir();
228
+ if (target === home)
229
+ return '~';
230
+ if (target.startsWith(`${home}${path.sep}`))
231
+ return `~${target.slice(home.length)}`;
232
+ return target;
233
+ }
234
+ function clipDescription(description, max) {
235
+ return description.length > max ? `${description.slice(0, max - 1)}…` : description;
236
+ }
237
+ /** Name and description only; the body stays on disk until read_skill loads it. */
238
+ export function formatSkillIndex(skills) {
239
+ if (skills.length === 0)
240
+ return '';
241
+ const lines = [
242
+ '# Skills',
243
+ 'Installed skills extend how you work. When a request matches one, call the read_skill tool with the exact name first and follow the instructions it returns. Do not guess what a skill contains.',
244
+ ];
245
+ let used = lines.join('\n').length;
246
+ let shown = 0;
247
+ for (const skill of skills.slice(0, MAX_SKILLS_IN_PROMPT)) {
248
+ const line = `- ${skill.name}: ${clipDescription(skill.description, MAX_SKILL_DESCRIPTION_CHARS)}`;
249
+ if (shown > 0 && used + line.length + 1 > MAX_SKILLS_INDEX_CHARS)
250
+ break;
251
+ lines.push(line);
252
+ used += line.length + 1;
253
+ shown++;
254
+ }
255
+ const hidden = skills.length - shown;
256
+ if (hidden > 0)
257
+ lines.push(`(${hidden} more installed; run /skills to list all.)`);
258
+ return lines.join('\n');
259
+ }
260
+ export function formatSkillList(inventory, cwd) {
261
+ const lines = [];
262
+ if (inventory.skills.length === 0) {
263
+ lines.push('No skills installed.');
264
+ }
265
+ else {
266
+ const project = inventory.skills.filter((skill) => skill.source === 'project').length;
267
+ const user = inventory.skills.length - project;
268
+ const counts = [project > 0 ? `${project} project` : '', user > 0 ? `${user} user` : '']
269
+ .filter(Boolean)
270
+ .join(', ');
271
+ lines.push(`Installed skills (${counts}):`);
272
+ const width = Math.min(28, Math.max(...inventory.skills.map((skill) => skill.name.length)));
273
+ for (const skill of inventory.skills) {
274
+ lines.push(` ${skill.name.padEnd(width)} ${clipDescription(skill.description, 80)} ` +
275
+ `[${skill.source}] (${shortPath(skill.dir, cwd)})`);
276
+ }
277
+ }
278
+ lines.push('', `Looked in: ${inventory.roots.map((root) => shortPath(root, cwd)).join(', ')}`);
279
+ if (inventory.invalid.length > 0) {
280
+ const label = inventory.invalid.length === 1 ? '1 entry' : `${inventory.invalid.length} entries`;
281
+ lines.push(`Skipped ${label}:`);
282
+ for (const bad of inventory.invalid.slice(0, 10)) {
283
+ lines.push(` ${bad.name}: ${bad.reason} (${shortPath(bad.file, cwd)})`);
284
+ }
285
+ if (inventory.invalid.length > 10) {
286
+ lines.push(` … and ${inventory.invalid.length - 10} more`);
287
+ }
288
+ }
289
+ if (inventory.skills.length === 0) {
290
+ lines.push('Add one at .kiro/skills/<name>/SKILL.md with name and description frontmatter.');
291
+ }
292
+ return lines.join('\n');
293
+ }
294
+ //# sourceMappingURL=skills.js.map
package/dist/index.js CHANGED
@@ -10,6 +10,7 @@ import { registerSecretEnv } from './secrets.js';
10
10
  import { latestSession, loadSession } from './sessions.js';
11
11
  import { MOUSE_OFF } from './ui/mouse.js';
12
12
  import { App } from './ui/App.js';
13
+ import { runCheck, runUpdate } from './update.js';
13
14
  import { VERSION } from './version.js';
14
15
  const HELP = `Kiro — a small terminal coding agent
15
16
 
@@ -42,6 +43,10 @@ Model commands:
42
43
  kiro model remove <n>
43
44
  kiro model test [n]
44
45
 
46
+ Update commands:
47
+ kiro check Compare the installed version with the latest on npm
48
+ kiro update Install the latest version from npm globally
49
+
45
50
  Config: ~/.kiro/config.json (created with a template on first run)
46
51
  Keys: ~/.kiro/.env (mode 0600), or the environment variable named by "apiKeyEnv".
47
52
  Sessions: ~/.kiro/sessions (one directory per working directory)
@@ -180,6 +185,14 @@ async function main() {
180
185
  process.exitCode = await runModelCli(rawArgs.slice(1));
181
186
  return;
182
187
  }
188
+ if (rawArgs[0] === 'check') {
189
+ process.exitCode = await runCheck();
190
+ return;
191
+ }
192
+ if (rawArgs[0] === 'update') {
193
+ process.exitCode = await runUpdate();
194
+ return;
195
+ }
183
196
  let options;
184
197
  try {
185
198
  options = parseArgs(rawArgs);
@@ -3,9 +3,10 @@ import { fsTools } from './fs.js';
3
3
  import { patchTools } from './patch.js';
4
4
  import { searchTools } from './search.js';
5
5
  import { runCommandTool } from './shell.js';
6
+ import { skillTools } from './skill.js';
6
7
  import { toolError } from './types.js';
7
8
  export const MAX_TOOL_RESULT_CHARS = 60_000;
8
- export const tools = [...fsTools, ...searchTools, ...patchTools, runCommandTool];
9
+ export const tools = [...fsTools, ...searchTools, ...patchTools, runCommandTool, ...skillTools];
9
10
  export const toolDefinitions = tools.map((tool) => tool.definition);
10
11
  const byName = new Map(tools.map((tool) => [tool.definition.function.name, tool]));
11
12
  export function isReadOnlyTool(name) {
@@ -0,0 +1,40 @@
1
+ import { findSkill, loadSkills, MAX_SKILL_BODY_CHARS } from '../agent/skills.js';
2
+ import { stringArg } from './paths.js';
3
+ import { ok, toolError } from './types.js';
4
+ const readSkillTool = {
5
+ readOnly: true,
6
+ definition: {
7
+ type: 'function',
8
+ function: {
9
+ name: 'read_skill',
10
+ description: 'Load the full instructions of an installed skill by name. Use it when a request matches a skill listed in the system prompt, then follow the returned instructions.',
11
+ parameters: {
12
+ type: 'object',
13
+ properties: {
14
+ name: { type: 'string', description: 'Exact skill name, e.g. "anti-slop".' },
15
+ },
16
+ required: ['name'],
17
+ additionalProperties: false,
18
+ },
19
+ },
20
+ },
21
+ async run(input, ctx) {
22
+ const name = stringArg(input, 'name');
23
+ const inventory = await loadSkills(ctx.cwd);
24
+ if (inventory.skills.length === 0) {
25
+ return toolError('No skills are installed. Add one at .kiro/skills/<name>/SKILL.md or ~/.kiro/skills/<name>/SKILL.md.');
26
+ }
27
+ const skill = findSkill(inventory.skills, name);
28
+ if (!skill) {
29
+ return toolError(`Unknown skill "${name}". Available skills: ${inventory.skills.map((entry) => entry.name).join(', ')}.`);
30
+ }
31
+ const clipped = skill.body.length > MAX_SKILL_BODY_CHARS
32
+ ? `${skill.body.slice(0, MAX_SKILL_BODY_CHARS)}\n\n… [skill truncated after ` +
33
+ `${MAX_SKILL_BODY_CHARS.toLocaleString()} characters; read the rest with read_file on ${skill.file}]`
34
+ : skill.body;
35
+ return ok(`# Skill: ${skill.name}\n\n${clipped}\n\n` +
36
+ `[Skill directory: ${skill.dir}. Read supporting files with read_file or run bundled scripts with run_command.]`, `read_skill ${skill.name}`);
37
+ },
38
+ };
39
+ export const skillTools = [readSkillTool];
40
+ //# sourceMappingURL=skill.js.map
package/dist/ui/App.js CHANGED
@@ -4,6 +4,7 @@ import { Box, useApp, useInput, useStdout } from 'ink';
4
4
  import { mkdir, writeFile } from 'node:fs/promises';
5
5
  import path from 'node:path';
6
6
  import { buildSystemPrompt } from '../agent/prompt.js';
7
+ import { findSkill, formatSkillList, loadSkills, MAX_SKILL_BODY_CHARS, } from '../agent/skills.js';
7
8
  import { runAgentTurn } from '../agent/loop.js';
8
9
  import { COMPACT_KEEP_USER_TURNS, COMPACT_THRESHOLD, compactMessages, shouldCompact, } from '../agent/compact.js';
9
10
  import { estimateMessagesTokens, formatPercent, formatTokens } from '../agent/tokens.js';
@@ -470,12 +471,13 @@ export function App({ config, baseConfig, overrides, configPath, configCreated,
470
471
  approvalPolicy.clear();
471
472
  setAutoAllowed([]);
472
473
  }, [approvalPolicy]);
473
- const sendTurn = useCallback(async (rawInput, alreadyDisplayed = false) => {
474
+ const sendTurn = useCallback(async (rawInput, alreadyDisplayed = false, displayText) => {
474
475
  if (busyRef.current || transitioningRef.current)
475
476
  return;
476
477
  const text = rawInput.trim();
477
478
  if (!text)
478
479
  return;
480
+ const shown = displayText ?? text;
479
481
  busyRef.current = true;
480
482
  cancelRequestedRef.current = false;
481
483
  setBusy(true);
@@ -489,11 +491,11 @@ export function App({ config, baseConfig, overrides, configPath, configCreated,
489
491
  if (!alreadyDisplayed) {
490
492
  setItems((current) => [
491
493
  ...current,
492
- { kind: 'user', id: nextItemIdRef.current++, text },
494
+ { kind: 'user', id: nextItemIdRef.current++, text: shown },
493
495
  ]);
494
496
  }
495
497
  messagesRef.current.push({ role: 'user', content: text });
496
- void recordPrompt(cwd, text).then(setPromptHistory);
498
+ void recordPrompt(cwd, shown).then(setPromptHistory);
497
499
  recomputeContext();
498
500
  void persistSession();
499
501
  const controller = new AbortController();
@@ -868,6 +870,34 @@ export function App({ config, baseConfig, overrides, configPath, configCreated,
868
870
  : 'Usage card hidden; the transcript gets the full width. Use /usage to show it again.');
869
871
  return;
870
872
  }
873
+ case '/skills': {
874
+ if (argument) {
875
+ addNotice('error', 'Usage: /skills');
876
+ return;
877
+ }
878
+ const inventory = await loadSkills(cwd);
879
+ addNotice(inventory.skills.length === 0 && inventory.invalid.length === 0 ? 'muted' : 'info', formatSkillList(inventory, cwd));
880
+ return;
881
+ }
882
+ case '/skill': {
883
+ if (!argument || rest[1]) {
884
+ addNotice('error', 'Usage: /skill <name>. Run /skills to list installed skills.');
885
+ return;
886
+ }
887
+ const inventory = await loadSkills(cwd);
888
+ const skill = findSkill(inventory.skills, argument);
889
+ if (!skill) {
890
+ addNotice('error', inventory.skills.length === 0
891
+ ? 'No skills installed. Add one at .kiro/skills/<name>/SKILL.md.'
892
+ : `Unknown skill "${argument}". Installed: ${inventory.skills.map((entry) => entry.name).join(', ')}.`);
893
+ return;
894
+ }
895
+ const body = skill.body.length > MAX_SKILL_BODY_CHARS
896
+ ? `${skill.body.slice(0, MAX_SKILL_BODY_CHARS)}\n\n[Skill truncated; the rest is in ${skill.file}]`
897
+ : skill.body;
898
+ void sendTurn(`Use the "${skill.name}" skill. Its instructions follow; apply them to what I ask next.\n\n${body}`, false, `/skill ${skill.name}`);
899
+ return;
900
+ }
871
901
  case '/compact': {
872
902
  if (messagesRef.current.length === 0) {
873
903
  addNotice('muted', 'There is no conversation to compact yet.');
@@ -1137,6 +1167,7 @@ export function App({ config, baseConfig, overrides, configPath, configCreated,
1137
1167
  resetAutoAllowed,
1138
1168
  runModelFlow,
1139
1169
  runProfileTest,
1170
+ sendTurn,
1140
1171
  updateContextTokens,
1141
1172
  usageCardEnabled,
1142
1173
  version,
@@ -1,6 +1,8 @@
1
1
  export const SLASH_COMMANDS = [
2
2
  { name: '/help', description: 'show this help' },
3
3
  { name: '/model', usage: '[name | add | edit | remove | test | list]', description: 'list or switch models' },
4
+ { name: '/skills', description: 'list installed skills and where they were found' },
5
+ { name: '/skill', usage: '<name>', description: 'load a skill and apply it to your next request' },
4
6
  { name: '/context', description: 'show approximate context usage' },
5
7
  { name: '/usage', description: 'show or hide the usage card' },
6
8
  { name: '/compact', description: 'summarize older turns to free context' },
package/dist/update.js ADDED
@@ -0,0 +1,95 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { VERSION } from './version.js';
3
+ const PACKAGE_NAME = '@ywldan/kiro';
4
+ /** npm on Windows is npm.cmd; only .cmd/.bat need a shell when spawning. */
5
+ function npmCommand() {
6
+ if (process.platform === 'win32')
7
+ return { command: 'npm.cmd', shell: true };
8
+ return { command: 'npm', shell: false };
9
+ }
10
+ function runNpm(args, capture) {
11
+ const { command, shell } = npmCommand();
12
+ return new Promise((resolve, reject) => {
13
+ const child = spawn(command, args, {
14
+ stdio: capture ? ['ignore', 'pipe', 'pipe'] : 'inherit',
15
+ shell,
16
+ windowsHide: true,
17
+ });
18
+ let stdout = '';
19
+ if (capture && child.stdout)
20
+ child.stdout.on('data', (chunk) => (stdout += String(chunk)));
21
+ child.on('error', reject);
22
+ child.on('close', (code) => resolve({ code: code ?? 1, stdout }));
23
+ });
24
+ }
25
+ /** Compares dotted numeric versions; returns -1, 0 or 1. Non-numeric parts fall back to string compare. */
26
+ function compareVersions(a, b) {
27
+ if (a === b)
28
+ return 0;
29
+ const left = a.split('.').map(Number);
30
+ const right = b.split('.').map(Number);
31
+ if (left.some(Number.isNaN) || right.some(Number.isNaN))
32
+ return a < b ? -1 : 1;
33
+ const length = Math.max(left.length, right.length);
34
+ for (let index = 0; index < length; index++) {
35
+ const x = left[index] ?? 0;
36
+ const y = right[index] ?? 0;
37
+ if (x !== y)
38
+ return x < y ? -1 : 1;
39
+ }
40
+ return 0;
41
+ }
42
+ async function latestVersion() {
43
+ const { code, stdout } = await runNpm(['view', PACKAGE_NAME, 'version'], true);
44
+ const latest = stdout.trim().split(/\r?\n/).pop() ?? '';
45
+ if (code !== 0 || !/^\d+\.\d+\.\d+/.test(latest)) {
46
+ throw new Error('Could not read the latest version from the npm registry.');
47
+ }
48
+ return latest;
49
+ }
50
+ /** `kiro check` — compare the installed version with the registry. Exit 0 current, 1 update available, 2 check failed. */
51
+ export async function runCheck() {
52
+ let latest;
53
+ try {
54
+ latest = await latestVersion();
55
+ }
56
+ catch (error) {
57
+ console.error(`Kiro ${VERSION} — version check failed: ${error.message}`);
58
+ console.error('Check manually with: npm view @ywldan/kiro version');
59
+ return 2;
60
+ }
61
+ if (compareVersions(VERSION, latest) >= 0) {
62
+ process.stdout.write(`Kiro ${VERSION} — up to date\n`);
63
+ return 0;
64
+ }
65
+ process.stdout.write(`Kiro ${VERSION} → ${latest} available. Run "kiro update" to upgrade.\n`);
66
+ return 1;
67
+ }
68
+ /** `kiro update` — install the latest published version globally through npm. */
69
+ export async function runUpdate() {
70
+ let latest;
71
+ try {
72
+ latest = await latestVersion();
73
+ }
74
+ catch {
75
+ latest = 'latest';
76
+ }
77
+ if (latest !== 'latest' && compareVersions(VERSION, latest) >= 0) {
78
+ process.stdout.write(`Kiro ${VERSION} — already up to date, nothing to do\n`);
79
+ return 0;
80
+ }
81
+ process.stdout.write(`Updating Kiro ${VERSION} → ${latest} via npm…\n`);
82
+ const { command, shell } = npmCommand();
83
+ const result = await runNpm(['install', '-g', `${PACKAGE_NAME}@latest`], false).catch((error) => {
84
+ console.error(`Kiro: could not start "${command}": ${error.message}`);
85
+ return { code: 2, stdout: '' };
86
+ });
87
+ if (result.code !== 0) {
88
+ console.error(`Kiro: npm exited with code ${result.code}. Update manually with:`);
89
+ console.error(` ${command} install -g ${PACKAGE_NAME}@latest`);
90
+ return result.code;
91
+ }
92
+ process.stdout.write(`Kiro updated to ${latest}. Restart kiro to use the new version.\n`);
93
+ return 0;
94
+ }
95
+ //# sourceMappingURL=update.js.map
package/dist/version.js CHANGED
@@ -1,2 +1,2 @@
1
- export const VERSION = '0.2.7';
1
+ export const VERSION = '0.2.9';
2
2
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ywldan/kiro",
3
- "version": "0.2.7",
3
+ "version": "0.2.9",
4
4
  "description": "A small terminal coding agent with your own OpenAI-compatible endpoint",
5
5
  "keywords": [
6
6
  "ai",