---
draft: false
title: AgentsMesh — AI Coding Config Sync for Every Tool
description: Open-source AI coding config sync for every major tool — Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex CLI, Windsurf, Cline, and 20+ more. One .agentsmesh source for rules, MCP servers, hooks, skills, agents, project/global config, CI drift checks, packs, plugins, and typed automation.
template: splash
hero:
  tagline: 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.
  image:
    dark: ../../assets/logo-dark.svg
    light: ../../assets/logo-light.svg
  actions:
    - text: Get Started
      link: ./getting-started/installation/
      icon: right-arrow
      variant: primary
    - text: Import Existing Config
      link: ./guides/existing-project/
      icon: document
      variant: secondary
    - text: Supported Tools
      link: ./reference/supported-tools/
      icon: puzzle
      variant: secondary
---

import { Aside, Card, CardGrid } from '@astrojs/starlight/components';
import CatalogExplorer from '../../components/catalog-explorer/CatalogExplorer.astro';
import SoftwareApplicationJsonLd from '../../components/SoftwareApplicationJsonLd.astro';

<section class="am-homepage-catalog" aria-labelledby="community-catalog">
  <h2 id="community-catalog">Community catalog</h2>

  <div class="am-homepage-catalog-intro">Install shared skills, agents, and commands from GitHub, GitLab, git URLs, or local paths with <code>agentsmesh install &lt;source&gt;</code>; list inventory with <code>agentsmesh installs list</code>; remove with <code>agentsmesh uninstall &lt;name&gt;</code>. Packs live in <code>.agentsmesh/packs/</code>, are tracked in <code>.agentsmesh/installs.yaml</code>, and merge with local canonical config during generation. The classifier auto-detects Anthropic-style skill packs and imports skills, agents, references, and per-target commands in one command — see the <a href="./guides/installing-skill-packs/">skill-pack guide</a>.</div>

  <CatalogExplorer />
</section>

<div style="text-align: center; margin: 2rem 0 3rem;">
  <span style="font-size: 1.1rem; color: var(--sl-color-gray-5);">
    Homebrew · standalone binary · npm — pick any &nbsp;·&nbsp; MIT License &nbsp;·&nbsp; CLI + TypeScript API
  </span>
  <br/>
  <div class="am-hero-badges"><img src="https://img.shields.io/npm/v/agentsmesh?style=flat-square" alt="npm version" /><img src="https://img.shields.io/npm/dm/agentsmesh?style=flat-square" alt="npm downloads" /><img src="https://github.com/sampleXbro/agentsmesh/actions/workflows/ci.yml/badge.svg" alt="CI" /><img src="https://img.shields.io/badge/License-MIT-yellow?style=flat-square" alt="License: MIT" /></div>
</div>

## 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](./reference/supported-tools/) 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

<CardGrid>
  <Card title="One .agentsmesh source" icon="pencil">
    Manage AI coding rules, prompts, commands, agents, skills, MCP servers, hooks, ignore files, and permissions from one canonical directory.
  </Card>
  <Card title="Bidirectional migration" icon="sync">
    Import existing Claude Code, Cursor, Copilot, Gemini CLI, Windsurf, Codex CLI, and other configs, then generate them back out with round-trip metadata.
  </Card>
  <Card title="Project and global mode" icon="laptop">
    Commit project config in `.agentsmesh/` for teams, or sync personal AI assistant setup from `~/.agentsmesh/` to user-level tool folders.
  </Card>
  <Card title="MCP, hooks, permissions" icon="setting">
    Standardize high-value assistant capabilities where tools support them natively, with explicit matrix visibility when support is partial or embedded.
  </Card>
  <Card title="CI drift detection" icon="warning">
    Use `agentsmesh diff`, `lint`, `check`, `watch`, and `merge` to keep generated tool files aligned with canonical sources during reviews.
  </Card>
  <Card title="Packs, plugins, typed API" icon="puzzle">
    Share reusable skills and rules with packs, add new AI tools through plugin descriptors, or automate generation from the ESM API.
  </Card>
</CardGrid>

## One canonical directory

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

```bash
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.
```

<Aside type="tip">
  When a target lacks native support for a feature, AgentsMesh can project it into a compatible format and embed metadata so `agentsmesh import` can restore the canonical file later.
</Aside>

## Quick start

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

```bash
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](./getting-started/installation/) for full options. The examples below use the `agentsmesh` binary directly — prefix with `npx` if you installed via `npm` without `-g`.

### New project

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

### Existing project

```bash
agentsmesh import --from cursor
agentsmesh generate
```

### Personal global config

```bash
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.

{/* agentsmesh:tool-list:start */}
- **CLI agents:** [Aider](https://aider.chat), [Amp](https://ampcode.com), [Claude Code](https://www.anthropic.com/claude-code), [Codex CLI](https://github.com/openai/codex), [Crush](https://github.com/charmbracelet/crush), [Deep Agents CLI](https://github.com/langchain-ai/deepagents), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Goose](https://block.github.io/goose), [OpenCode](https://opencode.ai), [Pi Agent](https://github.com/pi-labs/pi-agent), [Qwen Code](https://github.com/QwenLM/qwen-code), [Rovo Dev](https://www.atlassian.com/solutions/devops/rovo-dev), [Warp](https://www.warp.dev).
- **IDE integrations:** [Amazon Q Developer](https://aws.amazon.com/q/developer), [Antigravity](https://antigravity.google), [Augment Code](https://www.augmentcode.com), [Cline](https://cline.bot), [Continue](https://continue.dev), [GitHub Copilot](https://github.com/features/copilot), [Cursor](https://cursor.com), [Junie](https://www.jetbrains.com/junie), [Kilo Code](https://kilocode.ai), [Kiro](https://kiro.dev), [Roo Code](https://roocode.com), [Trae](https://www.trae.ai), [Windsurf](https://windsurf.com), [Zed](https://zed.dev).
- **Cloud agent platforms:** [Factory Droid](https://www.factory.ai), [Jules](https://jules.google), [Replit Agent](https://replit.com).
{/* agentsmesh:tool-list:end */}

Use the [supported tools matrix](./reference/supported-tools/) for the exact project/global paths and native, embedded, partial, or unsupported feature coverage.

## Automation and extension paths

<CardGrid>
  <Card title="Typed programmatic API" icon="seti:typescript">
    Import `generate`, `importFrom`, `lint`, `diff`, `check`, `loadCanonical`, and target catalog helpers from `agentsmesh`, `agentsmesh/engine`, `agentsmesh/canonical`, or `agentsmesh/targets`. [API reference →](./reference/programmatic-api/)
  </Card>
  <Card title="Runtime plugins" icon="puzzle">
    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 →](./guides/building-plugins/)
  </Card>
  <Card title="Team-safe sharing" icon="group">
    Combine `extends`, installable packs, local overrides, and lock-file checks to standardize AI assistant behavior across repositories. [Multi-tool teams →](./guides/multi-tool-teams/)
  </Card>
</CardGrid>

<SoftwareApplicationJsonLd />
