agentsmesh 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +22 -17
- package/LICENSE +1 -1
- package/README.md +44 -44
- package/dist/cli.js +348 -348
- package/dist/cli.js.map +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,17 +1,22 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
All notable changes to this project will be documented in this file.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
7
|
|
|
7
|
-
|
|
8
|
+
## 0.2.1
|
|
8
9
|
|
|
9
|
-
|
|
10
|
+
### Changed
|
|
10
11
|
|
|
11
|
-
|
|
12
|
+
- npm publish now triggers after GitHub release is created, decoupling version tagging from package publishing
|
|
12
13
|
|
|
13
|
-
|
|
14
|
-
|
|
14
|
+
## 0.2.0
|
|
15
|
+
|
|
16
|
+
### Minor Changes
|
|
17
|
+
|
|
18
|
+
- bda10c7: Initial public release of AgentsMesh v0.2.0.
|
|
19
|
+
One canonical `.agentsmesh/` source synced to Claude Code, Cursor, GitHub Copilot, Continue, Junie, Gemini CLI, Cline, Codex CLI, and Windsurf. Includes `init`, `generate`, `import`, `diff`, `lint`, `watch`, `check`, `merge`, `matrix`, and `install` CLI commands with full support for rules, commands, agents, skills, MCP servers, hooks, ignore patterns, permissions, local/remote extends, link rebasing, and lock-file-based collaboration.
|
|
15
20
|
|
|
16
21
|
## [0.1.0] - 2026-03-25
|
|
17
22
|
|
|
@@ -19,14 +24,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
19
24
|
|
|
20
25
|
**CLI commands**
|
|
21
26
|
|
|
22
|
-
- `init` — Scaffold `
|
|
23
|
-
- `generate` — Sync canonical `.
|
|
27
|
+
- `init` — Scaffold `agentsmesh.yaml`, `.agentsmesh/rules/_root.md`, and `agentsmesh.local.yaml`; auto-detect existing AI tool configs in the project
|
|
28
|
+
- `generate` — Sync canonical `.agentsmesh/` to target tool configs; supports `--targets`, `--dry-run`, `--force`, `--refresh-cache`, `--no-cache`
|
|
24
29
|
- `import --from <target>` — Import existing tool configs into canonical form; supports all 9 targets
|
|
25
30
|
- `diff --targets` — Show unified diff of what the next `generate` would change
|
|
26
31
|
- `lint --targets` — Validate canonical files and target-specific constraints with per-feature diagnostics
|
|
27
|
-
- `watch --targets` — Watch `.
|
|
32
|
+
- `watch --targets` — Watch `.agentsmesh/` and regenerate on change with 300 ms debounce; self-generated lock file writes do not retrigger the pipeline
|
|
28
33
|
- `check` — Verify generated files match the lock file; designed for CI drift detection
|
|
29
|
-
- `merge` — Resolve `.
|
|
34
|
+
- `merge` — Resolve `.agentsmesh/.lock` conflicts after a git merge
|
|
30
35
|
- `matrix --targets --verbose` — Show the feature-target compatibility table
|
|
31
36
|
- `install` — Install skills, rules, commands, or agents from a local path or remote GitHub/GitLab/git source; supports `--as`, `--sync`, `--dry-run`, `--force`, `--path`, `--target`, `--name`, `--extends`
|
|
32
37
|
|
|
@@ -40,19 +45,19 @@ rules, commands, agents, skills, mcp, hooks, ignore, permissions
|
|
|
40
45
|
|
|
41
46
|
**Config**
|
|
42
47
|
|
|
43
|
-
- `
|
|
44
|
-
- `
|
|
45
|
-
- `.
|
|
46
|
-
- `.
|
|
48
|
+
- `agentsmesh.yaml` — project config with targets, features, and extends
|
|
49
|
+
- `agentsmesh.local.yaml` — local-only overrides for targets, features, and personal extends (gitignored)
|
|
50
|
+
- `.agentsmesh/` — canonical source directory (source of truth)
|
|
51
|
+
- `.agentsmesh/.lock` — generated-state lock file for `check` and `merge`
|
|
47
52
|
|
|
48
53
|
**Extends**
|
|
49
54
|
|
|
50
55
|
- Local extends (`local:path` or relative path) — merge shared configs from a relative directory
|
|
51
|
-
- Remote extends (`github:org/repo@tag`, `gitlab:group/repo@tag`, `git+ssh://...`) — fetch and cache in `~/.
|
|
56
|
+
- Remote extends (`github:org/repo@tag`, `gitlab:group/repo@tag`, `git+ssh://...`) — fetch and cache in `~/.agentsmesh/cache/`
|
|
52
57
|
|
|
53
58
|
**Link rebasing**
|
|
54
59
|
|
|
55
|
-
Internal `.
|
|
60
|
+
Internal `.agentsmesh/` file references are rewritten to target-relative paths on `generate` and restored to canonical form on `import`, so supporting files and cross-skill links remain correct across all targets
|
|
56
61
|
|
|
57
62
|
**Collaboration**
|
|
58
63
|
|
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
#
|
|
1
|
+
# AgentsMesh
|
|
2
2
|
|
|
3
|
-
[](https://github.com/sampleXbro/agentsmesh/actions/workflows/ci.yml)
|
|
4
|
+
[](https://www.npmjs.com/package/agentsmesh)
|
|
5
|
+
[](https://codecov.io/gh/sampleXbro/agentsmesh)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
[](https://www.typescriptlang.org/)
|
|
8
|
-
[](https://nodejs.org/)
|
|
9
|
+
[](https://www.npmjs.com/package/agentsmesh)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
AgentsMesh gives you one canonical AI config in `.agentsmesh/` and syncs it to the tools your team actually uses: Claude Code, Cursor, Copilot, Continue, Junie, Gemini CLI, Cline, Codex CLI, and Windsurf.
|
|
12
12
|
|
|
13
13
|
The point is simple: keep one source of truth for rules, commands, agents, skills, MCP, hooks, ignore patterns, and permissions, then generate the right format for each tool without hand-editing nine different config layouts.
|
|
14
14
|
|
|
@@ -20,17 +20,17 @@ The point is simple: keep one source of truth for rules, commands, agents, skill
|
|
|
20
20
|
- Keep team changes safe with lock files, drift checks, and merge recovery
|
|
21
21
|
- See support clearly with a built-in compatibility matrix
|
|
22
22
|
- Share base configs across repos with `extends`
|
|
23
|
-
- Keep personal preferences local with `
|
|
23
|
+
- Keep personal preferences local with `agentsmesh.local.yaml`
|
|
24
24
|
- Preserve links and supporting files when content moves between targets
|
|
25
25
|
|
|
26
26
|
## What ships today
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
AgentsMesh already covers the pieces most teams care about in practice:
|
|
29
29
|
|
|
30
30
|
- Rules, commands, agents, skills, MCP servers, hooks, ignore patterns, and permissions
|
|
31
31
|
- Bidirectional import/generate flow across 9 supported targets
|
|
32
32
|
- `diff`, `lint`, `watch`, `check`, `merge`, and `matrix` commands
|
|
33
|
-
- Local overrides with `
|
|
33
|
+
- Local overrides with `agentsmesh.local.yaml`
|
|
34
34
|
- Remote and local `extends` support
|
|
35
35
|
- Lock file based collaboration for generated state
|
|
36
36
|
- Link rebasing so internal file references still make sense after generation
|
|
@@ -57,34 +57,34 @@ Embedded support is deliberate, not a hacky one-way export. For example, Codex c
|
|
|
57
57
|
## Install
|
|
58
58
|
|
|
59
59
|
```bash
|
|
60
|
-
pnpm add -D
|
|
60
|
+
pnpm add -D agentsmesh
|
|
61
61
|
# or
|
|
62
|
-
npm install -D
|
|
62
|
+
npm install -D agentsmesh
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
Requires Node.js 20+. The CLI is available as `
|
|
65
|
+
Requires Node.js 20+. The CLI is available as `agentsmesh` and `agbr`.
|
|
66
66
|
|
|
67
67
|
## Quick start
|
|
68
68
|
|
|
69
69
|
```bash
|
|
70
70
|
# create the canonical scaffold
|
|
71
|
-
|
|
71
|
+
agentsmesh init
|
|
72
72
|
|
|
73
|
-
# sync .
|
|
74
|
-
|
|
73
|
+
# sync .agentsmesh/ to the configured targets
|
|
74
|
+
agentsmesh generate
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
If the repo already has tool-specific config, import it first:
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
|
-
|
|
81
|
-
|
|
80
|
+
agentsmesh import --from cursor
|
|
81
|
+
agentsmesh generate
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
## Canonical layout
|
|
85
85
|
|
|
86
86
|
```text
|
|
87
|
-
.
|
|
87
|
+
.agentsmesh/
|
|
88
88
|
rules/_root.md
|
|
89
89
|
rules/*.md
|
|
90
90
|
commands/*.md
|
|
@@ -94,8 +94,8 @@ agentsbridge generate
|
|
|
94
94
|
permissions.yaml
|
|
95
95
|
hooks.yaml
|
|
96
96
|
ignore
|
|
97
|
-
|
|
98
|
-
|
|
97
|
+
agentsmesh.yaml
|
|
98
|
+
agentsmesh.local.yaml
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
What each part does:
|
|
@@ -108,7 +108,7 @@ What each part does:
|
|
|
108
108
|
- `permissions.yaml`: allow/deny lists
|
|
109
109
|
- `hooks.yaml`: lifecycle hooks
|
|
110
110
|
- `ignore`: shared ignore patterns
|
|
111
|
-
- `
|
|
111
|
+
- `agentsmesh.local.yaml`: local-only overrides that should not be committed
|
|
112
112
|
|
|
113
113
|
## CLI commands
|
|
114
114
|
|
|
@@ -120,15 +120,15 @@ Global flags:
|
|
|
120
120
|
|
|
121
121
|
| Command | What it does | Supported flags |
|
|
122
122
|
| --- | --- | --- |
|
|
123
|
-
| `init` | Create `
|
|
124
|
-
| `generate` | Generate target files from `.
|
|
125
|
-
| `import` | Import an existing tool config into `.
|
|
123
|
+
| `init` | Create `agentsmesh.yaml`, `.agentsmesh/`, `agentsmesh.local.yaml`, and update `.gitignore` | `--yes` |
|
|
124
|
+
| `generate` | Generate target files from `.agentsmesh/` | `--targets`, `--dry-run`, `--check`, `--force`, `--refresh-cache`, `--no-cache` |
|
|
125
|
+
| `import` | Import an existing tool config into `.agentsmesh/` | `--from` |
|
|
126
126
|
| `install` | Install resources from a local/remote source and materialize them as packs or extends | `--sync`, `--dry-run`, `--force`, `--path`, `--target`, `--as`, `--name`, `--extends` |
|
|
127
127
|
| `diff` | Show what the next `generate` would change without writing files | `--targets` |
|
|
128
128
|
| `lint` | Validate canonical files against target constraints | `--targets` |
|
|
129
129
|
| `watch` | Watch canonical files and regenerate on change | `--targets` |
|
|
130
130
|
| `check` | Verify the canonical state still matches the lock file | none |
|
|
131
|
-
| `merge` | Resolve `.
|
|
131
|
+
| `merge` | Resolve `.agentsmesh/.lock` merge conflicts | none |
|
|
132
132
|
| `matrix` | Show feature support for the current config | `--targets`, `--verbose` |
|
|
133
133
|
| `help` | Show command help | n/a (also via global `--help`) |
|
|
134
134
|
| `version` | Show CLI/library version | n/a (also via global `--version`) |
|
|
@@ -136,27 +136,27 @@ Global flags:
|
|
|
136
136
|
Examples:
|
|
137
137
|
|
|
138
138
|
```bash
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
139
|
+
agentsmesh init --yes
|
|
140
|
+
agentsmesh generate --targets cursor,claude-code
|
|
141
|
+
agentsmesh generate --dry-run
|
|
142
|
+
agentsmesh generate --check
|
|
143
|
+
agentsmesh generate --refresh-cache
|
|
144
|
+
agentsmesh import --from codex-cli
|
|
145
|
+
agentsmesh install github:org/repo@main --path skills --as skills
|
|
146
|
+
agentsmesh diff --targets windsurf
|
|
147
|
+
agentsmesh lint
|
|
148
|
+
agentsmesh watch
|
|
149
|
+
agentsmesh check
|
|
150
|
+
agentsmesh merge
|
|
151
|
+
agentsmesh matrix --verbose
|
|
152
|
+
agentsmesh --help
|
|
153
|
+
agentsmesh --version
|
|
154
154
|
```
|
|
155
155
|
|
|
156
156
|
## Features worth knowing about
|
|
157
157
|
|
|
158
158
|
- `extends` can pull shared config from a local folder, GitHub release, GitLab repo, or generic git remote
|
|
159
|
-
- `
|
|
159
|
+
- `agentsmesh.local.yaml` lets one developer narrow targets or disable conversions without changing the shared project config
|
|
160
160
|
- Conversion controls let you turn off projected command-to-skill or agent-to-skill mappings per target
|
|
161
161
|
- `watch` ignores its own lock-file writes, so generation does not loop on itself
|
|
162
162
|
- `check` and `merge` are built for team workflows, not just solo local use
|
|
@@ -195,7 +195,7 @@ This section is planned work, not current functionality.
|
|
|
195
195
|
- `convert` for direct tool-to-tool conversion
|
|
196
196
|
- Ephemeral generation mode (`--stdout`, temp output)
|
|
197
197
|
- Plugin system for custom targets
|
|
198
|
-
- JSON Schema for `
|
|
198
|
+
- JSON Schema for `agentsmesh.yaml`
|
|
199
199
|
|
|
200
200
|
### Tier 3
|
|
201
201
|
|
|
@@ -219,4 +219,4 @@ pnpm format:check
|
|
|
219
219
|
|
|
220
220
|
## Contributing
|
|
221
221
|
|
|
222
|
-
Keep changes small, verify them, and prefer updating the canonical `.
|
|
222
|
+
Keep changes small, verify them, and prefer updating the canonical `.agentsmesh/` source over editing generated target files by hand.
|