@michaelhartmayer/agentctl 1.1.4 → 1.2.1

package/dist/ctl.js

@@ -54,40 +54,56 @@ async function getContext(options) {
 }
 async function scaffold(args, options = {}) {
     const ctx = await getContext(options);
-    const localRoot = ctx.localRoot || ctx.cwd;
-    const agentctlDir = path_1.default.join(localRoot, '.agentctl');
+    const isGlobal = !!options.global;
+    const rootDir = isGlobal ? ctx.globalRoot : ctx.cwd;
+    const agentctlDir = isGlobal ? rootDir : path_1.default.join(rootDir, '.agentctl');
     const targetDir = path_1.default.join(agentctlDir, args.join(path_1.default.sep));
     const exists = await fs_extra_1.default.pathExists(targetDir);
-    const cappedAncestor = await getCappedAncestor(targetDir, agentctlDir);
-    const { effects } = ctl_1.Logic.planScaffold(args, ctx, { exists, cappedAncestor: cappedAncestor || undefined, type: 'scaffold' });
+    const cappedAncestor = isGlobal ? null : await getCappedAncestor(targetDir, agentctlDir);
+    const isNewLocalRoot = !isGlobal && !(await fs_extra_1.default.pathExists(agentctlDir));
+    const { effects } = ctl_1.Logic.planScaffold(args, ctx, {
+        exists,
+        cappedAncestor: cappedAncestor || undefined,
+        type: 'scaffold',
+        scope: isGlobal ? 'global' : 'local',
+        isNewLocalRoot
+    });
     await (0, effects_1.execute)(effects);
 }
 async function alias(args, target, options = {}) {
     const ctx = await getContext(options);
-    const localRoot = ctx.localRoot || ctx.cwd;
-    const agentctlDir = path_1.default.join(localRoot, '.agentctl');
+    const isGlobal = !!options.global;
+    const rootDir = isGlobal ? ctx.globalRoot : ctx.cwd;
+    const agentctlDir = isGlobal ? rootDir : path_1.default.join(rootDir, '.agentctl');
     const targetDir = path_1.default.join(agentctlDir, args.join(path_1.default.sep));
     const exists = await fs_extra_1.default.pathExists(targetDir);
-    const cappedAncestor = await getCappedAncestor(targetDir, agentctlDir);
+    const cappedAncestor = isGlobal ? null : await getCappedAncestor(targetDir, agentctlDir);
+    const isNewLocalRoot = !isGlobal && !(await fs_extra_1.default.pathExists(agentctlDir));
     const { effects } = ctl_1.Logic.planScaffold(args, ctx, {
         exists,
         cappedAncestor: cappedAncestor || undefined,
         type: 'alias',
-        target
+        target,
+        scope: isGlobal ? 'global' : 'local',
+        isNewLocalRoot
     });
     await (0, effects_1.execute)(effects);
 }
 async function group(args, options = {}) {
     const ctx = await getContext(options);
-    const localRoot = ctx.localRoot || ctx.cwd;
-    const agentctlDir = path_1.default.join(localRoot, '.agentctl');
+    const isGlobal = !!options.global;
+    const rootDir = isGlobal ? ctx.globalRoot : ctx.cwd;
+    const agentctlDir = isGlobal ? rootDir : path_1.default.join(rootDir, '.agentctl');
     const targetDir = path_1.default.join(agentctlDir, args.join(path_1.default.sep));
     const exists = await fs_extra_1.default.pathExists(targetDir);
-    const cappedAncestor = await getCappedAncestor(targetDir, agentctlDir);
+    const cappedAncestor = isGlobal ? null : await getCappedAncestor(targetDir, agentctlDir);
+    const isNewLocalRoot = !isGlobal && !(await fs_extra_1.default.pathExists(agentctlDir));
     const { effects } = ctl_1.Logic.planScaffold(args, ctx, {
         exists,
         cappedAncestor: cappedAncestor || undefined,
-        type: 'group'
+        type: 'group',
+        scope: isGlobal ? 'global' : 'local',
+        isNewLocalRoot
     });
     await (0, effects_1.execute)(effects);
 }
