Skip to content

docs: add Deep Agents Code diagnostic commands - #5693

Merged
Mason Daugherty (mdrxy) merged 62 commits into
mainfrom
mdrxy/docs/dcode-command-diagnostics
Aug 27, 2026
Merged

docs: add Deep Agents Code diagnostic commands#5693
Mason Daugherty (mdrxy) merged 62 commits into
mainfrom
mdrxy/docs/dcode-command-diagnostics

Conversation

@mdrxy

@mdrxy Mason Daugherty (mdrxy) commented Aug 26, 2026

Copy link
Copy Markdown
Member

Summary

Documents the Deep Agents Code diagnostic slash commands shipped in langchain-ai/deepagents#5830 (/context-doctor, 0.1.62), langchain-ai/deepagents#4649 (/tools, 0.1.37), and langchain-ai/deepagents#5036 (/cost, 0.1.51).

  • cli-reference.mdx: new "Diagnose and audit a session" section covering /tools (active tool set, unavailable MCP servers, tool-shaping flags), /context-doctor (injected-context audit, estimated tokens, unexpected growth, relationship to /context and dcode doctor), and /cost (estimated thread cost, checkpoint persistence, genai-prices source, display-only caveat). Each carries its minimum-version <Note>.
  • quickstart.mdx: slash-command list entries plus a pointer from "Inspect context-window usage"; refreshes /clear and /force-clear descriptions and current shortcuts (Ctrl+G editor, Ctrl+T subagent panel, Shift+Tab approval cycle).

Example output was generated by exercising the real rendering code (context_doctor.py, tool_catalog.py, _session_stats.py) against the current source at langchain-ai/deepagents@9f3a1dd38; command names, descriptions, and visibility match command_registry.py and the generated COMMANDS.md.

Verification

  • vale 3.9.6 (scoped lint_prose on both changed files): 0 errors, 0 warnings, 0 suggestions.
  • mint broken-links and mint broken-links --check-anchors on a fresh pipeline build: no broken links.
  • 241 related deepagents unit tests pass (test_context_doctor.py, test_cost_tracking.py, test_command_registry.py, test_tool_catalog.py).

AI agent involvement: authored by Open SWE.

Stack

This is stack 3/4 and targets #5692 (mdrxy/docs/dcode-approval-goals).

Made by Open SWE

@github-actions github-actions Bot added internal deepagents For docs changes to Deep Agents oss labels Aug 26, 2026
@mdrxy
Mason Daugherty (mdrxy) marked this pull request as ready for review August 26, 2026 22:14
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
@open-swe
open-swe Bot changed the base branch from main to mdrxy/docs/dcode-approval-goals August 27, 2026 20:33
Mason Daugherty (mdrxy) and others added 20 commits August 27, 2026 17:48
Document shared configuration added in recent deepagents-code releases,
verified against the config manifest on langchain-ai/deepagents main:

- [models].allowed allowlist: provider:model and provider:* syntax,
  unset vs empty-list semantics, fail-closed malformed lists (0.1.61)
- startup.read_project_dotenv plus the exact dotenv-denied key set,
  including the git config-injection family (0.1.60)
- DEEPAGENTS_HOME profile relocation: valid forms, profile paths, and
  the inherited-env-only trust boundary (0.1.62)
- LangSmith secret redaction now enabled by default (0.1.62)
- history.retention_days startup sweep for offloaded archives (0.1.61)
- memory.auto_save read-only memory mode (0.1.38)
- display.show_usage_stats, display.collapse_pastes,
  threads.compact_on_resume_threshold, update.prices_auto_update
- Complete [interpreter] seven-setting reference; correct the stale
  --interpreter-tools default to 'safe' in the CLI reference

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/quickstart.mdx Outdated
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Base automatically changed from mdrxy/docs/dcode-approval-goals to main August 27, 2026 23:39
Resolve the configuration introduction conflict by retaining the profile-directory wording from main.\n\nCo-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Comment thread src/oss/deepagents/code/cli-reference.mdx Outdated
Clarify when the subagent panel shortcut applies and document custom pricing overrides behind the cost command's cross-reference.\n\nCo-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Name the genai-prices catalog explicitly so the custom override precedence is unambiguous.\n\nCo-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Add the required collaborator credit omitted from the preceding follow-up commits.

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

Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-mdrxyd-1787874960-e422c7e

Site preview: https://langchain-5e9cc07a-preview-mdrxyd-1787874960-e422c7e.mintlify.site

Important

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

Changed documentation pages (preview deep links):

@mdrxy
Mason Daugherty (mdrxy) merged commit f7508fe into main Aug 27, 2026
25 checks passed
@mdrxy
Mason Daugherty (mdrxy) deleted the mdrxy/docs/dcode-command-diagnostics branch August 27, 2026 23:57
Mason Daugherty (mdrxy) added a commit that referenced this pull request Aug 28, 2026
## Description
Document MCP environment interpolation and in-session OAuth
re-authentication without exposing internal resolution and UI-state
details. Also covers bare `dcode mcp login` server discovery and the
debug-only token-path message from current `main`.

## Release Note
Document Deep Agents Code MCP environment expansion and
re-authentication workflows.

## Test Plan
- [x] Parse the changed JSON example.
- [x] Run scoped `make lint_prose`.

## Stack

This is stack 4/4 and targets #5693
(`mdrxy/docs/dcode-command-diagnostics`).

Made by [Open
SWE](https://openswe.vercel.app/agents/71ca157c-3fc4-5555-853e-259b564414f2)

---------

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deepagents For docs changes to Deep Agents internal oss

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant