@michaelhartmayer/agentctl 1.0.3 → 1.1.0

package/dist/skills.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -17,34 +8,32 @@ exports.copySkill = copySkill;
 const path_1 = __importDefault(require("path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 exports.SUPPORTED_AGENTS = ['cursor', 'antigravity', 'agentsmd', 'gemini'];
-function copySkill(targetDir, agent) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // We assume the skill file is located at ../skills/agentctl/SKILL.md relative to specific dist/src/ location
-        // Or we find it in the project root if running from source.
-        // In production (dist), structure might be:
-        // dist/index.js
-        // skills/agentctl/SKILL.md (if we copy it to dist)
-        // Let's try to locate the source SKILL.md
-        // If we are in /src, it is in ../skills/agentctl/SKILL.md
-        // If we are in /dist/src (tsc default?), it depends on build.
-        // Robust finding:
-        let sourcePath = path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md');
-        if (!fs_extra_1.default.existsSync(sourcePath)) {
-            // Try looking in src check (dev mode)
-            sourcePath = path_1.default.resolve(__dirname, '../skills/agentctl/SKILL.md');
-        }
-        if (!fs_extra_1.default.existsSync(sourcePath)) {
-            // Fallback for when running from dist/src
-            sourcePath = path_1.default.resolve(__dirname, '../../../skills/agentctl/SKILL.md');
-        }
-        if (!fs_extra_1.default.existsSync(sourcePath)) {
-            throw new Error(`Could not locate source SKILL.md. Checked: ${path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md')}`);
-        }
-        yield fs_extra_1.default.ensureDir(targetDir);
-        // Determine filename
-        const filename = agent === 'cursor' ? 'agentctl.md' : 'SKILL.md';
-        const targetFile = path_1.default.join(targetDir, filename);
-        yield fs_extra_1.default.copy(sourcePath, targetFile, { overwrite: true });
-        return targetFile;
-    });
+async function copySkill(targetDir, agent) {
+    // We assume the skill file is located at ../skills/agentctl/SKILL.md relative to specific dist/src/ location
+    // Or we find it in the project root if running from source.
+    // In production (dist), structure might be:
+    // dist/index.js
+    // skills/agentctl/SKILL.md (if we copy it to dist)
+    // Let's try to locate the source SKILL.md
+    // If we are in /src, it is in ../skills/agentctl/SKILL.md
+    // If we are in /dist/src (tsc default?), it depends on build.
+    // Robust finding:
+    let sourcePath = path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md');
+    if (!fs_extra_1.default.existsSync(sourcePath)) {
+        // Try looking in src check (dev mode)
+        sourcePath = path_1.default.resolve(__dirname, '../skills/agentctl/SKILL.md');
+    }
+    if (!fs_extra_1.default.existsSync(sourcePath)) {
+        // Fallback for when running from dist/src
+        sourcePath = path_1.default.resolve(__dirname, '../../../skills/agentctl/SKILL.md');
+    }
+    if (!fs_extra_1.default.existsSync(sourcePath)) {
+        throw new Error(`Could not locate source SKILL.md. Checked: ${path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md')}`);
+    }
+    await fs_extra_1.default.ensureDir(targetDir);
+    // Determine filename
+    const filename = agent === 'cursor' ? 'agentctl.md' : 'SKILL.md';
+    const targetFile = path_1.default.join(targetDir, filename);
+    await fs_extra_1.default.copy(sourcePath, targetFile, { overwrite: true });
+    return targetFile;
 }

package/dist/src/index.js

@@ -123,7 +123,7 @@ program
     }
 });
 const ctl = program.command('ctl')
-    .description('Agent Controller Management - Create, organizing, and managing commands');
+    .description('Agent Controller Management - Create, organize, and manage commands');
 // --- Lifecycle Commands ---
 // We'll stick to flat list but with good descriptions.
 // Helper for consistent error handling
@@ -145,67 +145,101 @@ const withErrorHandling = (fn) => {
     };
 };
 ctl.command('scaffold')
-    .description('Create a new capped command with a script file')
-    .argument('<path...>', 'Command path segments (e.g., "dev start")')
+    .description('Scaffold a new command script (creates a manifest and a .sh/.cmd file)')
+    .argument('[path...]', 'The hierarchical path for the new command (e.g. "dev start")')
     .addHelpText('after', `
+Description:
+  Scaffolding creates a new directory for your command containing a 'manifest.json' 
+  and a boilerplate script file (.sh on Linux/Mac, .cmd on Windows).
+  You can then edit the script to add your own logic.
+
 Examples:
   $ agentctl ctl scaffold dev start
-  $ agentctl ctl scaffold sys backup
+  $ agentctl ctl scaffold utils/backup
 `)
