@dallay/agentsync 1.14.5 → 1.20.0

package/README.md

@@ -4,7 +4,7 @@
 [![license](https://img.shields.io/npm/l/@dallay/agentsync.svg)](https://github.com/dallay/agentsync/blob/main/LICENSE)  
 [![repository](https://img.shields.io/badge/repo-dallay%2Fagentsync-blue)](https://github.com/dallay/agentsync)  
 
-**Version:** 1.14.2  
+**Version:** 1.19.0
 **License:** MIT  
 
 Effortlessly synchronize AI agent configurations across tools like Copilot, Claude, Cursor, and other MCP-compatible servers using symbolic links and an intuitive CLI.
@@ -16,7 +16,8 @@ Effortlessly synchronize AI agent configurations across tools like Copilot, Clau
 ## ✨ Key Features
 
 - **Simple CLI**: Manage symbolic links with minimal setup.
-- **Multi-assistant support**: Compatible across Copilot, Claude, Gemini, and more.
+- **Multi-assistant support**: Compatible across Copilot, Claude, Gemini, Cursor, VS Code and OpenCode.
+    See the full list and file locations in the main documentation: https://dallay.github.io/agentsync/ (or the repo README).
 - **Cross-platform binaries**: Available for Linux, MacOS, and Windows.
 - **Node.js integration**: Use programmatically within your applications.
 
@@ -27,26 +28,31 @@ Effortlessly synchronize AI agent configurations across tools like Copilot, Clau
 Make sure you have Node.js (>=18) installed.
 
 ### Using `pnpm` (recommended):
+
 ```bash
 pnpm install -g @dallay/agentsync
 ```
 
 ### Using `npm`:
+
 ```bash
 npm install -g @dallay/agentsync
 ```
 
 ### Using `yarn`:
+
 ```bash
 yarn global add @dallay/agentsync
 ```
 
 ### Using `bun`:
+
 ```bash
 bun add -g @dallay/agentsync
 ```
 
 Verify installation:
+
 ```bash
 agentsync --help
 ```
@@ -58,13 +64,17 @@ agentsync --help
 ### Managing Configurations
 
 #### Sync Configurations:
+
 Run the following to create symbolic links across your AI coding assistants:
+
 ```bash
 agentsync apply
 ```
 
 #### Clean Configurations:
+
 Remove previously created symbolic links:
+
 ```bash
 agentsync clean
 ```
@@ -72,6 +82,7 @@ agentsync clean
 🎯 **Example Workflows**:
 
 - **Programmatic Usage in Node.js**:
+
    ```javascript
    const { main } = require('@dallay/agentsync');
 
@@ -84,6 +95,7 @@ agentsync clean
 - **Integrate with npm scripts**:
    Add configuration syncing to your npm scripts to automate process workflows.
    For example, in your `package.json`:
+
    ```json
    {
      "scripts": {
@@ -95,36 +107,76 @@ agentsync clean
 
 - For complex workflows, see the [detailed API documentation](https://dallay.github.io/agentsync/).
 
+## MCP & Skills
+
+- AgentSync supports MCP generation for multiple agents (Claude, Copilot, Gemini, Cursor, VS Code, OpenCode). The canonical list and file locations live in the repo README and in the docs site (guides/mcp).
+- Skills live under `.agents/skills/` in the project. See the repository README for an example SKILL.md path and the `specs/001-skills-sh-integration` directory for ongoing work around skills integrations.
+
 ---
 
 ## 👷 Development
 
+This package is part of the [AgentSync mono-repo](https://github.com/dallay/agentsync). It serves as a Node.js wrapper for the high-performance Rust core.
+
 ### Prerequisites
+
 - [pnpm](https://pnpm.io/): Dependency manager.
-- [Node.js](https://nodejs.org/) >= 18.
+- [Node.js](https://nodejs.org/) >= 24.13.0 (for development).
+- [Rust](https://www.rust-lang.org/): For building the core CLI.
 
 ### Steps
+
 1. Clone the repository:
+
    ```bash
    git clone https://github.com/dallay/agentsync.git
    cd agentsync
    ```
 
 2. Install dependencies:
+
    ```bash
    pnpm install
    ```
 
 3. Build:
+
    ```bash
+   make js-build
+   # or
    pnpm run build
    ```
 
-4. Run type checks:
+4. Run tests and type checks:
+
    ```bash
+   make js-test
+   # or
    pnpm run typecheck
    ```
 
+5. Format:
+
+   ```bash
+   make fmt
+   ```
+
+---
+
+## 🛠️ Troubleshooting
+
+### `PNPM_NO_MATURE_MATCHING_VERSION`
+
+If `pnpm install` fails with this error, it's likely due to a strict package release age policy. You can try installing with `--ignore-scripts` or wait for the package to "mature" in the registry.
+
+### Lefthook installation failure
+
+If `pnpm install` fails during the `lefthook` setup, you can try:
+
+```bash
+pnpm install --ignore-scripts
+```
+
 ---
 
 ## 🌐 Resources

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dallay/agentsync",
-  "version": "1.14.5",
+  "version": "1.20.0",
   "description": "A fast CLI tool to sync AI agent configurations and MCP servers across Claude, Copilot, Cursor, and more using symbolic links.",
   "author": "Yuniel Acosta <yunielacosta738@gmail.com>",
   "license": "MIT",
@@ -41,12 +41,12 @@
     "typescript": "^5.9.3"
   },
   "optionalDependencies": {
-    "@dallay/agentsync-linux-x64": "1.14.5",
-    "@dallay/agentsync-linux-arm64": "1.14.5",
-    "@dallay/agentsync-darwin-x64": "1.14.5",
-    "@dallay/agentsync-darwin-arm64": "1.14.5",
-    "@dallay/agentsync-windows-x64": "1.14.5",
-    "@dallay/agentsync-windows-arm64": "1.14.5"
+    "@dallay/agentsync-linux-x64": "1.20.0",
+    "@dallay/agentsync-linux-arm64": "1.20.0",
+    "@dallay/agentsync-darwin-x64": "1.20.0",
+    "@dallay/agentsync-darwin-arm64": "1.20.0",
+    "@dallay/agentsync-windows-x64": "1.20.0",
+    "@dallay/agentsync-windows-arm64": "1.20.0"
   },
   "engines": {
     "node": ">=18"