AgentsMesh maintains a single canonical configuration in .agentsmesh/ and syncs it bidirectionally to Claude Code, Cursor, Copilot, Continue, Junie, Gemini CLI, Cline, Codex CLI, Windsurf, Antigravity, and Roo Code. Rules, commands, agents, skills, MCP servers, hooks, ignore patterns, and permissions -- all from one source of truth.
Full documentation: samplexbro.github.io/agentsmesh
- One source of truth -- edit
.agentsmesh/, generate everywhere. No more copy-pasting rules between tool directories. - Bidirectional sync -- import existing configs into canonical form and generate back out. No data loss, no manual reformatting.
- Team-safe collaboration -- lock files track generated state,
checkcatches drift in CI,mergeresolves conflicts aftergit merge. - Lossless feature projection -- when a tool lacks native support for a feature, AgentsMesh projects it as an embedded skill with enough metadata to round-trip on re-import.
Requires Node.js 20 or later.
# npm
npm install -D agentsmesh
# pnpm
pnpm add -D agentsmesh
# yarn
yarn add -D agentsmesh
# or run directly
npx agentsmesh --helpThe CLI is available as both agentsmesh and amsh.
# Scaffold the canonical config directory
agentsmesh init
# Edit your root rule
# vi .agentsmesh/rules/_root.md
# Generate configs for all enabled targets
agentsmesh generate# Import your existing Cursor config (or any supported tool)
agentsmesh import --from cursor
# Generate output for all configured targets
agentsmesh generateThat's it. Your .agentsmesh/ directory is now the single source of truth, and the generated files for each tool stay in sync with it.
| Feature | Claude Code | Cursor | Copilot | Gemini CLI | Cline | Codex CLI | Windsurf | Continue | Junie | Antigravity | Roo Code |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Rules | Native | Native | Native | Native | Native | Native | Native | Native | Native | Native | Native |
| Commands | Native | Native | Native | Native | Native | Embedded | Native | Embedded | Embedded | Partial | Native |
| Agents | Native | Native | Native | Native | Embedded | Native | Embedded | -- | Embedded | -- | -- |
| Skills | Native | Native | Native | Native | Native | Native | Native | Embedded | Embedded | Native | Native |
| MCP Servers | Native | Native | -- | Native | Native | Native | Partial | Native | Native | -- | Native |
| Hooks | Native | Native | Partial | Partial | -- | -- | Native | -- | -- | -- | -- |
| Ignore | Native | Native | -- | Native | Native | -- | Native | -- | Native | -- | Native |
| Permissions | Native | Partial | -- | Partial | -- | -- | -- | -- | -- | -- | -- |
See the full feature matrix docs for details on native vs. embedded support.
Note: The canonical root rule always lives at .agentsmesh/rules/_root.md. Some targets write that content to a tool-specific main file named general (for example .continue/rules/general.md and .agents/rules/general.md for Antigravity) instead of _root.md on disk.
The documentation site covers everything in detail:
- Getting Started -- installation, quick start
- Canonical Config -- rules, commands, agents, skills, MCP, hooks, ignore, permissions
- CLI Reference -- all commands: init, generate, import, install, diff, lint, watch, check, merge, matrix
- Configuration -- agentsmesh.yaml, local overrides, extends, collaboration, conversions
- Guides -- adopting in existing projects, multi-tool teams, sharing config, CI drift detection, community packs
- Reference -- how the generation pipeline works
See ROADMAP.md for planned features and release timeline.
Contributions are welcome. Keep changes small, test them, and prefer editing canonical .agentsmesh/ sources over generated files.
pnpm install
pnpm build
pnpm test
pnpm lint
pnpm typecheck