Skip to content

AgentsMesh — One Config. Every Target.

One canonical source of truth under .agentsmesh/ — import native tool configs, generate target outputs, and keep teams aligned. Which features map how for each tool is documented in the supported tools matrix.

Requires Node.js 20+  ·  MIT License  ·  Zero runtime dependencies


npm versionnpm downloadsCILicense: MIT

The Problem

Every AI coding assistant has its own config layout and filenames. Change a rule in one place and forget the others, and behavior drifts between editors and workflows.

Scale that across a team where people use different tools — and keeping instructions, skills, and automation aligned becomes a maintenance problem.

The Solution

Terminal window
# One directory, all your AI tool config
.agentsmesh/
rules/_root.md # ← edit here
commands/*.md
agents/*.md
skills/*/SKILL.md
mcp.json
hooks.yaml
permissions.yaml
ignore
Terminal window
# Generate outputs for every target in your config
agentsmesh generate

Why AgentsMesh

One Source of Truth

Edit .agentsmesh/, generate everywhere. No more copy-pasting rules between tool directories. No more drift.

Bidirectional Sync

Import existing tool configs into canonical form, then generate back out. Lossless round-trip — no manual reformatting.

CI Drift Detection

agentsmesh check exits with code 1 if generated files have drifted from the lock. Catch drift in PRs before it ships.

Lossless Projection

When a tool lacks native support for a feature, AgentsMesh embeds it with enough metadata to round-trip on re-import. No data loss.

Team-Safe Collaboration

Lock files track generated state. agentsmesh merge resolves conflicts after git merge. Collaboration settings prevent accidental overrides.

Real Operational Tooling

diff, lint, watch, check, merge, and matrix are first-class commands — not afterthoughts.

Tool compatibility

Targets differ in what they support natively versus what AgentsMesh embeds or projects for round-trip import. The supported tools matrix is the source of truth for rules, commands, agents, skills, MCP, hooks, ignore patterns, and permissions — per tool, with the full legend.

For a generated view from your local install, run agentsmesh matrix and compare with the docs matrix when upgrading.

Quick Start

Terminal window
# Install
npm install -D agentsmesh
# Scaffold the canonical directory
npx agentsmesh init
# Edit your root rule
# vi .agentsmesh/rules/_root.md
# Generate for all configured targets
npx agentsmesh generate

Already have tool configs? Import them first:

Terminal window
npx agentsmesh import --from cursor
npx agentsmesh import --from claude-code
npx agentsmesh generate