feat(cli): promote init to top-level command (#398)

christso · web-flow · commit 0b32ca4e753f · 2026-05-18T15:39:18.000+10:00
allagents init &lt;path&gt; is now available directly at the root, removing the
workspace namespace for the most common entry point. workspace init is
preserved as a backward-compatible alias.
diff --git a/README.md b/README.md
@@ -12,7 +12,7 @@ AllAgents keeps your AI tooling (skills, agents, hooks, MCP servers) in one work
 
 ```bash
 # Create a workspace from a shared template
-npx allagents workspace init my-workspace --from myorg/templates/nodejs
+npx allagents init my-workspace --from myorg/templates/nodejs
 cd my-workspace
 
 # Install plugins
@@ -89,7 +89,7 @@ clients:
 
 | Command | Description |
 |---|---|
-| `allagents workspace init <path>` | Create a workspace (optionally `--from owner/repo`) |
+| `allagents init <path>` | Create a workspace (optionally `--from owner/repo`) |
 | `allagents update` | Sync all plugins to workspace |
 | `allagents plugin install <spec>` | Install a plugin |
 | `allagents plugin uninstall <spec>` | Remove a plugin |
diff --git a/src/cli/commands/workspace.ts b/src/cli/commands/workspace.ts
@@ -675,7 +675,7 @@ const repoCmd = conciseSubcommands({
 // workspace subcommands group
 // =============================================================================
 
-export { syncCmd };
+export { syncCmd, initCmd };
 
 export const workspaceCmd = conciseSubcommands({
   name: 'workspace',
diff --git a/src/cli/index.ts b/src/cli/index.ts
@@ -2,7 +2,7 @@
 
 import { run } from 'cmd-ts';
 import { conciseSubcommands } from './help.js';
-import { workspaceCmd, syncCmd } from './commands/workspace.js';
+import { workspaceCmd, syncCmd, initCmd } from './commands/workspace.js';
 import { pluginCmd } from './commands/plugin.js';
 import { mcpCmd } from './commands/mcp.js';
 import { selfCmd } from './commands/self.js';
@@ -28,6 +28,7 @@ const app = conciseSubcommands({
     'For AI agents: use --agent-help for machine-readable help, or --json for structured output',
   version: packageJson.version,
   cmds: {
+    init: initCmd,
     update: syncCmd,
     workspace: workspaceCmd,
     plugin: pluginCmd,
diff --git a/src/cli/metadata/workspace.ts b/src/cli/metadata/workspace.ts
@@ -1,14 +1,14 @@
 import type { AgentCommandMeta } from '../help.js';
 
 export const initMeta: AgentCommandMeta = {
-  command: 'workspace init',
+  command: 'init',
   description: 'Create new workspace and sync plugins',
   whenToUse: 'When starting a new project or adding allagents to an existing repo for the first time',
   examples: [
-    'allagents workspace init',
-    'allagents workspace init ./my-project',
-    'allagents workspace init --from ../template-workspace/.allagents/workspace.yaml',
-    'allagents workspace init --client claude,copilot,cursor',
+    'allagents init',
+    'allagents init ./my-project',
+    'allagents init --from ../template-workspace/.allagents/workspace.yaml',
+    'allagents init --client claude,copilot,cursor',
   ],
   expectedOutput:
     'Creates .allagents/workspace.yaml and syncs plugins. Shows sync results per plugin. Exit 0 on success, exit 1 on failure.',
diff --git a/tests/e2e/cli-enriched-help.test.ts b/tests/e2e/cli-enriched-help.test.ts
@@ -8,7 +8,7 @@ import { updateMeta } from '../../src/cli/metadata/self.js';
  * All command metadata objects that must have enriched help.
  */
 const allCommandMetas: { name: string; meta: CommandMeta }[] = [
-  { name: 'workspace init', meta: initMeta },
+  { name: 'init', meta: initMeta },
   { name: 'update', meta: syncMeta },
   { name: 'workspace status', meta: statusMeta },
   { name: 'plugin install', meta: pluginInstallMeta },
diff --git a/tests/unit/cli/agent-help.test.ts b/tests/unit/cli/agent-help.test.ts
@@ -75,6 +75,7 @@ describe('agent command metadata', () => {
   test('all expected commands are present', () => {
     const names = allCommands.map((c) => c.command).sort();
     expect(names).toEqual([
+      'init',
       'plugin install',
       'plugin list',
       'plugin marketplace add',
@@ -90,7 +91,6 @@ describe('agent command metadata', () => {
       'skill remove',
       'skill search',
       'update',
-      'workspace init',
       'workspace status',
     ]);
   });
