From 1b209f5fc2cca1679f27b07f84231dd69036d076 Mon Sep 17 00:00:00 2001 From: Mason Daugherty <61371264+mdrxy@users.noreply.github.com> Date: Wed, 24 Jun 2026 19:33:37 +0000 Subject: [PATCH] docs: recommend DEEPAGENTS_CODE_LANGSMITH_PROJECT for dcode tracing setup Surface the dcode-scoped project var in the primary tracing setup blocks so users don't accidentally route Deep Agents Code's own traces into a LANGSMITH_PROJECT inherited from a project .env. Co-authored-by: open-swe[bot] --- src/oss/deepagents/code/overview.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/oss/deepagents/code/overview.mdx b/src/oss/deepagents/code/overview.mdx index 1f0e07de7b..9dde01cc2e 100644 --- a/src/oss/deepagents/code/overview.mdx +++ b/src/oss/deepagents/code/overview.mdx @@ -59,7 +59,7 @@ Persistent memory carries context across conversations, customizable skills shap ```bash title="~/.deepagents/.env" LANGSMITH_TRACING=true LANGSMITH_API_KEY=lsv2_... - LANGSMITH_PROJECT=optional-project-name # Specify a project name or default to "deepagents-code" + DEEPAGENTS_CODE_LANGSMITH_PROJECT=deepagents-code # Project for Deep Agents Code's own traces; defaults to "deepagents-code" ``` For more details and usage, see [Trace with LangSmith](#trace-with-langsmith). @@ -418,10 +418,12 @@ Add your tracing keys to `~/.deepagents/.env` so tracing is enabled in every ses ```bash title="~/.deepagents/.env" LANGSMITH_TRACING=true LANGSMITH_API_KEY=lsv2_... -LANGSMITH_PROJECT=optional-project-name # Specify a project name or default to "deepagents-code" +DEEPAGENTS_CODE_LANGSMITH_PROJECT=deepagents-code # Project for Deep Agents Code's own traces; defaults to "deepagents-code" ``` -To override for a specific project, add the same keys to a `.env` in the project directory. See [environment variables](/oss/deepagents/code/configuration#environment-variables) for the full loading order. +Use `DEEPAGENTS_CODE_LANGSMITH_PROJECT` to name the project that receives Deep Agents Code's own traces. It is scoped to Deep Agents Code, so it won't be affected by a `LANGSMITH_PROJECT` set in a project's `.env` (which routes that project's application traces — see **Separate agent traces from app traces** below). + +To override the project for a specific working directory, add `DEEPAGENTS_CODE_LANGSMITH_PROJECT` to a `.env` in that directory. See [environment variables](/oss/deepagents/code/configuration#environment-variables) for the full loading order. You can also set these as shell environment variables if you prefer. Shell exports always take precedence over `.env` values, so this is a good option for temporary overrides or testing: