@event4u/agent-config 2.2.0 → 2.2.2
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/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +30 -1
- package/docs/DISTRIBUTION_CHECKLIST.md +7 -6
- package/docs/decisions/ADR-007-agent-discovery-scopes.md +8 -0
- package/docs/getting-started.md +1 -1
- package/docs/installation.md +26 -26
- package/docs/setup/per-ide/aider.md +1 -1
- package/docs/setup/per-ide/claude-code.md +1 -1
- package/docs/setup/per-ide/cline.md +2 -2
- package/docs/setup/per-ide/codex.md +1 -1
- package/docs/setup/per-ide/copilot.md +2 -2
- package/docs/setup/per-ide/cursor.md +2 -2
- package/docs/setup/per-ide/gemini-cli.md +1 -1
- package/docs/setup/per-ide/windsurf.md +2 -2
- package/docs/troubleshooting.md +4 -4
- package/package.json +1 -1
- package/scripts/agent-config +16 -1
- package/scripts/install +7 -6
- package/scripts/install.py +10 -3
- package/templates/agent-config-wrapper.sh +1 -1
- package/templates/consumer-settings/README.md +1 -1
- package/templates/marketing-copy.yml +6 -5
package/CHANGELOG.md
CHANGED
|
@@ -11,7 +11,15 @@ versioning policy is documented in [CONTRIBUTING.md](CONTRIBUTING.md#versioning-
|
|
|
11
11
|
|
|
12
12
|
Four roadmaps land in this release.
|
|
13
13
|
|
|
14
|
-
**
|
|
14
|
+
**Package consolidation** — the standalone wrapper package
|
|
15
|
+
`@event4u/create-agent-config` is retired. `npx @event4u/agent-config init`
|
|
16
|
+
is now the canonical one-shot entrypoint; the bundle package gains an
|
|
17
|
+
`init` subcommand that delegates to `scripts/install`. `packages/create-agent-config/`
|
|
18
|
+
is removed from the repo, and every doc / template / help string is
|
|
19
|
+
updated to the new command. Existing users running the old wrapper
|
|
20
|
+
should switch — the old package name will stop receiving releases.
|
|
21
|
+
|
|
22
|
+
**Global-First Install (R4)** — `npx @event4u/agent-config init`
|
|
15
23
|
now defaults to a **global** install (`~/.claude/`, `~/.cursor/`, …)
|
|
16
24
|
when run outside a project, and a **project** install when run inside
|
|
17
25
|
one. A new global lockfile at `~/.config/agent-config/installed.lock`
|
|
@@ -335,6 +343,27 @@ our recommendation order, not its support status.
|
|
|
335
343
|
users" tension without removing any path that an existing user
|
|
336
344
|
might rely on.
|
|
337
345
|
|
|
346
|
+
## [2.2.2](https://github.com/event4u-app/agent-config/compare/2.2.1...2.2.2) (2026-05-12)
|
|
347
|
+
|
|
348
|
+
### Bug Fixes
|
|
349
|
+
|
|
350
|
+
* allow --global installs from agent-config source repo ([1be1b44](https://github.com/event4u-app/agent-config/commit/1be1b4429e8fa3ff3fb2981a1368138aa34186ac))
|
|
351
|
+
|
|
352
|
+
Tests: 3350 (+0 since 2.2.1)
|
|
353
|
+
|
|
354
|
+
## [2.2.1](https://github.com/event4u-app/agent-config/compare/2.2.0...2.2.1) (2026-05-12)
|
|
355
|
+
|
|
356
|
+
### Documentation
|
|
357
|
+
|
|
358
|
+
* changelog + ADR-007 note for package consolidation ([1d0d6fb](https://github.com/event4u-app/agent-config/commit/1d0d6fb8882431ee11a6b034f6157ae9f8ccea4d))
|
|
359
|
+
* update install commands to npx @event4u/agent-config init ([b9956c6](https://github.com/event4u-app/agent-config/commit/b9956c6ff827433bff7dc9aa1f40ba3454ef5154))
|
|
360
|
+
|
|
361
|
+
### Chores
|
|
362
|
+
|
|
363
|
+
* consolidate npm package into @event4u/agent-config init ([d3188ce](https://github.com/event4u-app/agent-config/commit/d3188ced3edac5b670b68e22f51295ef831471d6))
|
|
364
|
+
|
|
365
|
+
Tests: 3350 (+0 since 2.2.0)
|
|
366
|
+
|
|
338
367
|
## [2.2.0](https://github.com/event4u-app/agent-config/compare/2.1.0...2.2.0) (2026-05-12)
|
|
339
368
|
|
|
340
369
|
### Features
|
|
@@ -74,21 +74,22 @@ are not roadmap steps.
|
|
|
74
74
|
- **Notes:** **Do not submit before the gate.** Premature listing
|
|
75
75
|
produces a bad first impression and is hard to retract.
|
|
76
76
|
|
|
77
|
-
### npm: `@event4u/
|
|
77
|
+
### npm: `@event4u/agent-config`
|
|
78
78
|
|
|
79
79
|
- **Status:** Prepared
|
|
80
80
|
- **Owner:** maintainer
|
|
81
81
|
- **Last Reviewed:** 2026-05-12
|
|
82
|
-
- **Substrate:**
|
|
83
|
-
|
|
84
|
-
`scripts/install`, then deletes the temp dir.
|
|
82
|
+
- **Substrate:** root `package.json` — `bin: scripts/agent-config` exposes
|
|
83
|
+
`init`, `sync`, `validate`, `mcp:render`, `roadmap:progress`, …
|
|
85
84
|
- **Doc anchor:** [`docs/installation.md`](installation.md) §
|
|
86
85
|
"npx one-liner".
|
|
87
|
-
- **Action:**
|
|
86
|
+
- **Action:** routine releases auto-publish via `publish-npm.yml` on tag
|
|
87
|
+
push; manual fallback is `npm publish --access public` after
|
|
88
|
+
`task npm:login`.
|
|
88
89
|
- **Pre-conditions:** npm registry credentials for the `@event4u`
|
|
89
90
|
scope.
|
|
90
91
|
- **Notes:** Public scope, MIT-licensed. Verify `npx
|
|
91
|
-
@event4u/
|
|
92
|
+
@event4u/agent-config init` in an empty directory before
|
|
92
93
|
declaring Live.
|
|
93
94
|
|
|
94
95
|
### GitHub repo topics + tagline
|
|
@@ -10,6 +10,14 @@ phase: post-v2.1.0 · simplicity-and-everywhere
|
|
|
10
10
|
|
|
11
11
|
# ADR-007 — Agent Discovery Scopes: Global-Default Install Model
|
|
12
12
|
|
|
13
|
+
> **Note (post-acceptance):** the one-shot installer command was later
|
|
14
|
+
> renamed from `npx @event4u/create-agent-config init` to
|
|
15
|
+
> `npx @event4u/agent-config init` when the standalone wrapper package
|
|
16
|
+
> was retired. References to the old command name below are preserved
|
|
17
|
+
> for historical accuracy; the discovery-scope decision itself is
|
|
18
|
+
> unchanged. See `CHANGELOG.md` → `[Unreleased]` → "Package
|
|
19
|
+
> consolidation".
|
|
20
|
+
|
|
13
21
|
## Status
|
|
14
22
|
|
|
15
23
|
**Accepted** · 2026-05-12 · signed off by Matze after Council Round 3 convergence. Implementation tracked in `agents/roadmaps/road-to-global-first-install.md`.
|
package/docs/getting-started.md
CHANGED
|
@@ -10,7 +10,7 @@ Pick one entrypoint:
|
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
12
|
# Recommended — one-shot, no local dependency
|
|
13
|
-
npx @event4u/
|
|
13
|
+
npx @event4u/agent-config init --tools=claude-code,cursor
|
|
14
14
|
|
|
15
15
|
# No-Node fallback — curl | bash entrypoint (downloads a tarball)
|
|
16
16
|
curl -sSL https://raw.githubusercontent.com/event4u-app/agent-config/main/setup.sh | bash
|
package/docs/installation.md
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
committed to a repo. No Task, no Make, no build tools required.
|
|
6
6
|
|
|
7
7
|
> **v2.1+** — the installer detects intent. Running `npx
|
|
8
|
-
> @event4u/
|
|
8
|
+
> @event4u/agent-config init` in `~/` or any directory without a
|
|
9
9
|
> project manifest defaults to **global**. Running it inside a project
|
|
10
10
|
> (`package.json` / `composer.json` / `pyproject.toml` / etc.) defaults
|
|
11
11
|
> to **project**. Pass `--scope=global` or `--scope=project` to override
|
|
@@ -13,7 +13,7 @@ committed to a repo. No Task, no Make, no build tools required.
|
|
|
13
13
|
|
|
14
14
|
A global install records itself in `~/.config/agent-config/installed.lock`
|
|
15
15
|
(schema_version, agent_config_version, installed_at, tools[]). `npx
|
|
16
|
-
@event4u/
|
|
16
|
+
@event4u/agent-config update` keeps that manifest in lockstep
|
|
17
17
|
with the project pin in `.agent-settings.yml`. A version-mismatched
|
|
18
18
|
re-run of `init --scope=global` is refused with exit code 1 until you
|
|
19
19
|
`update` or pass `--force`.
|
|
@@ -37,16 +37,16 @@ section below this index is reference material for advanced installs
|
|
|
37
37
|
|
|
38
38
|
| Surface | One-liner | Per-IDE page |
|
|
39
39
|
|---|---|---|
|
|
40
|
-
| **Claude Code** | `npx @event4u/
|
|
40
|
+
| **Claude Code** | `npx @event4u/agent-config init --tools=claude-code` | [`per-ide/claude-code.md`](setup/per-ide/claude-code.md) |
|
|
41
41
|
| **Claude Desktop** | (uses `~/.claude/skills/` from Claude Code global install) | [`per-ide/claude-desktop.md`](setup/per-ide/claude-desktop.md) |
|
|
42
|
-
| **Cursor** | `npx @event4u/
|
|
43
|
-
| **Windsurf** | `npx @event4u/
|
|
44
|
-
| **Cline** | `npx @event4u/
|
|
45
|
-
| **Aider** | `npx @event4u/
|
|
46
|
-
| **Codex CLI** | `npx @event4u/
|
|
47
|
-
| **Gemini CLI** | `npx @event4u/
|
|
48
|
-
| **GitHub Copilot** | `npx @event4u/
|
|
49
|
-
| **All surfaces** | `npx @event4u/
|
|
42
|
+
| **Cursor** | `npx @event4u/agent-config init --tools=cursor` | [`per-ide/cursor.md`](setup/per-ide/cursor.md) |
|
|
43
|
+
| **Windsurf** | `npx @event4u/agent-config init --tools=windsurf` | [`per-ide/windsurf.md`](setup/per-ide/windsurf.md) |
|
|
44
|
+
| **Cline** | `npx @event4u/agent-config init --tools=cline` | [`per-ide/cline.md`](setup/per-ide/cline.md) |
|
|
45
|
+
| **Aider** | `npx @event4u/agent-config init --tools=aider` | [`per-ide/aider.md`](setup/per-ide/aider.md) |
|
|
46
|
+
| **Codex CLI** | `npx @event4u/agent-config init --tools=codex` | [`per-ide/codex.md`](setup/per-ide/codex.md) |
|
|
47
|
+
| **Gemini CLI** | `npx @event4u/agent-config init --tools=gemini` | [`per-ide/gemini-cli.md`](setup/per-ide/gemini-cli.md) |
|
|
48
|
+
| **GitHub Copilot** | `npx @event4u/agent-config init --tools=copilot` | [`per-ide/copilot.md`](setup/per-ide/copilot.md) |
|
|
49
|
+
| **All surfaces** | `npx @event4u/agent-config init` (default) | (each page above applies) |
|
|
50
50
|
|
|
51
51
|
Combine surfaces by comma-separating: `--tools=claude-code,cursor,windsurf`.
|
|
52
52
|
|
|
@@ -106,7 +106,7 @@ the per-IDE index above.
|
|
|
106
106
|
> 2. `scripts/install.py` — bridge files (`.agent-settings.yml`, VSCode /
|
|
107
107
|
> Augment / Copilot JSON descriptors).
|
|
108
108
|
>
|
|
109
|
-
> `npx @event4u/
|
|
109
|
+
> `npx @event4u/agent-config init` and `setup.sh` (curl-based)
|
|
110
110
|
> are thin wrappers that delegate to `scripts/install`. Both underlying
|
|
111
111
|
> stages remain callable directly for advanced use; see their `--help`.
|
|
112
112
|
>
|
|
@@ -148,23 +148,23 @@ same flags, no extra state.
|
|
|
148
148
|
|
|
149
149
|
```bash
|
|
150
150
|
# Pick tools interactively (TTY checkbox prompt)
|
|
151
|
-
npx @event4u/
|
|
151
|
+
npx @event4u/agent-config init
|
|
152
152
|
|
|
153
153
|
# Pick tools explicitly, non-interactive
|
|
154
|
-
npx @event4u/
|
|
154
|
+
npx @event4u/agent-config init --tools=claude-code,cursor --yes
|
|
155
155
|
|
|
156
156
|
# Install everything (the default — backward-compatible)
|
|
157
|
-
npx @event4u/
|
|
157
|
+
npx @event4u/agent-config init --tools=all --yes
|
|
158
158
|
|
|
159
159
|
# Test a specific git ref (branch, tag, sha) instead of the latest npm tag
|
|
160
|
-
npx @event4u/
|
|
160
|
+
npx @event4u/agent-config init --ref=main --yes
|
|
161
161
|
```
|
|
162
162
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
163
|
+
`npx @event4u/agent-config init` fetches the latest tarball, runs
|
|
164
|
+
`bash scripts/install --target <cwd> …`, and the install script handles
|
|
165
|
+
its own cleanup. The same package exposes every other `agent-config`
|
|
166
|
+
subcommand (`sync`, `validate`, `mcp:render`, `roadmap:progress`, …) —
|
|
167
|
+
see `npx @event4u/agent-config help`.
|
|
168
168
|
|
|
169
169
|
### `curl | bash` (no Node required)
|
|
170
170
|
|
|
@@ -202,12 +202,12 @@ The package is versioned with the project. Settings are committed once.
|
|
|
202
202
|
### npx (recommended for any project)
|
|
203
203
|
|
|
204
204
|
```bash
|
|
205
|
-
npx @event4u/
|
|
205
|
+
npx @event4u/agent-config init --tools=claude-code,cursor
|
|
206
206
|
```
|
|
207
207
|
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
208
|
+
`npx` fetches the latest `@event4u/agent-config` tarball and runs
|
|
209
|
+
`scripts/install` with the selected tools. Nothing is added to
|
|
210
|
+
`package.json`.
|
|
211
211
|
|
|
212
212
|
### Global CLI (one install per machine)
|
|
213
213
|
|
|
@@ -615,7 +615,7 @@ When a new version of the package is published:
|
|
|
615
615
|
|
|
616
616
|
```bash
|
|
617
617
|
# npx (one-shot, recommended) — always uses the latest tarball
|
|
618
|
-
npx @event4u/
|
|
618
|
+
npx @event4u/agent-config init --tools=claude-code,cursor
|
|
619
619
|
|
|
620
620
|
# Global CLI
|
|
621
621
|
npm install -g @event4u/agent-config@latest
|
|
@@ -15,7 +15,7 @@ projects to those paths during install.
|
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
17
|
# Inside an existing repo:
|
|
18
|
-
npx @event4u/
|
|
18
|
+
npx @event4u/agent-config init --tools=claude-code
|
|
19
19
|
|
|
20
20
|
# Or with the curl entrypoint:
|
|
21
21
|
curl -sSL https://raw.githubusercontent.com/event4u-app/agent-config/main/setup.sh \
|
|
@@ -11,7 +11,7 @@ and `AGENTS.md`.
|
|
|
11
11
|
## Install
|
|
12
12
|
|
|
13
13
|
```bash
|
|
14
|
-
npx @event4u/
|
|
14
|
+
npx @event4u/agent-config init --tools=cline
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
Populates:
|
|
@@ -35,7 +35,7 @@ automatically. Run `/help` in the chat to verify rule loading.
|
|
|
35
35
|
| Symptom | Fix |
|
|
36
36
|
|---|---|
|
|
37
37
|
| Rules not picked up | Reload VS Code window after `task generate-tools`. |
|
|
38
|
-
| `.clinerules` missing | Re-run `npx @event4u/
|
|
38
|
+
| `.clinerules` missing | Re-run `npx @event4u/agent-config init --tools=cline`. |
|
|
39
39
|
|
|
40
40
|
## Cross-references
|
|
41
41
|
|
|
@@ -13,7 +13,7 @@ falls back to `AGENTS.md` where supported.
|
|
|
13
13
|
## Install
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
npx @event4u/
|
|
16
|
+
npx @event4u/agent-config init --tools=copilot
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
Populates:
|
|
@@ -69,7 +69,7 @@ gh copilot --version # if you want CLI plugin
|
|
|
69
69
|
| Symptom | Fix |
|
|
70
70
|
|---|---|
|
|
71
71
|
| Copilot ignores the file | Reload the IDE window after install. |
|
|
72
|
-
| File missing after install | Re-run `npx @event4u/
|
|
72
|
+
| File missing after install | Re-run `npx @event4u/agent-config init --tools=copilot`. |
|
|
73
73
|
| Copilot PR review too noisy | See the `copilot-config` skill for suppression patterns. |
|
|
74
74
|
|
|
75
75
|
## Cross-references
|
|
@@ -19,7 +19,7 @@ The package ships **both** so you don't have to pick.
|
|
|
19
19
|
## Project install
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
npx @event4u/
|
|
22
|
+
npx @event4u/agent-config init --tools=cursor
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
This populates:
|
|
@@ -32,7 +32,7 @@ This populates:
|
|
|
32
32
|
Combine surfaces if you use both Cursor and Claude Code:
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
npx @event4u/
|
|
35
|
+
npx @event4u/agent-config init --tools=cursor,claude-code
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Global install
|
|
@@ -19,7 +19,7 @@ The package ships **both**.
|
|
|
19
19
|
## Project install
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
npx @event4u/
|
|
22
|
+
npx @event4u/agent-config init --tools=windsurf
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
Populates:
|
|
@@ -32,7 +32,7 @@ Populates:
|
|
|
32
32
|
Combine with other surfaces:
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
npx @event4u/
|
|
35
|
+
npx @event4u/agent-config init --tools=windsurf,claude-code,cursor
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Wave-8 frontmatter
|
package/docs/troubleshooting.md
CHANGED
|
@@ -34,7 +34,7 @@ bash scripts/install --verbose
|
|
|
34
34
|
# or, to regenerate everything (overwrites existing bridge files):
|
|
35
35
|
bash scripts/install --force
|
|
36
36
|
# or, for one-shot installs without a local node_modules tree:
|
|
37
|
-
npx @event4u/
|
|
37
|
+
npx @event4u/agent-config init --tools=claude-code,cursor
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
### Check 2: Does your agent actually read these directories?
|
|
@@ -70,7 +70,7 @@ orchestrator explicitly inside the project root:
|
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
72
|
# One-shot, no local checkout required (recommended)
|
|
73
|
-
npx @event4u/
|
|
73
|
+
npx @event4u/agent-config init --tools=claude-code,cursor
|
|
74
74
|
|
|
75
75
|
# When the global CLI is installed
|
|
76
76
|
agent-config install --tools=claude-code,cursor
|
|
@@ -84,7 +84,7 @@ When the package version changes, symlinks that pointed to the old
|
|
|
84
84
|
package path may break. Re-run the installer — it is idempotent:
|
|
85
85
|
|
|
86
86
|
```bash
|
|
87
|
-
npx @event4u/
|
|
87
|
+
npx @event4u/agent-config init --tools=claude-code,cursor
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
The installer replaces stale symlinks with fresh ones pointing at the
|
|
@@ -99,7 +99,7 @@ and Unix-style symlinks. Recommended setup:
|
|
|
99
99
|
|
|
100
100
|
1. **WSL2** (preferred): install Ubuntu or a distribution of your choice,
|
|
101
101
|
clone the project inside the WSL filesystem, and run
|
|
102
|
-
`npx @event4u/
|
|
102
|
+
`npx @event4u/agent-config init` from WSL.
|
|
103
103
|
2. **Git Bash**: works for the basic install, but symlinks require
|
|
104
104
|
Developer Mode (Windows 10 1703+) or admin privileges. Without either,
|
|
105
105
|
Git Bash falls back to copies, which means updates will not propagate
|
package/package.json
CHANGED
package/scripts/agent-config
CHANGED
|
@@ -98,6 +98,9 @@ Commands:
|
|
|
98
98
|
Flags: --check (read-only) | --to <version> (explicit pin)
|
|
99
99
|
migrate One-shot migration off legacy composer / npm install paths
|
|
100
100
|
Flags: --dry-run (detect only)
|
|
101
|
+
init One-shot project install. Forwards to `scripts/install`
|
|
102
|
+
with all args. Entry point for `npx @event4u/agent-config init`.
|
|
103
|
+
Flags: --tools=<list> | --ai=<list> | --yes | --force
|
|
101
104
|
global Install to user-scope paths (~/.claude/, ~/.cursor/, …)
|
|
102
105
|
Forwards to `scripts/install --global` (ADR-007).
|
|
103
106
|
Flags: --tools=<list> | --ai=<list> | --yes | --force
|
|
@@ -139,6 +142,7 @@ Examples:
|
|
|
139
142
|
./agent-config council:estimate prompt.txt
|
|
140
143
|
./agent-config council:run prompt.txt --output agents/council-sessions/out.json --confirm
|
|
141
144
|
./agent-config council:render agents/council-sessions/out.json
|
|
145
|
+
./agent-config init --tools=claude-code,cursor --yes
|
|
142
146
|
./agent-config global --tools=claude-code --yes
|
|
143
147
|
./agent-config global --ai=cursor,windsurf
|
|
144
148
|
./agent-config export --list
|
|
@@ -545,6 +549,16 @@ cmd_migrate() {
|
|
|
545
549
|
exec env PYTHONPATH="$PACKAGE_ROOT" python3 -m scripts._cli.cmd_migrate "$@"
|
|
546
550
|
}
|
|
547
551
|
|
|
552
|
+
# `agent-config init` — project-scope install entry point. Forwards
|
|
553
|
+
# unmodified args to the bash installer. This is the canonical
|
|
554
|
+
# `npx @event4u/agent-config init` consumer entry point (replaces the
|
|
555
|
+
# deprecated @event4u/create-agent-config wrapper package).
|
|
556
|
+
cmd_init() {
|
|
557
|
+
local script
|
|
558
|
+
script="$(resolve_script "scripts/install")" || return 1
|
|
559
|
+
exec bash "$script" "$@"
|
|
560
|
+
}
|
|
561
|
+
|
|
548
562
|
# `agent-config global` — user-scope install entry point. Forwards to the
|
|
549
563
|
# bash installer with `--global` set (ADR-007). Phase 1.2 of
|
|
550
564
|
# road-to-global-first-install.md. The bash wrapper handles option parsing
|
|
@@ -622,6 +636,7 @@ main() {
|
|
|
622
636
|
council:render) cmd_council render "$@" ;;
|
|
623
637
|
update) cmd_update "$@" ;;
|
|
624
638
|
migrate) cmd_migrate "$@" ;;
|
|
639
|
+
init) cmd_init "$@" ;;
|
|
625
640
|
global) cmd_global "$@" ;;
|
|
626
641
|
export) cmd_export "$@" ;;
|
|
627
642
|
sync) cmd_sync "$@" ;;
|
|
@@ -646,7 +661,7 @@ main() {
|
|
|
646
661
|
maybe_pin_reexec() {
|
|
647
662
|
local cmd="${1-}"
|
|
648
663
|
case "$cmd" in
|
|
649
|
-
help|--help|-h|--version|-V|update|migrate|"") return 0 ;;
|
|
664
|
+
help|--help|-h|--version|-V|update|migrate|init|"") return 0 ;;
|
|
650
665
|
esac
|
|
651
666
|
if ! command -v python3 >/dev/null 2>&1; then
|
|
652
667
|
return 0
|
package/scripts/install
CHANGED
|
@@ -230,17 +230,18 @@ if [[ -z "$TARGET_DIR" ]]; then
|
|
|
230
230
|
fi
|
|
231
231
|
|
|
232
232
|
# Source-repo guard: refuse to install into the agent-config dev tree itself.
|
|
233
|
-
#
|
|
234
|
-
#
|
|
235
|
-
#
|
|
233
|
+
# Defense-in-depth so a direct `bash scripts/install` from inside the source
|
|
234
|
+
# checkout cannot corrupt .augment/ symlinks. Skipped for --global because
|
|
235
|
+
# global installs only write to user-scope paths (~/.config/agent-config/,
|
|
236
|
+
# ~/.claude/, …) and never touch the source tree. Override for self-tests:
|
|
236
237
|
# AGENT_CONFIG_ALLOW_SELF_INSTALL=1.
|
|
237
|
-
if [[ "${AGENT_CONFIG_ALLOW_SELF_INSTALL:-0}" != "1" ]]; then
|
|
238
|
+
if ! $GLOBAL && [[ "${AGENT_CONFIG_ALLOW_SELF_INSTALL:-0}" != "1" ]]; then
|
|
238
239
|
self_marker=""
|
|
239
240
|
if [[ -d "$TARGET_DIR/.agent-src.uncompressed" ]]; then
|
|
240
241
|
self_marker=".agent-src.uncompressed/"
|
|
241
242
|
elif [[ -f "$TARGET_DIR/package.json" ]] && \
|
|
242
|
-
grep -qE '"name"[[:space:]]*:[[:space:]]*"@event4u/
|
|
243
|
-
self_marker='package.json::name === "@event4u/
|
|
243
|
+
grep -qE '"name"[[:space:]]*:[[:space:]]*"@event4u/agent-config"' "$TARGET_DIR/package.json" 2>/dev/null; then
|
|
244
|
+
self_marker='package.json::name === "@event4u/agent-config"'
|
|
244
245
|
fi
|
|
245
246
|
if [[ -n "$self_marker" ]]; then
|
|
246
247
|
err "Refusing to install agent-config into its own source checkout."
|
package/scripts/install.py
CHANGED
|
@@ -107,7 +107,7 @@ def detect_package_root(project_root: Path) -> Path:
|
|
|
107
107
|
|
|
108
108
|
fail(
|
|
109
109
|
"Could not find agent-config package. Install via "
|
|
110
|
-
"`npx @event4u/
|
|
110
|
+
"`npx @event4u/agent-config init` or `npm install -g @event4u/agent-config`."
|
|
111
111
|
)
|
|
112
112
|
return project_root # unreachable
|
|
113
113
|
|
|
@@ -2036,7 +2036,14 @@ def install_global(
|
|
|
2036
2036
|
# Refresh the project-scope manifest when running inside a project tree
|
|
2037
2037
|
# (ADR-008 Phase 3.2). Outside a project (e.g. plain `~/`) there is no
|
|
2038
2038
|
# manifest to write and the global lockfile alone is the source of truth.
|
|
2039
|
-
|
|
2039
|
+
# Skipped inside the agent-config source repo (detected by
|
|
2040
|
+
# `.agent-src.uncompressed/`) — maintainers dogfood with their own
|
|
2041
|
+
# `.agent-settings.yml` and the manifest would be untracked noise.
|
|
2042
|
+
if (
|
|
2043
|
+
project_root is not None
|
|
2044
|
+
and (project_root / SETTINGS_FILE).exists()
|
|
2045
|
+
and not (project_root / ".agent-src.uncompressed").is_dir()
|
|
2046
|
+
):
|
|
2040
2047
|
rc = _update_installed_tools_manifest(project_root, tools, "global", force)
|
|
2041
2048
|
if rc != 0:
|
|
2042
2049
|
return rc
|
|
@@ -2355,7 +2362,7 @@ def main(argv: list[str]) -> int:
|
|
|
2355
2362
|
print()
|
|
2356
2363
|
print(" Next steps:")
|
|
2357
2364
|
print(" • Commit .agent-settings.yml and bridge files to your repo")
|
|
2358
|
-
print(" • New team members run `npx @event4u/
|
|
2365
|
+
print(" • New team members run `npx @event4u/agent-config init` — done")
|
|
2359
2366
|
print(" • Inspect hook coverage: ./agent-config hooks:status")
|
|
2360
2367
|
print(" • Full walkthrough: https://github.com/event4u-app/agent-config/blob/main/docs/getting-started.md")
|
|
2361
2368
|
print()
|
|
@@ -56,7 +56,7 @@ cat >&2 <<EOF
|
|
|
56
56
|
- npx @event4u/agent-config@latest (npx not installed)
|
|
57
57
|
|
|
58
58
|
Install via:
|
|
59
|
-
npx @event4u/
|
|
59
|
+
npx @event4u/agent-config init # one-shot setup
|
|
60
60
|
npm install -g @event4u/agent-config # global CLI
|
|
61
61
|
EOF
|
|
62
62
|
exit 127
|
|
@@ -28,7 +28,7 @@ instead of copying files via `install.sh`.
|
|
|
28
28
|
These tools do **not** support plugins yet. Use the classic installer:
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
|
-
npx @event4u/
|
|
31
|
+
npx @event4u/agent-config init --tools=cursor,cline,windsurf,augment
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
## What the plugin provides
|
|
@@ -42,13 +42,14 @@ listing:
|
|
|
42
42
|
- copilot
|
|
43
43
|
- augment
|
|
44
44
|
|
|
45
|
-
# npm package metadata (synced into
|
|
46
|
-
#
|
|
45
|
+
# npm package metadata (synced into the root @event4u/agent-config
|
|
46
|
+
# package.json on release).
|
|
47
47
|
npm:
|
|
48
|
-
package: "@event4u/
|
|
48
|
+
package: "@event4u/agent-config"
|
|
49
49
|
description: >-
|
|
50
|
-
|
|
51
|
-
|
|
50
|
+
Shared agent configuration — skills, rules, slash commands, and
|
|
51
|
+
one-shot installer (`npx @event4u/agent-config init`) for every
|
|
52
|
+
major AI coding tool.
|
|
52
53
|
keywords:
|
|
53
54
|
- agent
|
|
54
55
|
- claude
|