3.0.0
Breaking Changes ⚠️
- (cli) Default commands to global scope by @gricha in #156
- Scope-aware commands now target global state by default. Unqualified
init,install,add,remove,sync,list,mcp,trust, anddoctoroperate under~/.agents/(orDOTAGENTS_HOME) even when run inside a configured repository. Add--projectto every repository-local invocation. - Existing project and global configuration, lockfiles, and managed directories are not copied, merged, renamed, or deleted automatically. The command's scope flag alone selects which state is used.
--globalremains an optional explicit global spelling and--userremains a compatibility alias. Combining--projectwith either global alias is an error.
| v2 intent and command | v3 command |
|---|---|
Project init: dotagents init |
dotagents --project init |
Project install/refresh: dotagents install |
dotagents --project install |
Project add/remove: dotagents add … / dotagents remove … |
dotagents --project add … / dotagents --project remove … |
Project repair/inspection: dotagents sync, list, or doctor |
Add --project to the command |
Global operation: dotagents --user … or dotagents --global … |
dotagents … (--global and --user still work) |
Legacy dotagents-managed project post-merge hooks contain a bare install command whose meaning changes in v3. Run dotagents --project doctor --fix (or dotagents --project init) once in each affected repository. The repair replaces only the marker-delimited dotagents block and preserves unrelated hook content and permissions.
If a release-blocking regression requires rollback, restore the last v2 release as npm's latest tag while preparing a v3 patch. No data conversion is required because v3 does not migrate files.