JSPM

  • Created
  • Published
  • Downloads 1051
  • Score
    100M100P100Q126477F
  • License MIT

A fast CLI tool to sync AI agent configurations and MCP servers across Claude, Copilot, Cursor, and more using symbolic links.

Package Exports

  • @dallay/agentsync
  • @dallay/agentsync/lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dallay/agentsync) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@dallay/agentsync

npm version
license
repository

Version: 1.14.2
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.

🌟 Explore the Full Documentation Here


✨ Key Features

  • Simple CLI: Manage symbolic links with minimal setup.
  • 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.

🚀 Installation

Make sure you have Node.js (>=18) installed.

pnpm install -g @dallay/agentsync

Using npm:

npm install -g @dallay/agentsync

Using yarn:

yarn global add @dallay/agentsync

Using bun:

bun add -g @dallay/agentsync

Verify installation:

agentsync --help

🛠️ Usage

Managing Configurations

Sync Configurations:

Run the following to create symbolic links across your AI coding assistants:

agentsync apply

Clean Configurations:

Remove previously created symbolic links:

agentsync clean

🎯 Example Workflows:

  • Programmatic Usage in Node.js:

    const { main } = require('@dallay/agentsync');
    
    main(['apply']).catch((error) => {
       console.error(error);
       process.exit(1);
    });
  • Integrate with npm scripts: Add configuration syncing to your npm scripts to automate process workflows. For example, in your package.json:

    {
      "scripts": {
        "precommit": "pnpm exec agentsync apply --dry-run",
        "prepare": "pnpm exec agentsync apply"
      }
    }
  • For complex workflows, see the detailed API documentation.

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

Prerequisites

Steps

  1. Clone the repository:

    git clone https://github.com/dallay/agentsync.git
    cd agentsync
  2. Install dependencies:

    pnpm install
  3. Build:

    pnpm run build
  4. Run type checks:

    pnpm run typecheck

🌐 Resources


📜 License

MIT License. See the LICENSE for details.


🙏 Acknowledgments

Special thanks to the developer community for their contributions and feedback. For suggestions and improvements, feel free to open a pull request!


📣 Ready? Start syncing agent configs today with @dallay/agentsync!