Skip to content

3.0.0

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 11 Aug 17:46

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, and doctor operate under ~/.agents/ (or DOTAGENTS_HOME) even when run inside a configured repository. Add --project to 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.
  • --global remains an optional explicit global spelling and --user remains a compatibility alias. Combining --project with 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.