feat: document Deep Agents Code plugins by johannes117 · Pull Request #4905 · langchain-ai/docs

Johannes du Plessis (johannes117) · 2026-07-15T00:37:29Z

Document experimental Deep Agents Code plugin management and authoring so users can install trusted marketplace plugins and authors can package supported skills and MCP servers. The structure follows Claude Code's user, author, and marketplace guidance while limiting details to behavior implemented in deepagents#4554.

Made by Open SWE

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>

open-swe

Open SWE Review found 3 potential issues.

Open in Web • View Open SWE trace

github-actions · 2026-07-15T02:23:27Z

Thanks for opening a docs PR, Johannes du Plessis (@johannes117)! When it's ready for review, please add the relevant reviewers:

@mdrxy (Deep Agents)

Align Deep Agents Code plugin docs with the removal of /reload-plugins; plugin skills and MCP now activate through /reload. Co-authored-by: Cursor <cursoragent@cursor.com>

Johannes du Plessis (johannes117) · 2026-07-15T02:31:57Z

Updated to match langchain-ai/deepagents#4554: plugin skills/MCP now reload via /reload (no separate /reload-plugins command).

`deepagents-code` now supports experimental plugin marketplaces with namespaced skills and MCP servers. Enable with `DEEPAGENTS_CODE_EXPERIMENTAL=1`. Docs: langchain-ai/docs#4905 --- `deepagents-code` can now manage experimental plugin marketplaces and load installed plugins that contribute namespaced skills and MCP servers. The new plugin manager establishes the `tui/modals`, `tui/screens`, and `tui/widgets` UI convention, with colocated styling and focused state/content modules. - Supports local, GitHub, Git, and marketplace JSON sources. - Adds install, enable, disable, uninstall, and safe marketplace removal through `/plugins` and `dcode plugin`. - Reloads plugin skills and plugin MCP configuration with `/reload` when experimental mode is enabled. - Namespaces plugin skills as `{plugin_id}:{skill_name}` through a code-local `PluginSkillsMiddleware` adapter, so no SDK changes are required. Made by [Open SWE](https://openswe.vercel.app/agents/019f5dea-0f1f-73fe-9803-32d1b13fbd4c) --------- Signed-off-by: Johannes du Plessis <johannes@langchain.dev> Co-authored-by: Alexander Olsen <aolsenjazz@gmail.com> Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: Mason Daugherty <mason@langchain.dev> Co-authored-by: open-swe[bot] <215916821+open-swe[bot]@users.noreply.github.com> Co-authored-by: Mason Daugherty <github@mdrxy.com>

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>

open-swe · 2026-07-15T21:26:34Z

Addressed all current review feedback in dd08e6a: removed the broad experimental environment-variable reference, clarified the Claude-compatible marketplace specification, and corrected the git-subdir example path. Vale, embedded/navigation JSON validation, diff checks, and broken links pass.

Alexander Olsen (aolsenjazz)

Some pending changes following release strategy

Overall looks great

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>

open-swe · 2026-07-16T20:04:47Z

Addressed and resolved all open review threads in 25f1452: applied the release-gate removals, documented Claude/Codex compatibility, clarified reload behavior, switched to dcode terminology, and corrected canonical plugin skill invocation. Vale, JSON validation, diff checks, and broken links pass.

github-actions · 2026-07-16T20:05:52Z

Mintlify preview branch generated: preview-opensw-1784232316-f00b15e

Site preview: https://langchain-5e9cc07a-preview-opensw-1784232316-f00b15e.mintlify.site

Important

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

Alexander Olsen (aolsenjazz)

LGTM

Mason Daugherty (mdrxy) · 2026-07-17T03:28:57Z

+    - An HTTPS URL that serves a marketplace JSON file.
+    - A local marketplace directory or JSON file.
+3. Install a plugin from the marketplace.
+4. Run `/reload` to activate newly installed plugin skills and MCP servers without restarting the session.


this seems unnecessary to mention since we show an action modal to users

Mason Daugherty (mdrxy) · 2026-07-17T03:29:54Z

+
+The plugin manager also lets you enable, disable, and uninstall installed plugins. Disabling a plugin keeps it installed but excludes its skills and MCP servers after you run `/reload` or start a new session.
+
+Removing a marketplace uninstalls its plugins and removes managed cache data. Deep Agents Code preserves the original source when the marketplace came from a local directory or file. Run `/reload` or start a new session to apply the removal to an active session.


Suggested change

Removing a marketplace uninstalls its plugins and removes managed cache data. Deep Agents Code preserves the original source when the marketplace came from a local directory or file. Run `/reload` or start a new session to apply the removal to an active session.

Removing a marketplace uninstalls its plugins. Deep Agents Code preserves the original source when the marketplace came from a local directory or file.

Mason Daugherty (mdrxy) · 2026-07-17T03:30:50Z

+dcode plugin marketplace remove acme-tools
+```
+
+`plugin list` and `plugin marketplace list` accept `--json`. After installing a plugin, run `/reload` in an active interactive session or start a new session.


plugin list and plugin marketplace list accept --json

most people don't care and if they do this is noted in the --help option right?

if we're gonna keep it, mention it "to support machine readable output" or similar

Mason Daugherty (mdrxy) · 2026-07-17T03:31:20Z

+
+## Create a plugin
+
+A Deep Agents Code plugin is a directory containing one or both of the supported components:


Suggested change

A Deep Agents Code plugin is a directory containing one or both of the supported components:

A plugin is a directory containing one or both of the supported components:

Mason Daugherty (mdrxy) · 2026-07-17T03:31:42Z

+└── .mcp.json
+```
+
+Deep Agents Code also recognizes `.codex-plugin/plugin.json`. The manifest is optional when components use their default locations. If the plugin contains one skill only, you can place `SKILL.md` at the plugin root instead of creating `skills/`.


