AgentsMesh — AI Coding Config Sync for Every Tool

Sync Cursor rules, Claude Code instructions, Copilot prompts, MCP servers, hooks, skills, agents, and permissions from one .agentsmesh directory. Import existing configs, generate native files, and keep project or global setup drift-free.

Get Started Import Existing Config Supported Tools

Community catalog

Install shared skills, agents, and commands from GitHub, GitLab, git URLs, or local paths. Packs live in .agentsmesh/packs/, are tracked in .agentsmesh/installs.yaml, and merge with local canonical config during generation.

Install skills, agents and commands with ease

Global

Homebrew · standalone binary · npm — pick any · MIT License · CLI + TypeScript API

AI coding config should not drift between tools

Every AI coding assistant ships a different configuration surface. Claude Code reads CLAUDE.md and .claude/settings.json. Cursor uses .cursor/rules/*.mdc. GitHub Copilot reads .github/copilot-instructions.md and prompts. Every other supported tool adds its own files for rules, commands, agents, skills, MCP servers, hooks, ignore patterns, or permissions.

AgentsMesh turns that spread into one editable source of truth. Put the real project instructions in .agentsmesh/, then generate native files for every enabled tool. Import goes the other direction, so existing tool configs can be adopted without starting from scratch.

Most wanted workflows

One .agentsmesh source

Manage AI coding rules, prompts, commands, agents, skills, MCP servers, hooks, ignore files, and permissions from one canonical directory.

Bidirectional migration

Import existing Claude Code, Cursor, Copilot, Gemini CLI, Windsurf, Codex CLI, and other configs, then generate them back out with round-trip metadata.

Project and global mode

Commit project config in .agentsmesh/ for teams, or sync personal AI assistant setup from ~/.agentsmesh/ to user-level tool folders.

MCP, hooks, permissions

Standardize high-value assistant capabilities where tools support them natively, with explicit matrix visibility when support is partial or embedded.

CI drift detection

Use agentsmesh diff, lint, check, watch, and merge to keep generated tool files aligned with canonical sources during reviews.

Packs, plugins, typed API

Share reusable skills and rules with packs, add new AI tools through plugin descriptors, or automate generation from the ESM API.

One canonical directory

.agentsmesh/
  rules/_root.md
  rules/*.md
  commands/*.md
  agents/*.md
  skills/*/SKILL.md
  mcp.json
  hooks.yaml
  permissions.yaml
  ignore

agentsmesh generate
# writes CLAUDE.md, AGENTS.md, .cursor/rules/, .github/copilot-instructions.md,
# .gemini/settings.json, .windsurf/rules/, .codex/config.toml, .kiro/steering/,
# .cline/, .junie/, .roo/, .agents/, and more from the same source.

Quick start

Pick any install method — Homebrew, standalone binary, or npm/pnpm/yarn:

brew install samplexbro/agentsmesh/agentsmesh    # no Node.js required
# or
curl -fsSL https://github.com/sampleXbro/agentsmesh/releases/latest/download/install.sh | sh
# or
npm install -D agentsmesh                        # requires Node.js 20+

See the installation guide for full options. The examples below use the agentsmesh binary directly — prefix with npx if you installed via npm without -g.

New project

agentsmesh init
# edit .agentsmesh/rules/_root.md
agentsmesh generate

Existing project

agentsmesh import --from cursor
agentsmesh generate

Personal global config

agentsmesh init --global
agentsmesh import --global --from claude-code
agentsmesh generate --global

The CLI is available as both agentsmesh and the shorter alias amsh.

Tool coverage and feature matrix

AgentsMesh ships descriptor-driven support for every major AI coding tool plus plugin targets, so coverage can grow without changing the homepage copy.

CLI agents: Aider, Amp, Claude Code, Codex CLI, Crush, Deep Agents CLI, Gemini CLI, Goose, OpenCode, Pi Agent, Qwen Code, Rovo Dev, Warp.
IDE integrations: Amazon Q Developer, Antigravity, Augment Code, Cline, Continue, GitHub Copilot, Cursor, Junie, Kilo Code, Kiro, Roo Code, Trae, Windsurf, Zed.
Cloud agent platforms: Factory Droid, Jules, Replit Agent.

Use the supported tools matrix for the exact project/global paths and native, embedded, partial, or unsupported feature coverage.

Automation and extension paths

Typed programmatic API

Import generate, importFrom, lint, diff, check, loadCanonical, and target catalog helpers from agentsmesh, agentsmesh/engine, agentsmesh/canonical, or agentsmesh/targets. API reference →

Runtime plugins

Add support for new AI coding tools with npm plugin targets. Plugins participate in project mode, global mode, feature conversion, linting, and generation. Build a plugin →

Team-safe sharing

Combine extends, installable packs, local overrides, and lock-file checks to standardize AI assistant behavior across repositories. Multi-tool teams →