@@ -176,13 +192,14 @@ async function installSkill(agent, options = {}) {
 }
 async function install(repoUrl, pathArgs, options = {}) {
     const ctx = await getContext(options);
+    const isNewLocalRoot = !options.global && !(await fs_extra_1.default.pathExists(path_1.default.join(ctx.cwd, '.agentctl')));
     const installCtx = {
         repoUrl,
         pathParts: pathArgs,
         global: !!options.global,
         allowCollisions: !!options.allowCollisions,
-        localRoot: ctx.localRoot || ctx.cwd,
-        isNewLocalRoot: !options.global && !ctx.localRoot,
+        localRoot: options.global ? ctx.globalRoot : ctx.cwd,
+        isNewLocalRoot,
         globalRoot: ctx.globalRoot,
         osTmpdir: os_1.default.tmpdir()
     };

package/dist/index.js

@@ -25,6 +25,9 @@ const ctl = program.command('ctl')
     .description('Agent Controller Management - Create, organize, and manage commands')
     .addHelpCommand(false)
     .configureHelp({ visibleCommands: () => [] })
+    .action((opts, command) => {
+    command.help();
+})
     .addHelpText('after', `
 ${chalk_1.default.bold('Agentctl Paradigm:')}
   Agentctl acts as a unified control plane allowing both Humans and AI Agents
@@ -73,6 +76,7 @@ const normalizePath = (parts) => parts.flatMap(p => p.split(/[\s/\\:]+/).filter(
 ctl.command('scaffold')
     .description('Scaffold a new command directory with a manifest and starter script.')
     .argument('[path...]', 'Hierarchical path for the new command (e.g., "dev start" or "utils/cleanup")')
+    .option('-g, --global', 'Create command in global scope')
     .summary('create a new command')
     .addHelpText('after', `
 Additional Info:
@@ -104,11 +108,12 @@ Examples:
         command.help();
         return;
     }
-    await (0, ctl_1.scaffold)(normalized);
+    await (0, ctl_1.scaffold)(normalized, { global: opts.global });
 }));
 ctl.command('alias')
     .description('Create a command that executes a raw shell string.')
     .argument('[args...]', 'Hierarchical path segments followed by the shell command target')
+    .option('-g, --global', 'Create alias in global scope')
     .summary('create a shell alias')
     .addHelpText('after', `
 Examples:
@@ -126,11 +131,12 @@ Examples:
         command.help();
         return;
     }
-    await (0, ctl_1.alias)(name, target);
+    await (0, ctl_1.alias)(name, target, { global: opts.global });
 }));
 ctl.command('group')
     .description('Create a command group (namespace) to organize subcommands.')
     .argument('[path...]', 'Hierarchical path for the group (e.g., "dev" or "cloud/aws")')
+    .option('-g, --global', 'Create group in global scope')
     .summary('create a namespace group')
     .addHelpText('after', `
 Additional Info:
@@ -162,7 +168,7 @@ Examples:
         command.help();
         return;
     }
-    await (0, ctl_1.group)(normalized);
+    await (0, ctl_1.group)(normalized, { global: opts.global });
 }));
 ctl.command('rm')
     .description('Permanently remove a command or group.')

package/dist/logic/ctl.js

@@ -21,8 +21,9 @@ exports.Logic = {
         if (options.cappedAncestor) {
             throw new Error(`Cannot nest command under capped command: ${options.cappedAncestor.relPath}`);
         }
-        const localRoot = ctx.localRoot || ctx.cwd;
-        const agentctlDir = path_1.default.join(localRoot, '.agentctl');
+        const isGlobal = options.scope === 'global';
+        const rootDir = isGlobal ? ctx.globalRoot : ctx.cwd;
+        const agentctlDir = isGlobal ? rootDir : path_1.default.join(rootDir, '.agentctl');
         const cmdPath = args.join(path_1.default.sep);
         const targetDir = path_1.default.join(agentctlDir, cmdPath);
         const name = args[args.length - 1];
@@ -53,6 +54,9 @@ exports.Logic = {
         const logMsg = type === 'scaffold' ? `Scaffolded command: ${args.join(' ')}` :
             type === 'alias' ? `Aliased command: ${args.join(' ')} -> ${options.target}` :
                 `Created group: ${args.join(' ')}`;
+        if (options.isNewLocalRoot) {
+            effects.unshift({ type: 'log', message: `Initialized new .agentctl folder in ${rootDir}` });
+        }
         effects.push({ type: 'log', message: logMsg });
         return { effects };
     },

package/package.json

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