is this an open spec? let's link to it

`deepagents-code` now supports experimental plugin marketplaces with namespaced skills and MCP servers. Enable with `DEEPAGENTS_CODE_EXPERIMENTAL=1`. Docs: langchain-ai/docs#4905 --- `deepagents-code` can now manage experimental plugin marketplaces and load installed plugins that contribute namespaced skills and MCP servers. The new plugin manager establishes the `tui/modals`, `tui/screens`, and `tui/widgets` UI convention, with colocated styling and focused state/content modules. - Supports local, GitHub, Git, and marketplace JSON sources. - Adds install, enable, disable, uninstall, and safe marketplace removal through `/plugins` and `dcode plugin`. - Reloads plugin skills and plugin MCP configuration with `/reload` when experimental mode is enabled. - Namespaces plugin skills as `{plugin_id}:{skill_name}` through a code-local `PluginSkillsMiddleware` adapter, so no SDK changes are required. Made by [Open SWE](https://openswe.vercel.app/agents/019f5dea-0f1f-73fe-9803-32d1b13fbd4c) --------- Signed-off-by: Johannes du Plessis <johannes@langchain.dev> Co-authored-by: Alexander Olsen <aolsenjazz@gmail.com> Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: Mason Daugherty <mason@langchain.dev> Co-authored-by: open-swe[bot] <215916821+open-swe[bot]@users.noreply.github.com> Co-authored-by: Mason Daugherty <github@mdrxy.com>

feat: document Deep Agents Code plugins

904a645

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>

github-actions Bot added deepagents For docs changes to Deep Agents oss internal labels Jul 15, 2026

open-swe Bot reviewed Jul 15, 2026

View reviewed changes

Comment thread src/oss/deepagents/code/plugins.mdx Outdated

Comment thread src/oss/deepagents/code/plugins.mdx Outdated

Comment thread src/oss/deepagents/code/plugins.mdx Outdated

Johannes du Plessis (johannes117) marked this pull request as ready for review July 15, 2026 02:23

github-actions Bot requested a review from Mason Daugherty (mdrxy) July 15, 2026 02:23

Johannes du Plessis (johannes117) mentioned this pull request Jul 15, 2026

feat(code): add plugin marketplace support langchain-ai/deepagents#4554

Merged

docs: consolidate plugin reload under /reload

4313294

Align Deep Agents Code plugin docs with the removal of /reload-plugins; plugin skills and MCP now activate through /reload. Co-authored-by: Cursor <cursoragent@cursor.com>

Mason Daugherty (mdrxy) reviewed Jul 15, 2026

View reviewed changes

Comment thread src/oss/deepagents/code/configuration.mdx Outdated

Mason Daugherty (mdrxy) reviewed Jul 15, 2026

View reviewed changes

Comment thread src/oss/deepagents/code/plugins.mdx

docs: clarify plugin marketplace guidance

dd08e6a

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>

Alexander Olsen (aolsenjazz) reviewed Jul 16, 2026

View reviewed changes

docs: address plugin release feedback

25f1452

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>

Alexander Olsen (aolsenjazz) self-requested a review July 16, 2026 22:02

Alexander Olsen (aolsenjazz) approved these changes Jul 16, 2026

View reviewed changes

Mason Daugherty (mdrxy) reviewed Jul 17, 2026

View reviewed changes

Mason Daugherty (mdrxy) merged commit 5faa835 into main Jul 17, 2026
24 checks passed

Mason Daugherty (mdrxy) deleted the open-swe/document-deepagents-4554 branch July 17, 2026 03:33


		The plugin manager also lets you enable, disable, and uninstall installed plugins. Disabling a plugin keeps it installed but excludes its skills and MCP servers after you run `/reload` or start a new session.

		Removing a marketplace uninstalls its plugins and removes managed cache data. Deep Agents Code preserves the original source when the marketplace came from a local directory or file. Run `/reload` or start a new session to apply the removal to an active session.


		## Create a plugin

		A Deep Agents Code plugin is a directory containing one or both of the supported components:

	A Deep Agents Code plugin is a directory containing one or both of the supported components:
	A plugin is a directory containing one or both of the supported components:

Uh oh!

Conversation

Johannes du Plessis (johannes117) commented Jul 15, 2026 • edited by mdrxy Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

open-swe Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jul 15, 2026

Uh oh!

Johannes du Plessis (johannes117) commented Jul 15, 2026

Uh oh!

Uh oh!

Uh oh!

open-swe Bot commented Jul 15, 2026

Uh oh!

Alexander Olsen (aolsenjazz) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

open-swe Bot commented Jul 16, 2026

Uh oh!

github-actions Bot commented Jul 16, 2026

Uh oh!

Alexander Olsen (aolsenjazz) left a comment

Choose a reason for hiding this comment

Uh oh!

Mason Daugherty (mdrxy) Jul 17, 2026

Choose a reason for hiding this comment

Uh oh!

Mason Daugherty (mdrxy) Jul 17, 2026

Choose a reason for hiding this comment

Uh oh!

Mason Daugherty (mdrxy) Jul 17, 2026

Choose a reason for hiding this comment

Uh oh!

Mason Daugherty (mdrxy) Jul 17, 2026

Choose a reason for hiding this comment

Uh oh!

Mason Daugherty (mdrxy) Jul 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Johannes du Plessis (johannes117) commented Jul 15, 2026 •

edited by mdrxy

Loading