-    .action(withErrorHandling(async (pathParts) => {
+    .action(withErrorHandling(async (pathParts, _options, command) => {
+    if (!pathParts || pathParts.length === 0) {
+        command.help();
+        return;
+    }
     await (0, ctl_1.scaffold)(pathParts);
 }));
 ctl.command('alias')
-    .description('Create a new capped command that runs an inline shell command')
-    .argument('<args...>', 'Name parts followed by target (e.g., "tools" "gh" "gh")')
-    .action(withErrorHandling(async (args) => {
-    if (args.length < 2) {
-        console.error('Usage: ctl alias <name...> <target>');
-        process.exit(1);
+    .description('Create an alias command that executes a shell string')
+    .argument('[path_and_cmd...]', 'Hierarchical path segments followed by the shell command')
+    .action(withErrorHandling(async (args, _options, command) => {
+    if (!args || args.length < 2) {
+        command.help();
+        return;
     }
     const target = args.pop();
     const name = args;
     await (0, ctl_1.alias)(name, target);
 }))
     .addHelpText('after', `
+How it works:
+  The last argument is always treated as the shell command to execute. 
+  All preceding arguments form the hierarchical path.
+
+  If the shell command contains spaces, wrap it in quotes.
+
 Examples:
-  $ agentctl ctl alias tools gh "gh"
+  $ agentctl ctl alias tools git-status "git status"
+    -> Creates 'agentctl tools git-status' which runs 'git status'.
+
   $ agentctl ctl alias dev build "npm run build"
+    -> Creates 'agentctl dev build' which runs 'npm run build'.
 `);
 ctl.command('group')
-    .description('Create a new command group (namespace)')
-    .argument('<path...>', 'Group path (e.g., "dev")')
+    .description('Create a command group (namespace) to organize related commands')
+    .argument('[path...]', 'Hierarchical path for the group (e.g. "dev")')
     .addHelpText('after', `
+Description:
+  Groups are essentially folders that contain other commands. 
+  They don't execute anything themselves but provide organization.
+
 Examples:
   $ agentctl ctl group dev
-  $ agentctl ctl group tools
+  $ agentctl ctl group tools/internal
 `)
-    .action(withErrorHandling(async (parts) => {
+    .action(withErrorHandling(async (parts, _options, command) => {
+    if (!parts || parts.length === 0) {
+        command.help();
+        return;
+    }
     await (0, ctl_1.group)(parts);
 }));
 ctl.command('rm')
     .description('Remove a command or group permanently')
-    .argument('<path...>', 'Command path to remove')
+    .argument('[path...]', 'Command path to remove')
     .option('--global', 'Remove from global scope')
     .addHelpText('after', `
 Examples:
   $ agentctl ctl rm dev start
   $ agentctl ctl rm tools --global
 `)
-    .action(withErrorHandling(async (parts, opts) => {
+    .action(withErrorHandling(async (parts, opts, command) => {
+    if (!parts || parts.length === 0) {
+        command.help();
+        return;
+    }
     await (0, ctl_1.rm)(parts, { global: opts.global });
 }));
 ctl.command('mv')
-    .description('Move a command or group to a new path')
-    .argument('<src>', 'Source path (quoted string or single token)')
-    .argument('<dest>', 'Destination path')
-    .option('--global', 'Move command in global scope')
+    .description('Move or rename a command or group')
+    .argument('[src]', 'Current path of the command')
+    .argument('[dest]', 'New path for the command')
+    .option('--global', 'Perform operation in global scope')
     .addHelpText('after', `
 Examples:
   $ agentctl ctl mv "dev start" "dev boot"
   $ agentctl ctl mv tools/gh tools/github --global
 `)
-    .action(withErrorHandling(async (src, dest, opts) => {
+    .action(withErrorHandling(async (src, dest, opts, command) => {
+    if (!src || !dest) {
+        command.help();
+        return;
+    }
     await (0, ctl_1.mv)(src.split(' '), dest.split(' '), { global: opts.global });
 }));
 // --- Introspection ---
@@ -220,8 +254,12 @@ ctl.command('list')
 }));
 ctl.command('inspect')
     .description('Inspect the internal manifest and details of a command')
-    .argument('<path...>', 'Command path to inspect')
-    .action(withErrorHandling(async (parts) => {
+    .argument('[path...]', 'Command path to inspect')
+    .action(withErrorHandling(async (parts, _options, command) => {
+    if (!parts || parts.length === 0) {
+        command.help();
+        return;
+    }
     const info = await (0, ctl_1.inspect)(parts);
     if (info) {
         console.log(JSON.stringify(info, null, 2));
@@ -234,7 +272,7 @@ ctl.command('inspect')
 // --- Scoping ---
 ctl.command('global')
     .description('Push a local command to the global scope')
-    .argument('<path...>', 'Local command path')
+    .argument('[path...]', 'Local command path')
     .option('--move', 'Move instead of copy')
     .option('--copy', 'Copy (default)')
     .addHelpText('after', `
@@ -242,19 +280,27 @@ Examples:
   $ agentctl ctl global sys --move
   $ agentctl ctl global tools --copy
 `)
-    .action(withErrorHandling(async (parts, opts) => {
+    .action(withErrorHandling(async (parts, opts, command) => {
+    if (!parts || parts.length === 0) {
+        command.help();
+        return;
+    }
     await (0, ctl_1.pushGlobal)(parts, { move: opts.move, copy: opts.copy || !opts.move });
 }));
 ctl.command('local')
     .description('Pull a global command to the local scope')
-    .argument('<path...>', 'Global command path')
+    .argument('[path...]', 'Global command path')
     .option('--move', 'Move instead of copy')
     .option('--copy', 'Copy (default)')
     .addHelpText('after', `
 Examples:
   $ agentctl ctl local tools --copy
 `)
-    .action(withErrorHandling(async (parts, opts) => {
+    .action(withErrorHandling(async (parts, opts, command) => {
+    if (!parts || parts.length === 0) {
+        command.help();
+        return;
+    }
     await (0, ctl_1.pullLocal)(parts, { move: opts.move, copy: opts.copy || !opts.move });
 }));
 // --- Agent Integration ---

package/package.json

@@ -4,7 +4,7 @@
     "access": "public"
   },
   "description": "Agent Controller - A unified interface for humans and AI agents",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "main": "dist/index.js",
   "bin": {
     "agentctl": "./dist/index.js"