Skip to content

docs: explain native plugin activation - #178

Open
mishamilovidov wants to merge 7 commits into
getsentry:mainfrom
mishamilovidov:milovido-adobe-document-plugin-activation
Open

mishamilovidov wants to merge 7 commits into
getsentry:mainfrom
mishamilovidov:milovido-adobe-document-plugin-activation

Conversation

@mishamilovidov

@mishamilovidov mishamilovidov commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Summary

Document native plugin activation for every supported agent target on main, now merged through the 3.1.0 release and upstream PR #185 (5d6ac5c).

Changes

  • Define the three-stage plugin lifecycle and map activation requirements across all eight supported agent IDs: claude, cursor, codex, copilot, vscode, grok, opencode, pi.
  • Add project and global activation commands for Claude, Codex, and Copilot, including custom DOTAGENTS_HOME paths and the default ~/.agents root.
  • Add Copilot native cache, update, uninstall, and marketplace-removal commands, matching the existing depth for Claude and Codex.
  • Document Cursor activation paths, native update/removal/cache behavior for marketplace clients, and the dotagents doctor limitation for every marketplace-based agent.
  • Merge upstream main (through #166, #182, #185, and the 3.1.0 release) to resolve conflicts, correcting a Copilot native plugin state claim in the guide to match verified COPILOT_HOME CLI behavior, keeping the PR diff scoped to the four documentation files.

Testing

  • pnpm check (oxlint, ast-grep, typecheck, and 1137 tests across dotagents and dotagents-lib) passes on befa08e.
  • pnpm --dir docs build (Astro check and build) passes with 0 errors, 0 warnings, on befa08e.
  • git diff --check and a conflict-marker scan report no whitespace, conflict-marker, or merge-artifact issues.
  • Verified the Copilot COPILOT_HOME claim directly against copilot help environment and native CLI behavior (a marketplace add plus plugin install under a custom COPILOT_HOME left the default home's plugin state untouched).
  • Manually confirmed all eight agent IDs, the lifecycle language, and the dotagents doctor limitation appear in all four documentation surfaces; confirmed Codex examples still use @dotagents-local throughout (see Notes).

Related Issues

Notes

  • Keep Codex examples at @dotagents-local. #177 (the marketplace-name rename) is still open and unmerged, so this PR intentionally merges and lands before #177. Codex examples switch to @dotagents only after #177 lands.

@vercel

vercel Bot commented Aug 24, 2026

Copy link
Copy Markdown

@mishamilovidov is attempting to deploy a commit to the Sentry Team on Vercel.

A member of the Team first needs to authorize it.

@mishamilovidov
mishamilovidov force-pushed the milovido-adobe-document-plugin-activation branch from 4580910 to 452a8a8 Compare August 24, 2026 23:22
Separate Dotagents runtime generation from native client plugin installation across every supported agent. Add project, global, update, removal, Cursor, and doctor guidance for getsentry#176.
@mishamilovidov
mishamilovidov force-pushed the milovido-adobe-document-plugin-activation branch from 452a8a8 to bb2adb6 Compare August 24, 2026 23:28
@mishamilovidov mishamilovidov changed the title docs: document native plugin activation docs: explain native plugin activation Aug 24, 2026
@mishamilovidov
mishamilovidov marked this pull request as ready for review August 24, 2026 23:44
@github-actions github-actions Bot added the risk: high PR risk score: high label Aug 24, 2026
…ath fix

# Conflicts:
#	README.md
#	docs/public/llms.txt
#	docs/src/content/docs/cli.mdx
Verified via 'copilot help environment' and direct testing (registering a marketplace and installing a plugin under a custom COPILOT_HOME left the default home's plugin state untouched) that COPILOT_HOME scopes the Copilot CLI's own configuration and state, including native plugin and marketplace registrations, not only global skills and MCP paths.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

risk: high PR risk score: high

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document native plugin registration and activation

1 participant