allagents 0.1.5 → 0.2.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 EntityProcess
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 EntityProcess
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,281 +1,281 @@
-# AllAgents
-
-CLI tool for managing multi-repo AI agent workspaces with plugin synchronization across multiple AI clients.
-
-> **Attribution:** AllAgents is inspired by [dotagents](https://github.com/iannuttall/dotagents) by Ian Nuttall. While rewritten from scratch, we share the vision of unified AI agent configuration management. Thank you Ian for the inspiration!
-
-## Why AllAgents?
-
-**The Problem:** AI coding assistants (Claude, Copilot, Cursor, Codex, etc.) each have their own configuration formats and directory structures. If you want to share skills, commands, or prompts across multiple projects or use multiple AI clients, you need to manually copy and transform files.
-
-**AllAgents solves this by:**
-
-| Feature | Claude Code Plugins | AllAgents |
-|---------|--------------------|-----------|
-| Scope | Single project | Multi-repo workspace |
-| Client support | Claude only | 8 AI clients |
-| File location | Runtime lookup from cache | Copied to workspace (git-versioned) |
-| Project structure | AI config mixed with code | Separate workspace repo |
-
-### Key Differentiators
-
-1. **Multi-repo workspaces** - One workspace references multiple project repositories. Your AI tooling lives separately from your application code.
-
-2. **Multi-client distribution** - Write plugins once, sync to all clients. AllAgents transforms and copies files to each client's expected paths.
-
-3. **Workspace is a git repo** - Unlike Claude's runtime plugin system, AllAgents copies files into your workspace. Team members get the same AI tooling via git.
-
-4. **Clean separation** - Project repos stay clean. AI configuration lives in the workspace.
-
-```
-┌─────────────────┐
-│   Marketplace   │  (plugin source - GitHub repos)
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│    AllAgents    │  (sync & transform)
-│  workspace sync │
-└────────┬────────┘
-         │
-    ┌────┴────┬────────┬─────────┐
-    ▼         ▼        ▼         ▼
-.claude/  .github/  .cursor/  .codex/   (client-specific paths)
-```
-
-## Installation
-
-```bash
-# Using bun
-bun install -g allagents
-
-# Or run directly
-bunx allagents
-```
-
-## Quick Start
-
-```bash
-# Create a new workspace
-allagents workspace init my-workspace
-cd my-workspace
-
-# Add a marketplace (or let auto-registration handle it)
-allagents plugin marketplace add anthropics/claude-plugins-official
-
-# Add plugins to workspace
-allagents workspace plugin add code-review@claude-plugins-official
-allagents workspace plugin add my-plugin@someuser/their-repo
-
-# Sync plugins to workspace
-allagents workspace sync
-```
-
-## Commands
-
-### Workspace Commands
-
-```bash
-# Initialize a new workspace from template
-allagents workspace init <path>
-
-# Sync all plugins to workspace (non-destructive)
-allagents workspace sync [options]
-  --force    Force re-fetch of remote plugins even if cached
-  --dry-run  Preview changes without applying
-
-# Non-destructive sync: your files are safe
-# - First sync overlays without deleting existing files
-# - Subsequent syncs only remove files AllAgents previously synced
-# - Tracked in .allagents/sync-state.json
-
-# Show status of workspace and plugins
-allagents workspace status
-
-# Add a plugin to .allagents/workspace.yaml (auto-registers marketplace if needed)
-allagents workspace plugin add <plugin@marketplace>
-
-# Remove a plugin from .allagents/workspace.yaml
-allagents workspace plugin remove <plugin>
-```
-
-### Plugin Marketplace Commands
-
-```bash
-# List registered marketplaces
-allagents plugin marketplace list
-
-# Add a marketplace from GitHub or local path
-allagents plugin marketplace add <source>
-  # Examples:
-  #   allagents plugin marketplace add anthropics/claude-plugins-official
-  #   allagents plugin marketplace add /path/to/local/marketplace
-
-# Remove a marketplace
-allagents plugin marketplace remove <name>
-
-# Update marketplace(s) from remote
-allagents plugin marketplace update [name]
-```
-
-### Plugin Commands
-
-```bash
-# List available plugins from marketplaces
-allagents plugin list [marketplace]
-
-# Validate a plugin or marketplace structure
-allagents plugin validate <path>
-```
-
-## .allagents/workspace.yaml
-
-The workspace configuration file lives in `.allagents/workspace.yaml` and defines repositories, plugins, and target clients:
-
-```yaml
-repositories:
-  - path: ../my-project
-    owner: myorg
-    repo: my-project
-    description: Main project repository
-  - path: ../my-api
-    owner: myorg
-    repo: my-api
-    description: API service
-
-plugins:
-  - code-review@claude-plugins-official     # plugin@marketplace format
-  - context7@claude-plugins-official
-  - my-plugin@someuser/their-repo           # fully qualified for custom marketplaces
-
-clients:
-  - claude
-  - copilot
-  - cursor
-```
-
-### Plugin Spec Format
-
-Plugins use the `plugin@marketplace` format:
-
-| Format | Example | Description |
-|--------|---------|-------------|
-| Well-known | `code-review@claude-plugins-official` | Uses known marketplace mapping |
-| owner/repo | `my-plugin@owner/repo` | Auto-registers GitHub repo, looks in `plugins/` |
-| owner/repo/subpath | `my-plugin@owner/repo/extensions` | Looks in custom subdirectory |
-
-The subpath format is useful when plugins aren't in the standard `plugins/` directory:
-
-```yaml
-plugins:
-  - feature-dev@anthropics/claude-plugins-official/plugins  # explicit plugins/ dir
-  - my-addon@someuser/repo/addons                           # custom addons/ dir
-  - tool@org/monorepo/packages/tools                        # nested path
-```
-
-### Well-Known Marketplaces
-
-These marketplace names auto-resolve to their GitHub repos:
-
-- `claude-plugins-official` → `anthropics/claude-plugins-official`
-
-### Supported Clients
-
-| Client | Commands | Skills | Agent File | Hooks |
-|--------|----------|--------|------------|-------|
-| claude | `.claude/commands/` | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` |
-| copilot | `.github/prompts/*.prompt.md` | `.github/skills/` | `AGENTS.md` | No |
-| codex | `.codex/prompts/` | `.codex/skills/` | `AGENTS.md` | No |
-| cursor | `.cursor/commands/` | `.cursor/skills/` | No | No |
-| opencode | `.opencode/commands/` | `.opencode/skills/` | `AGENTS.md` | No |
-| gemini | `.gemini/commands/` | `.gemini/skills/` | `GEMINI.md` | No |
-| factory | `.factory/commands/` | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` |
-| ampcode | N/A | N/A | `AGENTS.md` | No |
-
-## Marketplace Structure
-
-Marketplaces contain multiple plugins:
-
-```
-my-marketplace/
-├── plugins/
-│   ├── code-review/
-│   │   ├── plugin.json
-│   │   ├── commands/
-│   │   └── skills/
-│   └── debugging/
-│       ├── plugin.json
-│       ├── commands/
-│       └── skills/
-└── README.md
-```
-
-## Plugin Structure
-
-Each plugin follows this structure:
-
-```
-my-plugin/
-├── plugin.json         # Plugin metadata
-├── commands/           # Command files (.md)
-│   ├── build.md
-│   └── deploy.md
-├── skills/             # Skill directories with SKILL.md
-│   └── debugging/
-│       └── SKILL.md
-├── hooks/              # Hook files (for Claude/Factory)
-│   └── pre-commit.md
-└── AGENTS.md           # Agent configuration (optional)
-```
-
-### Skill Validation
-
-Skills must have a valid `SKILL.md` file with YAML frontmatter:
-
-```yaml
----
-name: my-skill          # Required: lowercase, alphanumeric + hyphens, max 64 chars
-description: Description of the skill  # Required
-allowed-tools:          # Optional
-  - Read
-  - Write
-model: claude-3-opus    # Optional
----
-
-# Skill Content
-
-Skill instructions go here...
-```
-
-## Storage Locations
-
-```
-~/.allagents/
-├── marketplaces.json              # Registry of marketplaces
-└── marketplaces/                  # Cloned marketplace repos
-    ├── claude-plugins-official/
-    └── someuser-their-repo/
-```
-
-## Development
-
-```bash
-# Install dependencies
-bun install
-
-# Run in development
-bun run dev workspace init test-ws
-
-# Run tests
-bun run test
-
-# Type check
-bun run typecheck
-
-# Build
-bun run build
-```
-
-## License
-
-MIT
+# AllAgents
+
+CLI tool for managing multi-repo AI agent workspaces with plugin synchronization across multiple AI clients.
+
+> **Attribution:** AllAgents is inspired by [dotagents](https://github.com/iannuttall/dotagents) by Ian Nuttall. While rewritten from scratch, we share the vision of unified AI agent configuration management. Thank you Ian for the inspiration!
+
+## Why AllAgents?
+
+**The Problem:** AI coding assistants (Claude, Copilot, Cursor, Codex, etc.) each have their own configuration formats and directory structures. If you want to share skills across multiple projects or use multiple AI clients, you need to manually copy and transform files.
+
+**AllAgents solves this by:**
+
+| Feature | Claude Code Plugins | AllAgents |
+|---------|--------------------|-----------|
+| Scope | Single project | Multi-repo workspace |
+| Client support | Claude only | 8 AI clients |
+| File location | Runtime lookup from cache | Copied to workspace (git-versioned) |
+| Project structure | AI config mixed with code | Separate workspace repo |
+
+### Key Differentiators
+
+1. **Multi-repo workspaces** - One workspace references multiple project repositories. Your AI tooling lives separately from your application code.
+
+2. **Multi-client distribution** - Write plugins once, sync to all clients. AllAgents transforms and copies files to each client's expected paths.
+
+3. **Workspace is a git repo** - Unlike Claude's runtime plugin system, AllAgents copies files into your workspace. Team members get the same AI tooling via git.
+
+4. **Clean separation** - Project repos stay clean. AI configuration lives in the workspace.
+
+```
+┌─────────────────┐
+│   Marketplace   │  (plugin source - GitHub repos)
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│    AllAgents    │  (sync & transform)
+│  workspace sync │
+└────────┬────────┘
+         │
+    ┌────┴────┬────────┬─────────┐
+    ▼         ▼        ▼         ▼
+.claude/  .github/  .cursor/  .codex/   (client-specific paths)
+```
+
+## Installation
+
+```bash
+# Using bun
+bun install -g allagents
+
+# Or run directly
+bunx allagents
+```
+
+## Quick Start
+
+```bash
+# Create a new workspace
+allagents workspace init my-workspace
+cd my-workspace
+
+# Add a marketplace (or let auto-registration handle it)
+allagents plugin marketplace add anthropics/claude-plugins-official
+
+# Add plugins to workspace
+allagents workspace plugin add code-review@claude-plugins-official
+allagents workspace plugin add my-plugin@someuser/their-repo
+
+# Sync plugins to workspace
+allagents workspace sync
+```
+
+## Commands
+
+### Workspace Commands
+
+```bash
+# Initialize a new workspace from template
+allagents workspace init <path>
+
+# Sync all plugins to workspace (non-destructive)
+allagents workspace sync [options]
+  --force    Force re-fetch of remote plugins even if cached
+  --dry-run  Preview changes without applying
+
+# Non-destructive sync: your files are safe
+# - First sync overlays without deleting existing files
+# - Subsequent syncs only remove files AllAgents previously synced
+# - Tracked in .allagents/sync-state.json
+
+# Show status of workspace and plugins
+allagents workspace status
+
+# Add a plugin to .allagents/workspace.yaml (auto-registers marketplace if needed)
+allagents workspace plugin add <plugin@marketplace>
+
+# Remove a plugin from .allagents/workspace.yaml
+allagents workspace plugin remove <plugin>
+```
+
+### Plugin Marketplace Commands
+
+```bash
+# List registered marketplaces
+allagents plugin marketplace list
+
+# Add a marketplace from GitHub or local path
+allagents plugin marketplace add <source>
+  # Examples:
+  #   allagents plugin marketplace add anthropics/claude-plugins-official
+  #   allagents plugin marketplace add /path/to/local/marketplace
+
+# Remove a marketplace
+allagents plugin marketplace remove <name>
+
+# Update marketplace(s) from remote
+allagents plugin marketplace update [name]
+```
+
+### Plugin Commands
+
+```bash
+# List available plugins from marketplaces
+allagents plugin list [marketplace]
+
+# Validate a plugin or marketplace structure
+allagents plugin validate <path>
+```
+
+## .allagents/workspace.yaml
+
+The workspace configuration file lives in `.allagents/workspace.yaml` and defines repositories, plugins, and target clients:
+
+```yaml
+repositories:
+  - path: ../my-project
+    owner: myorg
+    repo: my-project
+    description: Main project repository
+  - path: ../my-api
+    owner: myorg
+    repo: my-api
+    description: API service
+
+plugins:
+  - code-review@claude-plugins-official     # plugin@marketplace format
+  - context7@claude-plugins-official
+  - my-plugin@someuser/their-repo           # fully qualified for custom marketplaces
+
+clients:
+  - claude
+  - copilot
+  - cursor
+```
+
+### Plugin Spec Format
+
+Plugins use the `plugin@marketplace` format:
+
+| Format | Example | Description |
+|--------|---------|-------------|
+| Well-known | `code-review@claude-plugins-official` | Uses known marketplace mapping |
+| owner/repo | `my-plugin@owner/repo` | Auto-registers GitHub repo, looks in `plugins/` |
+| owner/repo/subpath | `my-plugin@owner/repo/extensions` | Looks in custom subdirectory |
+
+The subpath format is useful when plugins aren't in the standard `plugins/` directory:
+
+```yaml
+plugins:
+  - feature-dev@anthropics/claude-plugins-official/plugins  # explicit plugins/ dir
+  - my-addon@someuser/repo/addons                           # custom addons/ dir
+  - tool@org/monorepo/packages/tools                        # nested path
+```
+
+### Well-Known Marketplaces
+
+These marketplace names auto-resolve to their GitHub repos:
+
+- `claude-plugins-official` → `anthropics/claude-plugins-official`
+
+### Supported Clients
+
+| Client | Skills | Agent File | Hooks | Commands |
+|--------|--------|------------|-------|----------|
+| claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` |
+| copilot | `.github/skills/` | `AGENTS.md` | No | No |
+| codex | `.codex/skills/` | `AGENTS.md` | No | No |
+| cursor | `.cursor/skills/` | `AGENTS.md` | No | No |
+| opencode | `.opencode/skills/` | `AGENTS.md` | No | No |
+| gemini | `.gemini/skills/` | `GEMINI.md` | No | No |
+| factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No |
+| ampcode | No | `AGENTS.md` | No | No |
+
+> **Note:** Commands are a Claude-specific feature. Skills are the cross-client way to share reusable prompts.
+
+## Marketplace Structure
+
+Marketplaces contain multiple plugins:
+
+```
+my-marketplace/
+├── plugins/
+│   ├── code-review/
+│   │   ├── plugin.json
+│   │   └── skills/
+│   └── debugging/
+│       ├── plugin.json
+│       └── skills/
+└── README.md
+```
+
+## Plugin Structure
+
+Each plugin follows this structure:
+
+```
+my-plugin/
+├── plugin.json         # Plugin metadata
+├── skills/             # Skill directories with SKILL.md (all clients)
+│   └── debugging/
+│       └── SKILL.md
+├── commands/           # Command files (.md) - Claude only
+│   ├── build.md
+│   └── deploy.md
+├── hooks/              # Hook files (Claude/Factory only)
+│   └── pre-commit.md
+└── AGENTS.md           # Agent configuration (optional)
+```
+
+### Skill Validation
+
+Skills must have a valid `SKILL.md` file with YAML frontmatter:
+
+```yaml
+---
+name: my-skill          # Required: lowercase, alphanumeric + hyphens, max 64 chars
+description: Description of the skill  # Required
+allowed-tools:          # Optional
+  - Read
+  - Write
+model: claude-3-opus    # Optional
+---
+
+# Skill Content
+
+Skill instructions go here...
+```
+
+## Storage Locations
+
+```
+~/.allagents/
+├── marketplaces.json              # Registry of marketplaces
+└── marketplaces/                  # Cloned marketplace repos
+    ├── claude-plugins-official/
+    └── someuser-their-repo/
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in development
+bun run dev workspace init test-ws
+
+# Run tests
+bun run test
+
+# Type check
+bun run typecheck
+
+# Build
+bun run build
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -1893,12 +1893,12 @@ var require_isexe = __commonJS((exports, module) => {
       if (typeof Promise !== "function") {
         throw new TypeError("callback not provided");
       }
-      return new Promise(function(resolve2, reject) {
+      return new Promise(function(resolve, reject) {
         isexe(path, options2 || {}, function(er, is) {
           if (er) {
             reject(er);
           } else {
-            resolve2(is);
+            resolve(is);
           }
         });
       });
@@ -1960,27 +1960,27 @@ var require_which = __commonJS((exports, module) => {
       opt = {};
     const { pathEnv, pathExt, pathExtExe } = getPathInfo(cmd, opt);
     const found = [];
-    const step = (i2) => new Promise((resolve2, reject) => {
+    const step = (i2) => new Promise((resolve, reject) => {
       if (i2 === pathEnv.length)
-        return opt.all && found.length ? resolve2(found) : reject(getNotFoundError(cmd));
+        return opt.all && found.length ? resolve(found) : reject(getNotFoundError(cmd));
       const ppRaw = pathEnv[i2];
       const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw;
       const pCmd = path.join(pathPart, cmd);
       const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd : pCmd;
-      resolve2(subStep(p, i2, 0));
+      resolve(subStep(p, i2, 0));
     });
-    const subStep = (p, i2, ii) => new Promise((resolve2, reject) => {
+    const subStep = (p, i2, ii) => new Promise((resolve, reject) => {
       if (ii === pathExt.length)
-        return resolve2(step(i2 + 1));
+        return resolve(step(i2 + 1));
       const ext = pathExt[ii];
       isexe(p + ext, { pathExt: pathExtExe }, (er, is) => {
         if (!er && is) {
           if (opt.all)
             found.push(p + ext);
           else
-            return resolve2(p + ext);
+            return resolve(p + ext);
         }
-        return resolve2(subStep(p, i2, ii + 1));
+        return resolve(subStep(p, i2, ii + 1));
       });
     });
     return cb ? step(0).then((res) => cb(null, res), cb) : step(0);
@@ -11053,8 +11053,13 @@ var {
   Help
 } = import__.default;
 
+// src/cli/index.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { dirname as dirname6, join as join11 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+
 // src/core/workspace.ts
-import { mkdir as mkdir5, cp as cp2, readFile as readFile6, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir5, readFile as readFile6, writeFile as writeFile4 } from "node:fs/promises";
 import { existsSync as existsSync7 } from "node:fs";
 import { join as join8, resolve as resolve5, dirname as dirname5, relative as relative2, sep } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
@@ -11071,8 +11076,6 @@ var WORKSPACE_CONFIG_FILE = "workspace.yaml";
 var WORKSPACE_CONFIG_PATH = `${CONFIG_DIR}/${WORKSPACE_CONFIG_FILE}`;
 var WORKSPACE_RULES = `
 <!-- WORKSPACE-RULES:START -->
-# Workspace Rules
-
 ## Rule: Workspace Discovery
 TRIGGER: Any task
 ACTION: Read \`.allagents/workspace.yaml\` to get repository paths and project domains
@@ -17779,122 +17782,6 @@ ${errors2.join(`
 
 // src/utils/plugin-path.ts
 import { resolve, isAbsolute } from "node:path";
-function isGitHubUrl(source) {
-  const explicitPatterns = [
-    /^https?:\/\/github\.com\//,
-    /^https?:\/\/www\.github\.com\//,
-    /^github\.com\//,
-    /^gh:/
-  ];
-  if (explicitPatterns.some((pattern) => pattern.test(source))) {
-    return true;
-  }
-  if (!source.startsWith(".") && !source.startsWith("/") && !source.includes("\\") && !/^[a-zA-Z]:/.test(source) && source.includes("/")) {
-    const parts = source.split("/");
-    if (parts.length >= 2 && parts[0] && parts[1]) {
-      const validOwnerRepo = /^[a-zA-Z0-9_-]+$/;
-      if (validOwnerRepo.test(parts[0]) && validOwnerRepo.test(parts[1])) {
-        return true;
-      }
-    }
-  }
-  return false;
-}
-function parseGitHubUrl(url) {
-  let normalized = url;
-  if (normalized.startsWith("gh:")) {
-    normalized = normalized.replace(/^gh:/, "https://github.com/");
-  }
-  if (normalized.startsWith("github.com/")) {
-    normalized = `https://${normalized}`;
-  }
-  if (!normalized.includes("://") && !normalized.startsWith("github.com")) {
-    const parts = normalized.split("/");
-    if (parts.length >= 2) {
-      const owner = parts[0];
-      const repo = parts[1];
-      const validOwnerRepo = /^[a-zA-Z0-9_-]+$/;
-      if (owner && repo && validOwnerRepo.test(owner) && validOwnerRepo.test(repo)) {
-        if (parts.length > 2) {
-          const subpath = parts.slice(2).join("/");
-          return { owner, repo, subpath };
-        }
-        return { owner, repo };
-      }
-    }
-    return null;
-  }
-  const subpathPattern = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+?)\/tree\/[^/]+\/(.+)$/;
-  const subpathMatch = normalized.match(subpathPattern);
-  if (subpathMatch) {
-    const owner = subpathMatch[1];
-    const repo = subpathMatch[2]?.replace(/\.git$/, "");
-    const subpath = subpathMatch[3];
-    if (owner && repo && subpath) {
-      return { owner, repo, subpath };
-    }
-  }
-  const basicPattern = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/.*)?$/;
-  const basicMatch = normalized.match(basicPattern);
-  if (basicMatch) {
-    const owner = basicMatch[1];
-    const repo = basicMatch[2]?.replace(/\.git$/, "");
-    if (owner && repo) {
-      return { owner, repo };
-    }
-  }
-  return null;
-}
-function normalizePluginPath(source, baseDir = process.cwd()) {
-  if (isGitHubUrl(source)) {
-    return source;
-  }
-  if (isAbsolute(source)) {
-    return source;
-  }
-  return resolve(baseDir, source);
-}
-function parsePluginSource(source, baseDir = process.cwd()) {
-  if (isGitHubUrl(source)) {
-    const parsed = parseGitHubUrl(source);
-    return {
-      type: "github",
-      original: source,
-      normalized: source,
-      ...parsed?.owner && { owner: parsed.owner },
-      ...parsed?.repo && { repo: parsed.repo }
-    };
-  }
-  return {
-    type: "local",
-    original: source,
-    normalized: normalizePluginPath(source, baseDir)
-  };
-}
-function getPluginCachePath(owner, repo) {
-  const homeDir = process.env.HOME || process.env.USERPROFILE || "~";
-  return resolve(homeDir, ".allagents", "plugins", "marketplaces", `${owner}-${repo}`);
-}
-function validatePluginSource(source) {
-  if (!source || source.trim() === "") {
-    return { valid: false, error: "Plugin source cannot be empty" };
-  }
-  if (isGitHubUrl(source)) {
-    const parsed = parseGitHubUrl(source);
-    if (!parsed) {
-      return {
-        valid: false,
-        error: "Invalid GitHub URL format. Expected: https://github.com/owner/repo"
-      };
-    }
-  }
-  return { valid: true };
-}
-
-// src/core/plugin.ts
-import { mkdir, readdir, stat } from "node:fs/promises";
-import { existsSync } from "node:fs";
-import { dirname, join, resolve as resolve2 } from "node:path";
 
 // node_modules/execa/index.js
 var import_cross_spawn = __toESM(require_cross_spawn(), 1);
@@ -18769,7 +18656,7 @@ var setupTimeout = (spawned, { timeout, killSignal = "SIGTERM" }, spawnedPromise
     return spawnedPromise;
   }
   let timeoutId;
-  const timeoutPromise = new Promise((resolve2, reject) => {
+  const timeoutPromise = new Promise((resolve, reject) => {
     timeoutId = setTimeout(() => {
       timeoutKill(spawned, killSignal, reject);
     }, timeout);
@@ -19133,9 +19020,9 @@ var mergePromise = (spawned, promise) => {
     Reflect.defineProperty(spawned, property, { ...descriptor, value });
   }
 };
-var getSpawnedPromise = (spawned) => new Promise((resolve2, reject) => {
+var getSpawnedPromise = (spawned) => new Promise((resolve, reject) => {
   spawned.on("exit", (exitCode, signal) => {
-    resolve2({ exitCode, signal });
+    resolve({ exitCode, signal });
   });
   spawned.on("error", (error) => {
     reject(error);
@@ -19431,7 +19318,188 @@ function create$(options2) {
 }
 var $ = create$();
 
+// src/utils/plugin-path.ts
+function isGitHubUrl(source) {
+  const explicitPatterns = [
+    /^https?:\/\/github\.com\//,
+    /^https?:\/\/www\.github\.com\//,
+    /^github\.com\//,
+    /^gh:/
+  ];
+  if (explicitPatterns.some((pattern) => pattern.test(source))) {
+    return true;
+  }
+  if (!source.startsWith(".") && !source.startsWith("/") && !source.includes("\\") && !/^[a-zA-Z]:/.test(source) && source.includes("/")) {
+    const parts = source.split("/");
+    if (parts.length >= 2 && parts[0] && parts[1]) {
+      const validOwnerRepo = /^[a-zA-Z0-9_.-]+$/;
+      if (validOwnerRepo.test(parts[0]) && validOwnerRepo.test(parts[1])) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function parseGitHubUrl(url) {
+  let normalized = url;
+  if (normalized.startsWith("gh:")) {
+    normalized = normalized.replace(/^gh:/, "https://github.com/");
+  }
+  if (normalized.startsWith("github.com/")) {
+    normalized = `https://${normalized}`;
+  }
+  if (!normalized.includes("://") && !normalized.startsWith("github.com")) {
+    const parts = normalized.split("/");
+    if (parts.length >= 2) {
+      const owner = parts[0];
+      const repo = parts[1];
+      const validOwnerRepo = /^[a-zA-Z0-9_.-]+$/;
+      if (owner && repo && validOwnerRepo.test(owner) && validOwnerRepo.test(repo)) {
+        if (parts.length > 2) {
+          const subpath = parts.slice(2).join("/");
+          return { owner, repo, subpath };
+        }
+        return { owner, repo };
+      }
+    }
+    return null;
+  }
+  const subpathPattern = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+?)\/tree\/[^/]+\/(.+)$/;
+  const subpathMatch = normalized.match(subpathPattern);
+  if (subpathMatch) {
+    const owner = subpathMatch[1];
+    const repo = subpathMatch[2]?.replace(/\.git$/, "");
+    const subpath = subpathMatch[3];
+    if (owner && repo && subpath) {
+      return { owner, repo, subpath };
+    }
+  }
+  const basicPattern = /^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/.*)?$/;
+  const basicMatch = normalized.match(basicPattern);
+  if (basicMatch) {
+    const owner = basicMatch[1];
+    const repo = basicMatch[2]?.replace(/\.git$/, "");
+    if (owner && repo) {
+      return { owner, repo };
+    }
+  }
+  return null;
+}
+function normalizePluginPath(source, baseDir = process.cwd()) {
+  if (isGitHubUrl(source)) {
+    return source;
+  }
+  if (isAbsolute(source)) {
+    return source;
+  }
+  return resolve(baseDir, source);
+}
+function parsePluginSource(source, baseDir = process.cwd()) {
+  if (isGitHubUrl(source)) {
+    const parsed = parseGitHubUrl(source);
+    return {
+      type: "github",
+      original: source,
+      normalized: source,
+      ...parsed?.owner && { owner: parsed.owner },
+      ...parsed?.repo && { repo: parsed.repo }
+    };
+  }
+  return {
+    type: "local",
+    original: source,
+    normalized: normalizePluginPath(source, baseDir)
+  };
+}
+function getPluginCachePath(owner, repo) {
+  const homeDir = process.env.HOME || process.env.USERPROFILE || "~";
+  return resolve(homeDir, ".allagents", "plugins", "marketplaces", `${owner}-${repo}`);
+}
+function validatePluginSource(source) {
+  if (!source || source.trim() === "") {
+    return { valid: false, error: "Plugin source cannot be empty" };
+  }
+  if (isGitHubUrl(source)) {
+    const parsed = parseGitHubUrl(source);
+    if (!parsed) {
+      return {
+        valid: false,
+        error: "Invalid GitHub URL format. Expected: https://github.com/owner/repo"
+      };
+    }
+  }
+  return { valid: true };
+}
+async function verifyGitHubUrlExists(source) {
+  const parsed = parseGitHubUrl(source);
+  if (!parsed) {
+    return {
+      exists: false,
+      error: "Invalid GitHub URL format. Expected: https://github.com/owner/repo"
+    };
+  }
+  const { owner, repo, subpath } = parsed;
+  try {
+    await execa("gh", ["--version"]);
+  } catch {
+    return {
+      exists: false,
+      error: "gh CLI not installed. Install from: https://cli.github.com"
+    };
+  }
+  try {
+    await execa("gh", ["repo", "view", `${owner}/${repo}`, "--json", "name"]);
+  } catch (error) {
+    if (error instanceof Error) {
+      const errorMessage = error.message.toLowerCase();
+      if (errorMessage.includes("not found") || errorMessage.includes("404") || errorMessage.includes("could not resolve to a repository")) {
+        return {
+          exists: false,
+          error: `Repository not found: ${owner}/${repo}`
+        };
+      }
+      if (errorMessage.includes("auth") || errorMessage.includes("authentication")) {
+        return {
+          exists: false,
+          error: "GitHub authentication required. Run: gh auth login"
+        };
+      }
+    }
+    return {
+      exists: false,
+      error: `Failed to verify repository: ${error instanceof Error ? error.message : String(error)}`
+    };
+  }
+  if (subpath) {
+    try {
+      await execa("gh", [
+        "api",
+        `repos/${owner}/${repo}/contents/${subpath}`,
+        "--silent"
+      ]);
+    } catch (error) {
+      if (error instanceof Error) {
+        const errorMessage = error.message.toLowerCase();
+        if (errorMessage.includes("not found") || errorMessage.includes("404")) {
+          return {
+            exists: false,
+            error: `Path not found in repository: ${owner}/${repo}/${subpath}`
+          };
+        }
+      }
+      return {
+        exists: false,
+        error: `Failed to verify path: ${error instanceof Error ? error.message : String(error)}`
+      };
+    }
+  }
+  return { exists: true };
+}
+
 // src/core/plugin.ts
+import { mkdir, readdir, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve as resolve2 } from "node:path";
 async function fetchPlugin(url, options2 = {}) {
   const { force = false } = options2;
   const validation = validatePluginSource(url);
@@ -19579,7 +19647,6 @@ async function resolveGlobPatterns(sourceRoot, patterns) {
 var CLIENT_MAPPINGS = {
   claude: {
     commandsPath: ".claude/commands/",
-    commandsExt: ".md",
     skillsPath: ".claude/skills/",
     agentsPath: ".claude/agents/",
     agentFile: "CLAUDE.md",
@@ -19587,46 +19654,32 @@ var CLIENT_MAPPINGS = {
     hooksPath: ".claude/hooks/"
   },
   copilot: {
-    commandsPath: ".github/prompts/",
-    commandsExt: ".prompt.md",
     skillsPath: ".github/skills/",
     agentFile: "AGENTS.md"
   },
   codex: {
-    commandsPath: ".codex/prompts/",
-    commandsExt: ".md",
     skillsPath: ".codex/skills/",
     agentFile: "AGENTS.md"
   },
   cursor: {
-    commandsPath: ".cursor/commands/",
-    commandsExt: ".md",
     skillsPath: ".cursor/skills/",
     agentFile: "AGENTS.md"
   },
   opencode: {
-    commandsPath: ".opencode/commands/",
-    commandsExt: ".md",
     skillsPath: ".opencode/skills/",
     agentFile: "AGENTS.md"
   },
   gemini: {
-    commandsPath: ".gemini/commands/",
-    commandsExt: ".md",
     skillsPath: ".gemini/skills/",
     agentFile: "GEMINI.md",
     agentFileFallback: "AGENTS.md"
   },
   factory: {
-    commandsPath: ".factory/commands/",
-    commandsExt: ".md",
     skillsPath: ".factory/skills/",
     agentFile: "AGENTS.md",
     hooksPath: ".factory/hooks/"
   },
   ampcode: {
-    commandsPath: "",
-    commandsExt: ".md",
     skillsPath: "",
     agentFile: "AGENTS.md"
   }
@@ -19698,20 +19751,27 @@ async function validateSkill(skillDir) {
 }
 
 // src/core/transform.ts
-async function injectWorkspaceRules(filePath) {
-  const content = await readFile3(filePath, "utf-8");
+async function ensureWorkspaceRules(filePath, rules) {
+  const rulesContent = rules ?? WORKSPACE_RULES;
   const startMarker = "<!-- WORKSPACE-RULES:START -->";
   const endMarker = "<!-- WORKSPACE-RULES:END -->";
+  if (!existsSync3(filePath)) {
+    await writeFile(filePath, `${rulesContent.trim()}
+`, "utf-8");
+    return;
+  }
+  const content = await readFile3(filePath, "utf-8");
   const startIndex = content.indexOf(startMarker);
   const endIndex = content.indexOf(endMarker);
   if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
     const before = content.substring(0, startIndex);
     const after = content.substring(endIndex + endMarker.length);
-    await writeFile(filePath, before + WORKSPACE_RULES.trim() + after, "utf-8");
+    await writeFile(filePath, before + rulesContent.trim() + after, "utf-8");
   } else {
-    await writeFile(filePath, content + WORKSPACE_RULES, "utf-8");
+    await writeFile(filePath, content + rulesContent, "utf-8");
   }
 }
+var injectWorkspaceRules = ensureWorkspaceRules;
 async function copyCommands(pluginPath, workspacePath, client, options2 = {}) {
   const { dryRun = false } = options2;
   const mapping = CLIENT_MAPPINGS[client];
@@ -19731,11 +19791,7 @@ async function copyCommands(pluginPath, workspacePath, client, options2 = {}) {
   const mdFiles = files.filter((f) => f.endsWith(".md"));
   const copyPromises = mdFiles.map(async (file) => {
     const sourcePath = join4(sourceDir, file);
-    let destFileName = file;
-    if (mapping.commandsExt === ".prompt.md" && !file.endsWith(".prompt.md")) {
-      destFileName = file.replace(/\.md$/, ".prompt.md");
-    }
-    const destPath = join4(destDir, destFileName);
+    const destPath = join4(destDir, file);
     if (dryRun) {
       return { source: sourcePath, destination: destPath, action: "copied" };
     }
@@ -20744,11 +20800,8 @@ async function initWorkspace(targetPath = ".", options2 = {}) {
       workspaceYamlContent = await readFile6(defaultYamlPath, "utf-8");
     }
     await writeFile4(configPath, workspaceYamlContent, "utf-8");
-    const defaultAgentsPath = join8(defaultTemplatePath, "AGENTS.md");
     const targetAgentsPath = join8(absoluteTarget, "AGENTS.md");
-    if (existsSync7(defaultAgentsPath) && !existsSync7(targetAgentsPath)) {
-      await cp2(defaultAgentsPath, targetAgentsPath);
-    }
+    await ensureWorkspaceRules(targetAgentsPath);
     console.log(`✓ Workspace created at: ${absoluteTarget}`);
     console.log(`
 Syncing plugins...`);
@@ -20883,6 +20936,13 @@ async function addPlugin(plugin, workspacePath = process.cwd()) {
         error: validation.error || "Invalid GitHub URL"
       };
     }
+    const verifyResult = await verifyGitHubUrlExists(plugin);
+    if (!verifyResult.exists) {
+      return {
+        success: false,
+        error: verifyResult.error || `GitHub URL not found: ${plugin}`
+      };
+    }
   } else {
     const fullPath = join10(workspacePath, plugin);
     if (!existsSync9(fullPath) && !existsSync9(plugin)) {
@@ -21332,9 +21392,81 @@ pluginCommand.command("validate <path>").description("Validate plugin structure
   console.log("(validation not yet implemented)");
 });
 
+// src/cli/commands/update.ts
+function detectPackageManagerFromPath(scriptPath) {
+  if (scriptPath.includes(".bun")) {
+    return "bun";
+  }
+  return "npm";
+}
+function detectPackageManager() {
+  return detectPackageManagerFromPath(process.argv[1] ?? "");
+}
+async function getCurrentVersion() {
+  try {
+    const { createRequire: createRequire2 } = await import("node:module");
+    const require2 = createRequire2(import.meta.url);
+    const pkg = require2("../../../package.json");
+    return pkg.version;
+  } catch {
+    return "unknown";
+  }
+}
+var updateCommand = new Command("update").description("Update allagents to the latest version").option("--npm", "Force update using npm").option("--bun", "Force update using bun").action(async (options2) => {
+  try {
+    let packageManager;
+    if (options2.npm && options2.bun) {
+      console.error("Error: Cannot specify both --npm and --bun");
+      process.exit(1);
+    }
+    if (options2.npm) {
+      packageManager = "npm";
+    } else if (options2.bun) {
+      packageManager = "bun";
+    } else {
+      packageManager = detectPackageManager();
+    }
+    const currentVersion = await getCurrentVersion();
+    console.log(`Current version: ${currentVersion}`);
+    console.log(`Updating allagents using ${packageManager}...
+`);
+    const args = packageManager === "npm" ? ["install", "-g", "allagents@latest"] : ["add", "-g", "allagents@latest"];
+    const result = await execa(packageManager, args, {
+      stdio: "inherit"
+    });
+    if (result.exitCode === 0) {
+      try {
+        const versionResult = await execa("allagents", ["--version"]);
+        const newVersion = versionResult.stdout.trim();
+        console.log(`
+Update complete: ${currentVersion} → ${newVersion}`);
+      } catch {
+        console.log(`
+Update complete.`);
+      }
+    }
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message.includes("ENOENT") || error.message.includes("not found")) {
+        const detected = detectPackageManager();
+        const alternative = detected === "npm" ? "bun" : "npm";
+        console.error(`Error: ${detected} not found. Try using --${alternative} flag.`);
+      } else {
+        console.error(`Error: ${error.message}`);
+      }
+      process.exit(1);
+    }
+    throw error;
+  }
+});
+
 // src/cli/index.ts
+var __dirname2 = dirname6(fileURLToPath3(import.meta.url));
+var packageJsonPath = join11(__dirname2, "..", "package.json");
+var packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
 var program2 = new Command;
-program2.name("allagents").description("CLI tool for managing multi-repo AI agent workspaces with plugin synchronization").version("0.1.0");
+program2.name("allagents").description("CLI tool for managing multi-repo AI agent workspaces with plugin synchronization").version(packageJson.version);
 program2.addCommand(workspaceCommand);
 program2.addCommand(pluginCommand);
+program2.addCommand(updateCommand);
 program2.parse();

package/dist/templates/default/.allagents/workspace.yaml

@@ -1,15 +1,15 @@
-# Workspace root files (optional)
-# workspace:
-#   source: ./path/to/config  # local path, GitHub URL, or plugin@marketplace
-#   files:
-#     - CLAUDE.md
-#     - AGENTS.md
-#     - source: docs/CLAUDE.md  # explicit source/dest mapping
-#       dest: CLAUDE.md
-
-repositories: []
-
-plugins: []
-
-clients:
-  - claude
+# Workspace root files (optional)
+# workspace:
+#   source: ./path/to/config  # local path, GitHub URL, or plugin@marketplace
+#   files:
+#     - CLAUDE.md
+#     - AGENTS.md
+#     - source: docs/CLAUDE.md  # explicit source/dest mapping
+#       dest: CLAUDE.md
+
+repositories: []
+
+plugins: []
+
+clients:
+  - claude

package/dist/templates/default/AGENTS.md

@@ -1,14 +1,14 @@
-# Workspace
-
-## Development
-
-To run tests:
-```bash
-npm test
-```
-
-## Guidelines
-
-- Add project-specific coding conventions here
-- Document architectural decisions
-- Include workflow preferences
+# Workspace
+
+## Development
+
+To run tests:
+```bash
+npm test
+```
+
+## Guidelines
+
+- Add project-specific coding conventions here
+- Document architectural decisions
+- Include workflow preferences

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allagents",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "CLI tool for managing multi-repo AI agent workspaces with plugin synchronization",
   "type": "module",
   "bin": {
@@ -24,7 +24,7 @@
     "format": "biome format --write src",
     "check": "biome check src",
     "check:fix": "biome check --write src",
-    "prepare": "bun run build && bunx prek install -t pre-push"
+    "prepare": "bun run build && (test -d .git && bunx prek install -t pre-push || true)"
   },
   "keywords": [
     "cli",
@@ -53,6 +53,7 @@
     "@types/bun": "latest",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.5",
+    "shx": "^0.4.0",
     "typescript": "^5.3.3"
   },
   "engines": {