mu-harness 0.17.3 → 0.18.0

package/esm/agents/registry.d.ts

@@ -9,6 +9,11 @@ export interface AgentRegistry {
      * re-resolved so they pick up the change.
      */
     add(agent: Agent): void;
+    /**
+     * Replace the entire set in place (rebuild) — used by hot-reload to reflect
+     * created, edited, and deleted definitions. Existing references see the new set.
+     */
+    replaceAll(agents: Agent[]): void;
 }
 export declare const grantArg: (tool: string, input: unknown) => string | undefined;
 export declare const toolDecision: (agent: Agent, tool: string, arg?: string) => ToolDecision;

package/esm/agents/registry.js

@@ -64,9 +64,7 @@ const merge = (base, child) => ({
 });
 export const createAgentRegistry = (agents = []) => {
     const raw = new Map();
-    for (const agent of agents)
-        if (!raw.has(agent.name))
-            raw.set(agent.name, agent);
+    const byName = new Map();
     const resolve = (name, seen) => {
         const agent = raw.get(name);
         if (!agent.extends)
@@ -78,9 +76,17 @@ export const createAgentRegistry = (agents = []) => {
             throw new Error(`AgentRegistry: "${name}" extends unknown agent "${agent.extends}"`);
         return merge(resolve(agent.extends, new Set(seen).add(name)), agent);
     };
-    const byName = new Map();
-    for (const name of raw.keys())
-        byName.set(name, resolve(name, new Set()));
+    // Rebuild both maps in place so existing holders of this registry see the new set.
+    const load = (list) => {
+        raw.clear();
+        for (const agent of list)
+            if (!raw.has(agent.name))
+                raw.set(agent.name, agent);
+        byName.clear();
+        for (const name of raw.keys())
+            byName.set(name, resolve(name, new Set()));
+    };
+    load(agents);
     return {
         list: () => [...byName.values()],
         get: (name) => byName.get(name),
@@ -91,5 +97,6 @@ export const createAgentRegistry = (agents = []) => {
                 if (a.extends === agent.name)
                     byName.set(name, resolve(name, new Set()));
         },
+        replaceAll: (list) => load(list),
     };
 };

package/esm/commands/index.d.ts

@@ -1,3 +1,4 @@
 export { createAgentsCommand, createHelpCommand, createQuitCommand, createSessionsCommand, createSkillsCommand, } from './defaults.js';
 export { createCommandRegistry } from './registry.js';
+export { createSkillCommand, type SkillCommandDeps } from './skill.js';
 export type { Command, CommandContext, CommandRegistry, CommandResult } from './types.js';

package/esm/commands/index.js

@@ -1,2 +1,3 @@
 export { createAgentsCommand, createHelpCommand, createQuitCommand, createSessionsCommand, createSkillsCommand, } from './defaults.js';
 export { createCommandRegistry } from './registry.js';
+export { createSkillCommand } from './skill.js';

package/esm/commands/skill.d.ts

@@ -0,0 +1,12 @@
+import type { Agent } from '../agents/index.js';
+import { type RunSkillDeps, type Skill } from '../skills/index.js';
+import type { Command } from './types.js';
+export type SkillCommandDeps = RunSkillDeps & {
+    activeAgent?: () => Agent | undefined;
+};
+/**
+ * Builds a slash command that runs a skill — the opt-in counterpart to a skill's
+ * `command` field. Invoking it runs the skill (as the active agent, or the first
+ * registered one) with the command args as its task, and returns the output.
+ */
+export declare const createSkillCommand: (skill: Skill, deps: SkillCommandDeps) => Command;

package/esm/commands/skill.js

@@ -0,0 +1,21 @@
+import { runSkill } from '../skills/index.js';
+/**
+ * Builds a slash command that runs a skill — the opt-in counterpart to a skill's
+ * `command` field. Invoking it runs the skill (as the active agent, or the first
+ * registered one) with the command args as its task, and returns the output.
+ */
+export const createSkillCommand = (skill, deps) => ({
+    name: skill.command,
+    description: skill.description || `Run the "${skill.name}" skill`,
+    run: async (args) => {
+        const agent = deps.activeAgent?.()?.name ?? deps.agents?.list()[0]?.name;
+        if (!agent)
+            return { ok: false, error: 'no agent available to run the skill' };
+        try {
+            return { ok: true, output: await runSkill(deps, { skill: skill.name, task: args, agent }) };
+        }
+        catch (error) {
+            return { ok: false, error: error instanceof Error ? error.message : String(error) };
+        }
+    },
+});

package/esm/harness/create.js

@@ -2,7 +2,7 @@ import os from 'node:os';
 import { join } from 'node:path';
 import process from 'node:process';
 import { createAgentRegistry, createAgentWriterTool, grantArg, loadAgents, toolDecision, toolNames } from '../agents/index.js';
-import { createAgentsCommand, createCommandRegistry, createHelpCommand, createSessionsCommand, createSkillsCommand, } from '../commands/index.js';
+import { createAgentsCommand, createCommandRegistry, createHelpCommand, createSessionsCommand, createSkillCommand, createSkillsCommand, } from '../commands/index.js';
 import { createHarnessConfig } from '../config/index.js';
 import { mergeHooks } from '../hooks/index.js';
 import { allowList } from '../permissions/index.js';
@@ -20,7 +20,7 @@ const TITLE_AGENT = {
     tools: [],
 };
 export const createHarness = async (options) => {
-    const { hostName, xdg, providers, model, agents: hostAgents = [], skills: hostSkills = [], skillScope, agentScope, agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
+    const { hostName, xdg, providers, model, agents: hostAgents = [], defaultAgents = [], skills: hostSkills = [], skillScope, agentScope, agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
     const cwd = options.cwd ?? process.cwd();
     const config = createHarnessConfig({ hostName, xdg });
     const models = createModelRegistry({ providers, default: model });
@@ -30,9 +30,15 @@ export const createHarness = async (options) => {
     const plugins = createPluginStore({ dir: pluginsDir });
     const newId = () => crypto.randomUUID();
     const pluginAgents = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.agents ?? []);
-    const localAgents = await loadAgents(localAgentsDir);
-    const diskAgents = await loadAgents(agentsDir);
-    const agents = createAgentRegistry([...hostAgents, ...pluginAgents, ...localAgents, ...diskAgents]);
+    const loadDiskAgents = async () => [...await loadAgents(localAgentsDir), ...await loadAgents(agentsDir)];
+    // Priority (first wins): host > plugin > local dir > config dir > default fallback.
+    const mergedAgents = async () => [
+        ...hostAgents,
+        ...pluginAgents,
+        ...await loadDiskAgents(),
+        ...defaultAgents,
+    ];
+    const agents = createAgentRegistry(await mergedAgents());
     const skillsDir = join(config.configDir, 'skills');
     const cwdSkillsDir = join(cwd, 'skills');
     const envBlock = environmentBlock({
@@ -48,9 +54,13 @@ export const createHarness = async (options) => {
         prepareRequest: ({ system }) => ({ system: system ? `${system}\n\n${envBlock}` : envBlock }),
     };
     const pluginSkills = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.skills ?? []);
-    const cwdSkills = await loadSkills(cwdSkillsDir);
-    const diskSkills = await loadSkills(skillsDir);
-    const skills = createSkillRegistry([...hostSkills, ...pluginSkills, ...cwdSkills, ...diskSkills]);
+    const mergedSkills = async () => [
+        ...hostSkills,
+        ...pluginSkills,
+        ...await loadSkills(cwdSkillsDir),
+        ...await loadSkills(skillsDir),
+    ];
+    const skills = createSkillRegistry(await mergedSkills());
     const skillWriterTool = createSkillWriterTool({
         dirs: { local: cwdSkillsDir, config: skillsDir },
         registry: skills,
@@ -163,6 +173,22 @@ export const createHarness = async (options) => {
         ...(tasks ? [createTasksCommand(tasks)] : []),
     ]);
     commands.register(createHelpCommand(() => commands.list()));
+    // Register slash commands for skills that opt in via their `command` field,
+    // and keep them in sync across hot-reloads. A name already taken by another
+    // command is left alone (built-ins win).
+    const skillCommandNames = new Set();
+    const syncSkillCommands = () => {
+        for (const name of skillCommandNames)
+            commands.unregister(name);
+        skillCommandNames.clear();
+        for (const skill of skills.list()) {
+            if (!skill.command || commands.get(skill.command))
+                continue;
+            commands.register(createSkillCommand(skill, { skills, agents, spawn, runs, activeAgent: () => approvals?.activeAgent() }));
+            skillCommandNames.add(skill.command);
+        }
+    };
+    syncSkillCommands();
     if (scheduler)
         await scheduler.start();
     return {
@@ -179,6 +205,11 @@ export const createHarness = async (options) => {
                 throw new Error(`unknown sub-agent "${agent}"`);
             return await runSubAgent(def, task, { spawn, runs, parentId });
         },
+        reloadDefinitions: async () => {
+            agents.replaceAll(await mergedAgents());
+            skills.replaceAll(await mergedSkills());
+            syncSkillCommands();
+        },
         scheduler,
         tasks,
         commands,

package/esm/harness/types.d.ts

@@ -14,6 +14,11 @@ export type HarnessOptions = HarnessConfigOptions & Omit<AgentSessionConfig, 'pr
     providers: Record<string, Provider>;
     model: string;
     agents?: Agent[];
+    /**
+     * Lowest-priority fallback agents (e.g. a host's built-in primary). Merged
+     * last, so disk- or host-defined agents of the same name override them.
+     */
+    defaultAgents?: Agent[];
     skills?: Skill[];
     /**
      * Forces the save location of `create_skill`. When set, the model's `scope`
@@ -57,6 +62,12 @@ export interface Harness {
     readonly skills: SkillRegistry;
     readonly subAgents: SubAgentRegistry;
     dispatchSubAgent(agent: string, task: string, parentId: string): Promise<SubAgentResult>;
+    /**
+     * Re-read the on-disk agent and skill directories and refresh the registries
+     * in place (create/edit/delete), preserving host/plugin/default contributions.
+     * Lets a host hot-reload definitions without a restart.
+     */
+    reloadDefinitions(): Promise<void>;
     readonly commands: CommandRegistry;
     readonly scheduler?: Scheduler;
     readonly tasks?: TaskStore;

package/esm/skills/parser.js

@@ -12,5 +12,8 @@ export const parseSkill = (source, fallbackName, dir) => {
         skill.dir = dir;
     if (platforms.length)
         skill.platforms = platforms;
+    const command = str(fields.command);
+    if (command)
+        skill.command = command;
     return skill;
 };

package/esm/skills/registry.d.ts

@@ -3,6 +3,11 @@ export interface SkillRegistry {
     list(): Skill[];
     get(name: string): Skill | undefined;
     add(skill: Skill): void;
+    /**
+     * Replace the entire set in place (rebuild) — used by hot-reload to reflect
+     * created, edited, and deleted skills. Existing references see the new set.
+     */
+    replaceAll(skills: Skill[]): void;
     select(names: string[]): SkillRegistry;
 }
 export declare const createSkillRegistry: (skills?: Skill[]) => SkillRegistry;

package/esm/skills/registry.js

@@ -1,8 +1,12 @@
 export const createSkillRegistry = (skills = []) => {
     const byName = new Map();
-    for (const skill of skills)
-        if (!byName.has(skill.name))
-            byName.set(skill.name, skill);
+    const load = (list) => {
+        byName.clear();
+        for (const skill of list)
+            if (!byName.has(skill.name))
+                byName.set(skill.name, skill);
+    };
+    load(skills);
     const view = (allow) => ({
         list: () => [...byName.values()].filter((skill) => !allow || allow.has(skill.name)),
         get: (name) => (!allow || allow.has(name) ? byName.get(name) : undefined),
@@ -10,6 +14,7 @@ export const createSkillRegistry = (skills = []) => {
             byName.set(skill.name, skill);
             allow?.add(skill.name);
         },
+        replaceAll: (list) => load(list),
         select: (names) => view(new Set(allow ? names.filter((name) => allow.has(name)) : names)),
     });
     return view();

package/esm/skills/types.d.ts

@@ -5,4 +5,9 @@ export interface Skill {
     dir?: string;
     /** OS allow-list (Hermes/agentskills.io `platforms`): macos | linux | windows. Empty/absent = all. */
     platforms?: string[];
+    /**
+     * Opt-in slash command name. When set, the harness registers a command that
+     * runs this skill (args become its task). Absent = no command for this skill.
+     */
+    command?: string;
 }

package/esm/tui/chat/ChatApp.d.ts

@@ -62,6 +62,21 @@ export interface ChatHost {
      * in the status line) leave this unset (the default).
      */
     minimal?: boolean;
+    /**
+     * Harness slash commands to surface in the TUI alongside the built-in ones
+     * (e.g. `/agents`, skill commands). Called fresh so hot-reloaded commands show
+     * up. A name that collides with a built-in TUI command is ignored.
+     */
+    commands?(): {
+        name: string;
+        description: string;
+    }[];
+    /** Runs a harness command (e.g. "/agents foo"); its output is shown in the transcript. */
+    runCommand?(input: string): Promise<{
+        ok: boolean;
+        output?: unknown;
+        error?: string;
+    }>;
     onExit(code: number): void;
 }
 export declare class ChatApp {
@@ -145,6 +160,8 @@ export declare class ChatApp {
     private cycleAgent;
     private onEscape;
     private cancelGeneration;
+    private harnessCommands;
+    private allCommands;
     private paletteItems;
     private paletteMove;
     private paletteComplete;

package/esm/tui/chat/ChatApp.js

@@ -691,8 +691,35 @@ export class ChatApp {
         this.onTurnComplete();
         this.tui.requestRender();
     }
+    // Built-in TUI commands plus any harness commands (computed fresh so hot-reloaded
+    // skill commands appear). Harness names that collide with a TUI command are dropped.
+    harnessCommands() {
+        if (!this.host.commands || !this.host.runCommand)
+            return [];
+        const taken = new Set(this.commands.map((c) => c.name));
+        return this.host.commands()
+            .filter((c) => !taken.has(c.name))
+            .map((c) => ({
+            name: c.name,
+            description: c.description,
+            run: async (args) => {
+                const res = await this.host.runCommand(`/${c.name}${args ? ` ${args}` : ''}`);
+                if (res.ok) {
+                    if (res.output != null)
+                        this.transcript.note(String(res.output));
+                }
+                else {
+                    this.transcript.note(res.error ?? 'command failed', true);
+                }
+                this.tui.requestRender();
+            },
+        }));
+    }
+    allCommands() {
+        return [...this.commands, ...this.harnessCommands()];
+    }
     paletteItems() {
-        return filterCommands(this.commands, this.editor.getValue(), this.paletteDismissedFor).slice(0, MAX_LIST_ROWS);
+        return filterCommands(this.allCommands(), this.editor.getValue(), this.paletteDismissedFor).slice(0, MAX_LIST_ROWS);
     }
     paletteMove(delta) {
         const items = this.paletteItems();
@@ -726,7 +753,7 @@ export class ChatApp {
         const space = body.indexOf(' ');
         const name = (space === -1 ? body : body.slice(0, space)).toLowerCase();
         const args = space === -1 ? '' : body.slice(space + 1).trim();
-        const command = this.commands.find((c) => c.name === name);
+        const command = this.allCommands().find((c) => c.name === name);
         if (!command) {
             this.transcript.note(`Unknown command: /${name}`, true);
             this.tui.requestRender();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mu-harness",
-  "version": "0.17.3",
+  "version": "0.18.0",
   "description": "Agent harness: createHarness wires mu-core into a host — XDG paths, model registry, plugins, disk-loaded agents & skills, sub-agents, sessions (JSONL + SQLite catalog), slash commands, permission/approval hooks, an optional scheduler, and a composable TUI chat app",
   "license": "MIT",
   "main": "./script/index.js",
@@ -23,8 +23,8 @@
     "@swc/wasm-typescript": "^1.15.0",
     "cli-highlight": "^2.1.11",
     "croner": "^9.0.0",
-    "mu-core": "^0.17.3",
-    "mu-tui": "^0.17.3"
+    "mu-core": "^0.18.0",
+    "mu-tui": "^0.18.0"
   },
   "_generatedBy": "dnt@dev",
   "types": "./esm/index.d.ts"

package/script/agents/registry.d.ts

@@ -9,6 +9,11 @@ export interface AgentRegistry {
      * re-resolved so they pick up the change.
      */
     add(agent: Agent): void;
+    /**
+     * Replace the entire set in place (rebuild) — used by hot-reload to reflect
+     * created, edited, and deleted definitions. Existing references see the new set.
+     */
+    replaceAll(agents: Agent[]): void;
 }
 export declare const grantArg: (tool: string, input: unknown) => string | undefined;
 export declare const toolDecision: (agent: Agent, tool: string, arg?: string) => ToolDecision;

package/script/agents/registry.js

@@ -70,9 +70,7 @@ const merge = (base, child) => ({
 });
 const createAgentRegistry = (agents = []) => {
     const raw = new Map();
-    for (const agent of agents)
-        if (!raw.has(agent.name))
-            raw.set(agent.name, agent);
+    const byName = new Map();
     const resolve = (name, seen) => {
         const agent = raw.get(name);
         if (!agent.extends)
@@ -84,9 +82,17 @@ const createAgentRegistry = (agents = []) => {
             throw new Error(`AgentRegistry: "${name}" extends unknown agent "${agent.extends}"`);
         return merge(resolve(agent.extends, new Set(seen).add(name)), agent);
     };
-    const byName = new Map();
-    for (const name of raw.keys())
-        byName.set(name, resolve(name, new Set()));
+    // Rebuild both maps in place so existing holders of this registry see the new set.
+    const load = (list) => {
+        raw.clear();
+        for (const agent of list)
+            if (!raw.has(agent.name))
+                raw.set(agent.name, agent);
+        byName.clear();
+        for (const name of raw.keys())
+            byName.set(name, resolve(name, new Set()));
+    };
+    load(agents);
     return {
         list: () => [...byName.values()],
         get: (name) => byName.get(name),
@@ -97,6 +103,7 @@ const createAgentRegistry = (agents = []) => {
                 if (a.extends === agent.name)
                     byName.set(name, resolve(name, new Set()));
         },
+        replaceAll: (list) => load(list),
     };
 };
 exports.createAgentRegistry = createAgentRegistry;

package/script/commands/index.d.ts

@@ -1,3 +1,4 @@
 export { createAgentsCommand, createHelpCommand, createQuitCommand, createSessionsCommand, createSkillsCommand, } from './defaults.js';
 export { createCommandRegistry } from './registry.js';
+export { createSkillCommand, type SkillCommandDeps } from './skill.js';
 export type { Command, CommandContext, CommandRegistry, CommandResult } from './types.js';

package/script/commands/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCommandRegistry = exports.createSkillsCommand = exports.createSessionsCommand = exports.createQuitCommand = exports.createHelpCommand = exports.createAgentsCommand = void 0;
+exports.createSkillCommand = exports.createCommandRegistry = exports.createSkillsCommand = exports.createSessionsCommand = exports.createQuitCommand = exports.createHelpCommand = exports.createAgentsCommand = void 0;
 var defaults_js_1 = require("./defaults.js");
 Object.defineProperty(exports, "createAgentsCommand", { enumerable: true, get: function () { return defaults_js_1.createAgentsCommand; } });
 Object.defineProperty(exports, "createHelpCommand", { enumerable: true, get: function () { return defaults_js_1.createHelpCommand; } });
@@ -9,3 +9,5 @@ Object.defineProperty(exports, "createSessionsCommand", { enumerable: true, get:
 Object.defineProperty(exports, "createSkillsCommand", { enumerable: true, get: function () { return defaults_js_1.createSkillsCommand; } });
 var registry_js_1 = require("./registry.js");
 Object.defineProperty(exports, "createCommandRegistry", { enumerable: true, get: function () { return registry_js_1.createCommandRegistry; } });
+var skill_js_1 = require("./skill.js");
+Object.defineProperty(exports, "createSkillCommand", { enumerable: true, get: function () { return skill_js_1.createSkillCommand; } });

package/script/commands/skill.d.ts

@@ -0,0 +1,12 @@
+import type { Agent } from '../agents/index.js';
+import { type RunSkillDeps, type Skill } from '../skills/index.js';
+import type { Command } from './types.js';
+export type SkillCommandDeps = RunSkillDeps & {
+    activeAgent?: () => Agent | undefined;
+};
+/**
+ * Builds a slash command that runs a skill — the opt-in counterpart to a skill's
+ * `command` field. Invoking it runs the skill (as the active agent, or the first
+ * registered one) with the command args as its task, and returns the output.
+ */
+export declare const createSkillCommand: (skill: Skill, deps: SkillCommandDeps) => Command;

package/script/commands/skill.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkillCommand = void 0;
+const index_js_1 = require("../skills/index.js");
+/**
+ * Builds a slash command that runs a skill — the opt-in counterpart to a skill's
+ * `command` field. Invoking it runs the skill (as the active agent, or the first
+ * registered one) with the command args as its task, and returns the output.
+ */
+const createSkillCommand = (skill, deps) => ({
+    name: skill.command,
+    description: skill.description || `Run the "${skill.name}" skill`,
+    run: async (args) => {
+        const agent = deps.activeAgent?.()?.name ?? deps.agents?.list()[0]?.name;
+        if (!agent)
+            return { ok: false, error: 'no agent available to run the skill' };
+        try {
+            return { ok: true, output: await (0, index_js_1.runSkill)(deps, { skill: skill.name, task: args, agent }) };
+        }
+        catch (error) {
+            return { ok: false, error: error instanceof Error ? error.message : String(error) };
+        }
+    },
+});
+exports.createSkillCommand = createSkillCommand;

package/script/harness/create.js

@@ -26,7 +26,7 @@ const TITLE_AGENT = {
     tools: [],
 };
 const createHarness = async (options) => {
-    const { hostName, xdg, providers, model, agents: hostAgents = [], skills: hostSkills = [], skillScope, agentScope, agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
+    const { hostName, xdg, providers, model, agents: hostAgents = [], defaultAgents = [], skills: hostSkills = [], skillScope, agentScope, agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
     const cwd = options.cwd ?? node_process_1.default.cwd();
     const config = (0, index_js_3.createHarnessConfig)({ hostName, xdg });
     const models = (0, models_js_1.createModelRegistry)({ providers, default: model });
@@ -36,9 +36,15 @@ const createHarness = async (options) => {
     const plugins = (0, index_js_6.createPluginStore)({ dir: pluginsDir });
     const newId = () => crypto.randomUUID();
     const pluginAgents = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.agents ?? []);
-    const localAgents = await (0, index_js_1.loadAgents)(localAgentsDir);
-    const diskAgents = await (0, index_js_1.loadAgents)(agentsDir);
-    const agents = (0, index_js_1.createAgentRegistry)([...hostAgents, ...pluginAgents, ...localAgents, ...diskAgents]);
+    const loadDiskAgents = async () => [...await (0, index_js_1.loadAgents)(localAgentsDir), ...await (0, index_js_1.loadAgents)(agentsDir)];
+    // Priority (first wins): host > plugin > local dir > config dir > default fallback.
+    const mergedAgents = async () => [
+        ...hostAgents,
+        ...pluginAgents,
+        ...await loadDiskAgents(),
+        ...defaultAgents,
+    ];
+    const agents = (0, index_js_1.createAgentRegistry)(await mergedAgents());
     const skillsDir = (0, node_path_1.join)(config.configDir, 'skills');
     const cwdSkillsDir = (0, node_path_1.join)(cwd, 'skills');
     const envBlock = (0, environment_js_1.environmentBlock)({
@@ -54,9 +60,13 @@ const createHarness = async (options) => {
         prepareRequest: ({ system }) => ({ system: system ? `${system}\n\n${envBlock}` : envBlock }),
     };
     const pluginSkills = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.skills ?? []);
-    const cwdSkills = await (0, index_js_9.loadSkills)(cwdSkillsDir);
-    const diskSkills = await (0, index_js_9.loadSkills)(skillsDir);
-    const skills = (0, index_js_9.createSkillRegistry)([...hostSkills, ...pluginSkills, ...cwdSkills, ...diskSkills]);
+    const mergedSkills = async () => [
+        ...hostSkills,
+        ...pluginSkills,
+        ...await (0, index_js_9.loadSkills)(cwdSkillsDir),
+        ...await (0, index_js_9.loadSkills)(skillsDir),
+    ];
+    const skills = (0, index_js_9.createSkillRegistry)(await mergedSkills());
     const skillWriterTool = (0, index_js_9.createSkillWriterTool)({
         dirs: { local: cwdSkillsDir, config: skillsDir },
         registry: skills,
@@ -169,6 +179,22 @@ const createHarness = async (options) => {
         ...(tasks ? [(0, index_js_7.createTasksCommand)(tasks)] : []),
     ]);
     commands.register((0, index_js_2.createHelpCommand)(() => commands.list()));
+    // Register slash commands for skills that opt in via their `command` field,
+    // and keep them in sync across hot-reloads. A name already taken by another
+    // command is left alone (built-ins win).
+    const skillCommandNames = new Set();
+    const syncSkillCommands = () => {
+        for (const name of skillCommandNames)
+            commands.unregister(name);
+        skillCommandNames.clear();
+        for (const skill of skills.list()) {
+            if (!skill.command || commands.get(skill.command))
+                continue;
+            commands.register((0, index_js_2.createSkillCommand)(skill, { skills, agents, spawn, runs, activeAgent: () => approvals?.activeAgent() }));
+            skillCommandNames.add(skill.command);
+        }
+    };
+    syncSkillCommands();
     if (scheduler)
         await scheduler.start();
     return {
@@ -185,6 +211,11 @@ const createHarness = async (options) => {
                 throw new Error(`unknown sub-agent "${agent}"`);
             return await (0, index_js_10.runSubAgent)(def, task, { spawn, runs, parentId });
         },
+        reloadDefinitions: async () => {
+            agents.replaceAll(await mergedAgents());
+            skills.replaceAll(await mergedSkills());
+            syncSkillCommands();
+        },
         scheduler,
         tasks,
         commands,

package/script/harness/types.d.ts

@@ -14,6 +14,11 @@ export type HarnessOptions = HarnessConfigOptions & Omit<AgentSessionConfig, 'pr
     providers: Record<string, Provider>;
     model: string;
     agents?: Agent[];
+    /**
+     * Lowest-priority fallback agents (e.g. a host's built-in primary). Merged
+     * last, so disk- or host-defined agents of the same name override them.
+     */
+    defaultAgents?: Agent[];
     skills?: Skill[];
     /**
      * Forces the save location of `create_skill`. When set, the model's `scope`
@@ -57,6 +62,12 @@ export interface Harness {
     readonly skills: SkillRegistry;
     readonly subAgents: SubAgentRegistry;
     dispatchSubAgent(agent: string, task: string, parentId: string): Promise<SubAgentResult>;
+    /**
+     * Re-read the on-disk agent and skill directories and refresh the registries
+     * in place (create/edit/delete), preserving host/plugin/default contributions.
+     * Lets a host hot-reload definitions without a restart.
+     */
+    reloadDefinitions(): Promise<void>;
     readonly commands: CommandRegistry;
     readonly scheduler?: Scheduler;
     readonly tasks?: TaskStore;

package/script/skills/parser.js

@@ -15,6 +15,9 @@ const parseSkill = (source, fallbackName, dir) => {
         skill.dir = dir;
     if (platforms.length)
         skill.platforms = platforms;
+    const command = (0, index_js_1.str)(fields.command);
+    if (command)
+        skill.command = command;
     return skill;
 };
 exports.parseSkill = parseSkill;

package/script/skills/registry.d.ts

@@ -3,6 +3,11 @@ export interface SkillRegistry {
     list(): Skill[];
     get(name: string): Skill | undefined;
     add(skill: Skill): void;
+    /**
+     * Replace the entire set in place (rebuild) — used by hot-reload to reflect
+     * created, edited, and deleted skills. Existing references see the new set.
+     */
+    replaceAll(skills: Skill[]): void;
     select(names: string[]): SkillRegistry;
 }
 export declare const createSkillRegistry: (skills?: Skill[]) => SkillRegistry;

package/script/skills/registry.js

@@ -3,9 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSkillRegistry = void 0;
 const createSkillRegistry = (skills = []) => {
     const byName = new Map();
-    for (const skill of skills)
-        if (!byName.has(skill.name))
-            byName.set(skill.name, skill);
+    const load = (list) => {
+        byName.clear();
+        for (const skill of list)
+            if (!byName.has(skill.name))
+                byName.set(skill.name, skill);
+    };
+    load(skills);
     const view = (allow) => ({
         list: () => [...byName.values()].filter((skill) => !allow || allow.has(skill.name)),
         get: (name) => (!allow || allow.has(name) ? byName.get(name) : undefined),
@@ -13,6 +17,7 @@ const createSkillRegistry = (skills = []) => {
             byName.set(skill.name, skill);
             allow?.add(skill.name);
         },
+        replaceAll: (list) => load(list),
         select: (names) => view(new Set(allow ? names.filter((name) => allow.has(name)) : names)),
     });
     return view();

package/script/skills/types.d.ts

@@ -5,4 +5,9 @@ export interface Skill {
     dir?: string;
     /** OS allow-list (Hermes/agentskills.io `platforms`): macos | linux | windows. Empty/absent = all. */
     platforms?: string[];
+    /**
+     * Opt-in slash command name. When set, the harness registers a command that
+     * runs this skill (args become its task). Absent = no command for this skill.
+     */
+    command?: string;
 }

package/script/tui/chat/ChatApp.d.ts

@@ -62,6 +62,21 @@ export interface ChatHost {
      * in the status line) leave this unset (the default).
      */
     minimal?: boolean;
+    /**
+     * Harness slash commands to surface in the TUI alongside the built-in ones
+     * (e.g. `/agents`, skill commands). Called fresh so hot-reloaded commands show
+     * up. A name that collides with a built-in TUI command is ignored.
+     */
+    commands?(): {
+        name: string;
+        description: string;
+    }[];
+    /** Runs a harness command (e.g. "/agents foo"); its output is shown in the transcript. */
+    runCommand?(input: string): Promise<{
+        ok: boolean;
+        output?: unknown;
+        error?: string;
+    }>;
     onExit(code: number): void;
 }
 export declare class ChatApp {
@@ -145,6 +160,8 @@ export declare class ChatApp {
     private cycleAgent;
     private onEscape;
     private cancelGeneration;
+    private harnessCommands;
+    private allCommands;
     private paletteItems;
     private paletteMove;
     private paletteComplete;

package/script/tui/chat/ChatApp.js

@@ -694,8 +694,35 @@ class ChatApp {
         this.onTurnComplete();
         this.tui.requestRender();
     }
+    // Built-in TUI commands plus any harness commands (computed fresh so hot-reloaded
+    // skill commands appear). Harness names that collide with a TUI command are dropped.
+    harnessCommands() {
+        if (!this.host.commands || !this.host.runCommand)
+            return [];
+        const taken = new Set(this.commands.map((c) => c.name));
+        return this.host.commands()
+            .filter((c) => !taken.has(c.name))
+            .map((c) => ({
+            name: c.name,
+            description: c.description,
+            run: async (args) => {
+                const res = await this.host.runCommand(`/${c.name}${args ? ` ${args}` : ''}`);
+                if (res.ok) {
+                    if (res.output != null)
+                        this.transcript.note(String(res.output));
+                }
+                else {
+                    this.transcript.note(res.error ?? 'command failed', true);
+                }
+                this.tui.requestRender();
+            },
+        }));
+    }
+    allCommands() {
+        return [...this.commands, ...this.harnessCommands()];
+    }
     paletteItems() {
-        return (0, commands_js_1.filterCommands)(this.commands, this.editor.getValue(), this.paletteDismissedFor).slice(0, MAX_LIST_ROWS);
+        return (0, commands_js_1.filterCommands)(this.allCommands(), this.editor.getValue(), this.paletteDismissedFor).slice(0, MAX_LIST_ROWS);
     }
     paletteMove(delta) {
         const items = this.paletteItems();
@@ -729,7 +756,7 @@ class ChatApp {
         const space = body.indexOf(' ');
         const name = (space === -1 ? body : body.slice(0, space)).toLowerCase();
         const args = space === -1 ? '' : body.slice(space + 1).trim();
-        const command = this.commands.find((c) => c.name === name);
+        const command = this.allCommands().find((c) => c.name === name);
         if (!command) {
             this.transcript.note(`Unknown command: /${name}`, true);
             this.tui.requestRender();