AgentsMesh

One config for every AI coding tool, with a shared memory that learns from your repo.

Every AI coding assistant reads its own config: CLAUDE.md, AGENTS.md, .cursor/rules/*.mdc, .github/copilot-instructions.md, .gemini/settings.json, and more. Keeping rules, prompts, MCP servers, hooks, and permissions the same across Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex CLI, and the rest by hand does not scale, and the copies drift.

AgentsMesh makes .agentsmesh/ the one source. Write rules, commands, agents, skills, MCP servers, hooks, ignore patterns, and permissions once. agentsmesh generate writes every tool's native files, agentsmesh import pulls existing configs back in without loss, and agentsmesh check fails CI when anything drifts.

Your agents learn from your repo. Lessons give every agent, in every tool, one git-tracked memory: capture a rule after a failure, recall it before the next edit. Same mistake, never twice.

Every method ships the same CLI (agentsmesh, alias amsh). The npm package also exposes the TypeScript API.

# Homebrew (macOS / Linux), no Node.js required
brew install samplexbro/agentsmesh/agentsmesh

# Standalone binary (Linux / macOS), no Node.js required
# Windows: download agentsmesh-windows-x64.exe from GitHub Releases
curl -fsSL https://github.com/sampleXbro/agentsmesh/releases/latest/download/install.sh | sh

# npm / pnpm / yarn, requires Node.js 20+
npm install -g agentsmesh     # or: pnpm add -g agentsmesh / yarn global add agentsmesh
npm install -D agentsmesh     # pin per repo as a dev dependency, then run with npx

Binaries with SHA-256 checksums are on GitHub Releases.

agentsmesh init       # detect and import existing tool configs, or scaffold fresh
agentsmesh generate   # write each tool's native config from the one source
agentsmesh check      # CI drift gate against .agentsmesh/.lock

On a terminal, init runs a short wizard: pick targets, import detected configs (.cursor/, .claude/, .github/copilot-instructions.md, and more), enable lessons, and optionally generate right away. Nothing is written until you finish. Use --yes for the non-interactive default, --global for your user-level config under ~/.agentsmesh/, and npx agentsmesh if you installed it as a dev dependency.

# Before: one copy of the same intent per tool
CLAUDE.md
AGENTS.md
.cursor/rules/*.mdc
.github/copilot-instructions.md
.gemini/settings.json
.windsurf/rules/*.md
.codex/config.toml
.kiro/steering/*.md

# After: one canonical source, generated everywhere
.agentsmesh/
  rules/_root.md      # the root rule every tool projects
  commands/           # reusable slash-style prompts
  agents/             # agent definitions
  skills/             # composable skills with supporting files
  mcp.json            # MCP server definitions
  hooks.yaml          # pre/post tool hooks
  permissions.yaml    # allow/deny rules
  ignore              # paths the assistant must not touch
  lessons/            # optional shared agent memory

agentsmesh.yaml selects targets and features, agentsmesh.local.yaml holds per-developer overrides (gitignored), and .agentsmesh/.lock records the checksums that check enforces. Cross-file links are rewritten to each tool's own paths on the way out.

No other config-sync tool has this. Lessons are a memory of past mistakes that every agent reads before it acts and writes after something goes wrong, so a lesson one agent learns today helps every teammate's agent tomorrow, in any tool.

The memory is one git-tracked file, .agentsmesh/lessons/lessons.json, driven by two commands:

# After a failure, the agent writes the rule down with a trigger:
agentsmesh lessons add "Normalize CLI display paths to forward slashes" \
  --topic windows-paths --trigger-file "src/cli/**/*.ts"

# Before the next edit, any agent in any tool recalls it:
agentsmesh lessons query --file src/cli/output.ts --session auto
# -> "Normalize CLI display paths to forward slashes"

agentsmesh init --lessons wires the loop once: an always-on rule in _root.md, a lessons skill where supported, recall and capture hooks on hook-capable tools, and matching MCP tools (lessons_query, lessons_add) for agents without shell access. Rules can be scoped by file, command, or keyword, or always-on with --scope always.

Full walkthrough: Teach your AI agents with lessons · agentsmesh lessons reference

Most sync tools stop at copying rule files into each assistant's folder. AgentsMesh also round-trips losslessly, rebases cross-tool links, lints before a tool would silently drop content, and lets anyone add a new tool as a plugin.

_{Reflects the public projects as of June 2026. Sources and detail in the alternatives guide; corrections welcome.}

Built to be depended on: 12,000+ tests on Linux, macOS, and Windows CI, JSON-Schema-validated configs, npm releases with provenance, and a per-file coverage floor in the test gate.

• Lossless two-way sync. When a tool has no native slot for a feature, it is embedded with round-trip metadata instead of dropped. Managed embedding
• Automatic link rebasing. .agentsmesh/skills/api-gen/template.hbs becomes .claude/skills/... or .cursor/skills/... in each generated file. Generation pipeline
• Safe adoption. import, then diff, then generate, then check; nothing is overwritten blind. Existing-project guide
• Migrate between tools. convert --from <a> --to <b> rewrites one tool's config directly into another's. convert
• Global mode. ~/.agentsmesh/ syncs personal config to ~/.claude/, ~/.cursor/, ~/.codex/, and more; config commands accept --global. Global paths
• CI-ready. check gates drift, diff previews, merge rebuilds the lock after a Git conflict, and lint warns about content a tool would mishandle. check · lint
• Community packs and extends. Install rules, skills, agents, and commands from any git repo; hooks, permissions, and MCP from remote sources stay off until you opt in. install
• Plugins. Ship a new tool as an npm package with full parity to built-in targets. Build a plugin
• Schema-validated configs. Every config ships a JSON Schema for editor autocomplete. JSON schemas
• Scriptable. A typed API for generate, import, lint, diff, and check, --json envelopes on every command except watch, and an MCP server so agents can operate the config themselves. API · MCP server

Run agentsmesh <command> --help for flags, or see the CLI reference.

AgentsMesh generates native config for every major AI coding assistant, plus plugin targets. Native, embedded, and partial support per feature is tracked in the supported-tools matrix.

• CLI agents: Aider, Amp, Claude Code, Codebuff, Codex CLI, Crush, Deep Agents CLI, Gemini CLI, Goose, Kimi Code CLI, OpenCode, OpenHands, 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.

• Getting started: install and first run
• Canonical config: rules, commands, agents, skills, MCP, hooks, ignore, permissions
• CLI reference: every command and flag
• Guides: adopting in an existing repo, lessons, sharing config, plugins
• Reference: supported tools, generation pipeline, managed embedding, API

Contributions welcome: edit canonical .agentsmesh/ sources, never the generated files. See CONTRIBUTING.md. Released under the MIT license.