allagents 1.0.11 → 1.0.14

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,471 +1,471 @@
-# AllAgents
-
-CLI tool for managing multi-repo AI agent workspaces with plugin synchronization across multiple AI clients.
-
-## 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 | 23 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/  .agents/  .cursor/  .factory/   (client paths)
-```
-
-## Installation
-
-```bash
-# Using npm
-npm install -g allagents
-
-# Or run directly without installing
-npx allagents
-```
-
-## Quick Start
-
-```bash
-# Create a new workspace
-allagents workspace init my-workspace
-cd my-workspace
-
-# Or initialize from a remote GitHub template
-allagents workspace init my-workspace --from owner/repo/path/to/template
-
-# Add a marketplace (or let auto-registration handle it)
-allagents plugin marketplace add anthropics/claude-plugins-official
-
-# Install plugins to workspace
-allagents plugin install code-review@claude-plugins-official
-allagents plugin install my-plugin@someuser/their-repo
-
-# Sync plugins to workspace
-allagents workspace sync
-```
-
-### Initialize from Remote Template
-
-Start a new workspace instantly from any GitHub repository containing a `workspace.yaml`:
-
-```bash
-# From GitHub URL
-allagents workspace init ~/my-project --from https://github.com/myorg/templates/tree/main/nodejs
-
-# From shorthand
-allagents workspace init ~/my-project --from myorg/templates/nodejs
-
-# From repo root (looks for .allagents/workspace.yaml or workspace.yaml)
-allagents workspace init ~/my-project --from myorg/templates
-```
-
-This fetches the workspace configuration directly from GitHub - no cloning required.
-
-## Commands
-
-### Workspace Commands
-
-```bash
-# Initialize a new workspace from template
-allagents workspace init <path>
-allagents workspace init <path> --from <source>  # From local path or GitHub URL
-
-# 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 repository to the workspace (auto-detects git remote source)
-allagents workspace repo add <path>
-allagents workspace repo add <path> --description "My project"
-
-# Remove a repository from the workspace
-allagents workspace repo remove <path>
-
-# List all repositories in the workspace
-allagents workspace repo list
-```
-
-### VSCode Workspace Generation
-
-When `vscode` is included in the `clients` list, `workspace sync` automatically generates a `.code-workspace` file. Repository paths are resolved to absolute paths. Plugin folders are included with prompt/instruction file location settings for Copilot.
-
-```yaml
-# workspace.yaml
-clients:
-  - vscode
-  - claude
-```
-
-#### Output filename
-
-The output filename defaults to `<dirname>.code-workspace`. Override with `vscode.output`:
-
-```yaml
-# workspace.yaml
-vscode:
-  output: my-project
-```
-
-#### Template file
-
-Create `.allagents/template.code-workspace` for VSCode-specific settings, launch configurations, extensions, and extra folders. The template supports `{path:../...}` placeholders that resolve to absolute paths using repository paths from workspace.yaml.
-
-```json
-{
-  "folders": [
-    { "path": "{path:../Shared}", "name": "SharedLib" }
-  ],
-  "settings": {
-    "cSpell.words": ["myterm"],
-    "chat.agent.maxRequests": 999,
-    "chat.useAgentSkills": true
-  },
-  "launch": {
-    "configurations": [
-      {
-        "type": "node",
-        "name": "dev",
-        "cwd": "{path:../myapp}/src",
-        "runtimeExecutable": "npm",
-        "runtimeArgs": ["run", "dev"]
-      }
-    ]
-  },
-  "extensions": {
-    "recommendations": ["dbaeumer.vscode-eslint"]
-  }
-}
-```
-
-The generated workspace includes:
-- Repository folders from workspace.yaml (resolved to absolute paths, listed first)
-- Template folders (deduplicated against repository folders)
-- All other template content (settings, launch, extensions) with `{repo:..}` placeholders resolved
-
-### 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
-# Install a plugin to .allagents/workspace.yaml (auto-registers marketplace if needed)
-allagents plugin install <plugin@marketplace>
-
-# Remove a plugin from .allagents/workspace.yaml
-allagents plugin uninstall <plugin>
-
-# List available plugins from marketplaces
-allagents plugin list [marketplace]
-
-# Validate a plugin or marketplace structure
-allagents plugin validate <path>
-```
-
-### Skills Commands
-
-```bash
-# Add a specific skill from a GitHub repo
-allagents skills add reddit --from ReScienceLab/opc-skills
-
-# Add a skill via GitHub URL (skill name extracted from path)
-allagents skills add https://github.com/owner/repo/tree/main/skills/my-skill
-
-# List all skills and their enabled/disabled status
-allagents skills list
-
-# Disable a skill without uninstalling its plugin
-allagents skills remove brainstorming
-
-# Re-enable a previously disabled skill
-allagents skills add brainstorming
-```
-
-### GitHub Overrides
-
-For **Copilot** and **VSCode**, AllAgents copies GitHub-specific files from a plugin's `.github/` folder into the workspace's `.github/` directory:
-
-- `.github/prompts/` — prompt files
-- `.github/agents/` — agent overrides
-- `.github/hooks/` — hook overrides
-- `copilot-instructions.md` — root Copilot instructions
-
-Root `agents/` and `hooks/` directories in a plugin also map to `.github/agents/` and `.github/hooks/` for Copilot/VSCode.
-
-## .allagents/workspace.yaml
-
-The workspace configuration file lives in `.allagents/workspace.yaml` and defines repositories, plugins, workspace files, and target clients:
-
-```yaml
-# Workspace file sync (optional) - copy files from a shared source
-workspace:
-  source: ../shared-config              # Default base for relative paths
-  files:
-    - AGENTS.md                         # String shorthand: same source and dest
-    - source: docs/guide.md             # Object form: explicit source
-      dest: GUIDE.md                    # Optional dest (defaults to basename)
-    - dest: CUSTOM.md                   # File-level source override
-      source: ../other-config/CUSTOM.md
-    - dest: AGENTS.md                   # GitHub source
-      source: owner/repo/path/AGENTS.md
-
-repositories:
-  - path: ../my-project
-    source: github
-    repo: myorg/my-project
-    description: Main project repository
-  - path: ../my-api
-    source: github
-    repo: myorg/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
-```
-
-### Workspace File Sync
-
-The `workspace:` section enables syncing files from external sources to your workspace root. This is useful for sharing agent configurations (AGENTS.md, CLAUDE.md) across multiple projects.
-
-**Key behaviors:**
-- **Source of truth is remote** - Local copies are overwritten on every sync
-- **Deleted files are restored** - If you delete AGENTS.md locally, sync restores it
-- **WORKSPACE-RULES injection** - AGENTS.md and CLAUDE.md automatically get workspace discovery rules injected
-
-**Source resolution:**
-| Format | Example | Resolves to |
-|--------|---------|-------------|
-| String shorthand | `AGENTS.md` | `{workspace.source}/AGENTS.md` |
-| Relative source | `source: docs/guide.md` | `{workspace.source}/docs/guide.md` |
-| File-level override | `source: ../other/file.md` | `../other/file.md` (relative to workspace) |
-| GitHub source | `source: owner/repo/path/file.md` | Fetched from GitHub cache |
-
-**GitHub sources** are fetched fresh on every sync (always pulls latest).
-
-### 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
-
-AllAgents supports 23 AI coding assistants:
-
-#### Universal Clients (share `.agents/skills/`)
-
-| Client | Skills | Agent File | Hooks | Commands |
-|--------|--------|------------|-------|----------|
-| copilot | `.github/skills/` | `AGENTS.md` | `.github/hooks/` | No |
-| codex | `.agents/skills/` | `AGENTS.md` | No | No |
-| opencode | `.agents/skills/` | `AGENTS.md` | No | `.opencode/commands/` |
-| gemini | `.agents/skills/` | `GEMINI.md` | No | No |
-| ampcode | `.agents/skills/` | `AGENTS.md` | No | No |
-| vscode | `.agents/skills/` | `AGENTS.md` | No | No |
-| replit | `.agents/skills/` | `AGENTS.md` | No | No |
-| kimi | `.agents/skills/` | `AGENTS.md` | No | No |
-
-#### Provider-Specific Clients
-
-| Client | Skills | Agent File | Hooks | Commands |
-|--------|--------|------------|-------|----------|
-| claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` |
-| cursor | `.cursor/skills/` | `AGENTS.md` | No | No |
-| factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No |
-| openclaw | `skills/` | `AGENTS.md` | No | No |
-| windsurf | `.windsurf/skills/` | `AGENTS.md` | No | No |
-| cline | `.cline/skills/` | `AGENTS.md` | No | No |
-| continue | `.continue/skills/` | `AGENTS.md` | No | No |
-| roo | `.roo/skills/` | `AGENTS.md` | No | No |
-| kilo | `.kilocode/skills/` | `AGENTS.md` | No | No |
-| trae | `.trae/skills/` | `AGENTS.md` | No | No |
-| augment | `.augment/skills/` | `AGENTS.md` | No | No |
-| zencoder | `.zencoder/skills/` | `AGENTS.md` | No | No |
-| junie | `.junie/skills/` | `AGENTS.md` | No | No |
-| openhands | `.openhands/skills/` | `AGENTS.md` | No | No |
-| kiro | `.kiro/skills/` | `AGENTS.md` | No | No |
-
-> **Note:** Universal clients share the same `.agents/skills/` directory. See [GitHub Overrides](#github-overrides) for how Copilot and VSCode handle `.github/` content.
-
-## Marketplace Structure
-
-Marketplaces contain multiple plugins:
-
-```
-my-marketplace/
-├── plugins/
-│   ├── code-review/
-│   │   └── skills/
-│   └── debugging/
-│       └── skills/
-└── README.md
-```
-
-## Plugin Structure
-
-Each plugin follows this structure:
-
-```
-my-plugin/
-├── skills/             # Skill directories with SKILL.md (all clients)
-│   └── debugging/
-│       └── SKILL.md
-├── commands/           # Command files (.md) - Claude, OpenCode
-│   ├── build.md
-│   └── deploy.md
-├── .github/            # GitHub overrides (Copilot, VSCode)
-│   └── prompts/
-│       └── review.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...
-```
-
-### Self Commands
-
-```bash
-# Update to latest version (auto-detects package manager)
-allagents self update
-
-# Force a specific package manager
-allagents self update --npm
-allagents self update --bun
-```
-
-When using the interactive TUI, AllAgents automatically checks for newer versions in the background and shows a notice on startup when an update is available.
-
-## Storage Locations
-
-```
-~/.allagents/
-├── marketplaces.json              # Registry of marketplaces
-├── version-check.json             # Cached update check (auto-managed)
-└── 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
-```
-
-## Related Projects
-
-- [dotagents](https://github.com/iannuttall/dotagents) - Unified AI agent configuration management
-- [vercel-labs/skills](https://github.com/vercel-labs/skills) - Universal skills for AI coding assistants
-
-## License
-
-MIT
+# AllAgents
+
+CLI tool for managing multi-repo AI agent workspaces with plugin synchronization across multiple AI clients.
+
+## 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 | 23 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/  .agents/  .cursor/  .factory/   (client paths)
+```
+
+## Installation
+
+```bash
+# Using npm
+npm install -g allagents
+
+# Or run directly without installing
+npx allagents
+```
+
+## Quick Start
+
+```bash
+# Create a new workspace
+allagents workspace init my-workspace
+cd my-workspace
+
+# Or initialize from a remote GitHub template
+allagents workspace init my-workspace --from owner/repo/path/to/template
+
+# Add a marketplace (or let auto-registration handle it)
+allagents plugin marketplace add anthropics/claude-plugins-official
+
+# Install plugins to workspace
+allagents plugin install code-review@claude-plugins-official
+allagents plugin install my-plugin@someuser/their-repo
+
+# Sync plugins to workspace
+allagents workspace sync
+```
+
+### Initialize from Remote Template
+
+Start a new workspace instantly from any GitHub repository containing a `workspace.yaml`:
+
+```bash
+# From GitHub URL
+allagents workspace init ~/my-project --from https://github.com/myorg/templates/tree/main/nodejs
+
+# From shorthand
+allagents workspace init ~/my-project --from myorg/templates/nodejs
+
+# From repo root (looks for .allagents/workspace.yaml or workspace.yaml)
+allagents workspace init ~/my-project --from myorg/templates
+```
+
+This fetches the workspace configuration directly from GitHub - no cloning required.
+
+## Commands
+
+### Workspace Commands
+
+```bash
+# Initialize a new workspace from template
+allagents workspace init <path>
+allagents workspace init <path> --from <source>  # From local path or GitHub URL
+
+# 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 repository to the workspace (auto-detects git remote source)
+allagents workspace repo add <path>
+allagents workspace repo add <path> --description "My project"
+
+# Remove a repository from the workspace
+allagents workspace repo remove <path>
+
+# List all repositories in the workspace
+allagents workspace repo list
+```
+
+### VSCode Workspace Generation
+
+When `vscode` is included in the `clients` list, `workspace sync` automatically generates a `.code-workspace` file. Repository paths are resolved to absolute paths. Plugin folders are included with prompt/instruction file location settings for Copilot.
+
+```yaml
+# workspace.yaml
+clients:
+  - vscode
+  - claude
+```
+
+#### Output filename
+
+The output filename defaults to `<dirname>.code-workspace`. Override with `vscode.output`:
+
+```yaml
+# workspace.yaml
+vscode:
+  output: my-project
+```
+
+#### Template file
+
+Create `.allagents/template.code-workspace` for VSCode-specific settings, launch configurations, extensions, and extra folders. The template supports `{path:../...}` placeholders that resolve to absolute paths using repository paths from workspace.yaml.
+
+```json
+{
+  "folders": [
+    { "path": "{path:../Shared}", "name": "SharedLib" }
+  ],
+  "settings": {
+    "cSpell.words": ["myterm"],
+    "chat.agent.maxRequests": 999,
+    "chat.useAgentSkills": true
+  },
+  "launch": {
+    "configurations": [
+      {
+        "type": "node",
+        "name": "dev",
+        "cwd": "{path:../myapp}/src",
+        "runtimeExecutable": "npm",
+        "runtimeArgs": ["run", "dev"]
+      }
+    ]
+  },
+  "extensions": {
+    "recommendations": ["dbaeumer.vscode-eslint"]
+  }
+}
+```
+
+The generated workspace includes:
+- Repository folders from workspace.yaml (resolved to absolute paths, listed first)
+- Template folders (deduplicated against repository folders)
+- All other template content (settings, launch, extensions) with `{repo:..}` placeholders resolved
+
+### 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
+# Install a plugin to .allagents/workspace.yaml (auto-registers marketplace if needed)
+allagents plugin install <plugin@marketplace>
+
+# Remove a plugin from .allagents/workspace.yaml
+allagents plugin uninstall <plugin>
+
+# List available plugins from marketplaces
+allagents plugin list [marketplace]
+
+# Validate a plugin or marketplace structure
+allagents plugin validate <path>
+```
+
+### Skills Commands
+
+```bash
+# Add a specific skill from a GitHub repo
+allagents skills add reddit --from ReScienceLab/opc-skills
+
+# Add a skill via GitHub URL (skill name extracted from path)
+allagents skills add https://github.com/owner/repo/tree/main/skills/my-skill
+
+# List all skills and their enabled/disabled status
+allagents skills list
+
+# Disable a skill without uninstalling its plugin
+allagents skills remove brainstorming
+
+# Re-enable a previously disabled skill
+allagents skills add brainstorming
+```
+
+### GitHub Overrides
+
+For **Copilot** and **VSCode**, AllAgents copies GitHub-specific files from a plugin's `.github/` folder into the workspace's `.github/` directory:
+
+- `.github/prompts/` — prompt files
+- `.github/agents/` — agent overrides
+- `.github/hooks/` — hook overrides
+- `copilot-instructions.md` — root Copilot instructions
+
+Root `agents/` and `hooks/` directories in a plugin also map to `.github/agents/` and `.github/hooks/` for Copilot/VSCode.
+
+## .allagents/workspace.yaml
+
+The workspace configuration file lives in `.allagents/workspace.yaml` and defines repositories, plugins, workspace files, and target clients:
+
+```yaml
+# Workspace file sync (optional) - copy files from a shared source
+workspace:
+  source: ../shared-config              # Default base for relative paths
+  files:
+    - AGENTS.md                         # String shorthand: same source and dest
+    - source: docs/guide.md             # Object form: explicit source
+      dest: GUIDE.md                    # Optional dest (defaults to basename)
+    - dest: CUSTOM.md                   # File-level source override
+      source: ../other-config/CUSTOM.md
+    - dest: AGENTS.md                   # GitHub source
+      source: owner/repo/path/AGENTS.md
+
+repositories:
+  - path: ../my-project
+    source: github
+    repo: myorg/my-project
+    description: Main project repository
+  - path: ../my-api
+    source: github
+    repo: myorg/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
+```
+
+### Workspace File Sync
+
+The `workspace:` section enables syncing files from external sources to your workspace root. This is useful for sharing agent configurations (AGENTS.md, CLAUDE.md) across multiple projects.
+
+**Key behaviors:**
+- **Source of truth is remote** - Local copies are overwritten on every sync
+- **Deleted files are restored** - If you delete AGENTS.md locally, sync restores it
+- **WORKSPACE-RULES injection** - AGENTS.md and CLAUDE.md automatically get workspace discovery rules injected
+
+**Source resolution:**
+| Format | Example | Resolves to |
+|--------|---------|-------------|
+| String shorthand | `AGENTS.md` | `{workspace.source}/AGENTS.md` |
+| Relative source | `source: docs/guide.md` | `{workspace.source}/docs/guide.md` |
+| File-level override | `source: ../other/file.md` | `../other/file.md` (relative to workspace) |
+| GitHub source | `source: owner/repo/path/file.md` | Fetched from GitHub cache |
+
+**GitHub sources** are fetched fresh on every sync (always pulls latest).
+
+### 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
+
+AllAgents supports 23 AI coding assistants:
+
+#### Universal Clients (share `.agents/skills/`)
+
+| Client | Skills | Agent File | Hooks | Commands |
+|--------|--------|------------|-------|----------|
+| copilot | `.github/skills/` | `AGENTS.md` | `.github/hooks/` | No |
+| codex | `.agents/skills/` | `AGENTS.md` | No | No |
+| opencode | `.agents/skills/` | `AGENTS.md` | No | `.opencode/commands/` |
+| gemini | `.agents/skills/` | `GEMINI.md` | No | No |
+| ampcode | `.agents/skills/` | `AGENTS.md` | No | No |
+| vscode | `.agents/skills/` | `AGENTS.md` | No | No |
+| replit | `.agents/skills/` | `AGENTS.md` | No | No |
+| kimi | `.agents/skills/` | `AGENTS.md` | No | No |
+
+#### Provider-Specific Clients
+
+| Client | Skills | Agent File | Hooks | Commands |
+|--------|--------|------------|-------|----------|
+| claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` |
+| cursor | `.cursor/skills/` | `AGENTS.md` | No | No |
+| factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No |
+| openclaw | `skills/` | `AGENTS.md` | No | No |
+| windsurf | `.windsurf/skills/` | `AGENTS.md` | No | No |
+| cline | `.cline/skills/` | `AGENTS.md` | No | No |
+| continue | `.continue/skills/` | `AGENTS.md` | No | No |
+| roo | `.roo/skills/` | `AGENTS.md` | No | No |
+| kilo | `.kilocode/skills/` | `AGENTS.md` | No | No |
+| trae | `.trae/skills/` | `AGENTS.md` | No | No |
+| augment | `.augment/skills/` | `AGENTS.md` | No | No |
+| zencoder | `.zencoder/skills/` | `AGENTS.md` | No | No |
+| junie | `.junie/skills/` | `AGENTS.md` | No | No |
+| openhands | `.openhands/skills/` | `AGENTS.md` | No | No |
+| kiro | `.kiro/skills/` | `AGENTS.md` | No | No |
+
+> **Note:** Universal clients share the same `.agents/skills/` directory. See [GitHub Overrides](#github-overrides) for how Copilot and VSCode handle `.github/` content.
+
+## Marketplace Structure
+
+Marketplaces contain multiple plugins:
+
+```
+my-marketplace/
+├── plugins/
+│   ├── code-review/
+│   │   └── skills/
+│   └── debugging/
+│       └── skills/
+└── README.md
+```
+
+## Plugin Structure
+
+Each plugin follows this structure:
+
+```
+my-plugin/
+├── skills/             # Skill directories with SKILL.md (all clients)
+│   └── debugging/
+│       └── SKILL.md
+├── commands/           # Command files (.md) - Claude, OpenCode
+│   ├── build.md
+│   └── deploy.md
+├── .github/            # GitHub overrides (Copilot, VSCode)
+│   └── prompts/
+│       └── review.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...
+```
+
+### Self Commands
+
+```bash
+# Update to latest version (auto-detects package manager)
+allagents self update
+
+# Force a specific package manager
+allagents self update --npm
+allagents self update --bun
+```
+
+When using the interactive TUI, AllAgents automatically checks for newer versions in the background and shows a notice on startup when an update is available.
+
+## Storage Locations
+
+```
+~/.allagents/
+├── marketplaces.json              # Registry of marketplaces
+├── version-check.json             # Cached update check (auto-managed)
+└── 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
+```
+
+## Related Projects
+
+- [dotagents](https://github.com/iannuttall/dotagents) - Unified AI agent configuration management
+- [vercel-labs/skills](https://github.com/vercel-labs/skills) - Universal skills for AI coding assistants
+
+## License
+
+MIT

package/dist/index.js

@@ -6378,7 +6378,7 @@ var require_parse = __commonJS((exports, module) => {
   var token;
   var key;
   var root;
-  module.exports = function parse2(text, reviver) {
+  module.exports = function parse(text, reviver) {
     source = String(text);
     parseState = "start";
     stack = [];
@@ -13446,7 +13446,7 @@ function gitInstanceFactory(baseDir, options2) {
 }
 var import_file_exists, import_debug, import_promise_deferred, import_promise_deferred2, __defProp2, __getOwnPropDesc2, __getOwnPropNames2, __hasOwnProp2, __esm2 = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames2(fn)[0]])(fn = 0)), res;
-}, __commonJS2 = (cb, mod) => function __require2() {
+}, __commonJS2 = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames2(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 }, __export2 = (target, all) => {
   for (var name in all)
@@ -21933,7 +21933,7 @@ var require_is_extendable = __commonJS((exports, module) => {
 // node_modules/extend-shallow/index.js
 var require_extend_shallow = __commonJS((exports, module) => {
   var isObject2 = require_is_extendable();
-  module.exports = function extend3(o) {
+  module.exports = function extend(o) {
     if (!isObject2(o)) {
       o = {};
     }
@@ -22127,7 +22127,7 @@ var require_exception = __commonJS((exports, module) => {
   }
   YAMLException2.prototype = Object.create(Error.prototype);
   YAMLException2.prototype.constructor = YAMLException2;
-  YAMLException2.prototype.toString = function toString2(compact) {
+  YAMLException2.prototype.toString = function toString(compact) {
     var result = this.name + ": ";
     result += this.reason || "(unknown reason)";
     if (!compact && this.mark) {
@@ -22180,7 +22180,7 @@ var require_mark = __commonJS((exports, module) => {
     return common2.repeat(" ", indent) + head + snippet2 + tail + `
 ` + common2.repeat(" ", indent + this.position - start + head.length) + "^";
   };
-  Mark.prototype.toString = function toString2(compact) {
+  Mark.prototype.toString = function toString(compact) {
     var snippet2, where = "";
     if (this.name) {
       where += 'in "' + this.name + '" ';
@@ -23275,7 +23275,7 @@ var require_loader = __commonJS((exports, module) => {
     }
   }
   var directiveHandlers2 = {
-    YAML: function handleYamlDirective2(state, name, args) {
+    YAML: function handleYamlDirective(state, name, args) {
       var match, major, minor;
       if (state.version !== null) {
         throwError2(state, "duplication of %YAML directive");
@@ -23298,7 +23298,7 @@ var require_loader = __commonJS((exports, module) => {
         throwWarning2(state, "unsupported YAML version of the document");
       }
     },
-    TAG: function handleTagDirective2(state, name, args) {
+    TAG: function handleTagDirective(state, name, args) {
       var handle, prefix;
       if (args.length !== 2) {
         throwError2(state, "TAG directive accepts exactly two arguments");
@@ -30789,9 +30789,13 @@ function classifyDestination(dest) {
 }
 function classifyCopyResults(copyResults) {
   const clientCounts = new Map;
+  const seenDestinations = new Set;
   for (const result of copyResults) {
     if (result.action !== "copied")
       continue;
+    if (seenDestinations.has(result.destination))
+      continue;
+    seenDestinations.add(result.destination);
     const classification = classifyDestination(result.destination);
     if (!classification)
       continue;
@@ -30847,6 +30851,14 @@ function formatPluginArtifacts(copyResults, indent = "  ") {
   }
   return formatArtifactLines(classified, indent);
 }
+function formatSyncHeader(result) {
+  const pluginCount = result.pluginResults.length;
+  const successCount = result.pluginResults.filter((p) => p.success).length;
+  return [
+    `Updating ${pluginCount} plugin(s)...`,
+    `✓ Successfully updated ${successCount} marketplace(s)`
+  ];
+}
 function formatSyncSummary(result, { dryRun = false, label = "Sync" } = {}) {
   const lines = [];
   const allCopied = result.pluginResults.flatMap((pr) => pr.copyResults.filter((r) => r.action === "copied"));
@@ -33430,7 +33442,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "allagents",
-    version: "1.0.11",
+    version: "1.0.14",
     description: "CLI tool for managing multi-repo AI agent workspaces with plugin synchronization",
     type: "module",
     bin: {
@@ -35379,18 +35391,10 @@ var syncCmd = import_cmd_ts2.command({
       }
       let combined = null;
       if (userConfigExists) {
-        if (!isJsonMode()) {
-          console.log(`Syncing user workspace...
-`);
-        }
         const userResult = await syncUserWorkspace({ offline, dryRun, force });
         combined = userResult;
       }
       if (projectConfigExists) {
-        if (!isJsonMode()) {
-          console.log(`Syncing project workspace...
-`);
-        }
         const projectResult = await syncWorkspace(process.cwd(), {
           offline,
           dryRun
@@ -35422,6 +35426,10 @@ var syncCmd = import_cmd_ts2.command({
         }
         console.log("");
       }
+      for (const line of formatSyncHeader(result)) {
+        console.log(line);
+      }
+      console.log("");
       for (const pluginResult of result.pluginResults) {
         const status = pluginResult.success ? "✓" : "✗";
         console.log(`${status} Plugin: ${pluginResult.plugin}`);
@@ -36760,11 +36768,6 @@ Warnings:`);
   return { ok: result.success && result.totalFailed === 0, syncData };
 }
 async function runUserSyncAndPrint() {
-  if (!isJsonMode()) {
-    console.log(`
-Syncing user workspace...
-`);
-  }
   const result = await syncUserWorkspace();
   if (!result.success && result.error) {
     if (!isJsonMode()) {

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:
-  - universal
+# 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:
+  - universal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allagents",
-  "version": "1.0.11",
+  "version": "1.0.14",
   "description": "CLI tool for managing multi-repo AI agent workspaces with plugin synchronization",
   "type": "module",
   "bin": {