Update reference content

katmayb · katmayb · commit 11305b33d65b · 2025-10-03T12:03:00.000-04:00
diff --git a/src/docs.json b/src/docs.json
@@ -1019,15 +1019,14 @@
                         ]
                       },
                       "langsmith/cli",
-                      "langsmith/env-var",
-                      "langsmith/langgraph-cli"
+                      "langsmith/env-var"
                     ]
                   },
                   {
                     "group": "Scalability & resilience",
                     "pages": [
-                      "langsmith/cloud-architecture-and-scalability",
-                      "langsmith/scalability-and-resilience"
+                      "langsmith/scalability-and-resilience",
+                      "langsmith/cloud-architecture-and-scalability"
                     ]
                   },
                   {
@@ -2075,15 +2074,14 @@
                         ]
                       },
                       "langsmith/cli",
-                      "langsmith/env-var",
-                      "langsmith/langgraph-cli"
+                      "langsmith/env-var"
                     ]
                   },
                   {
                     "group": "Scalability & resilience",
                     "pages": [
-                      "langsmith/cloud-architecture-and-scalability",
-                      "langsmith/scalability-and-resilience"
+                      "langsmith/scalability-and-resilience",
+                      "langsmith/cloud-architecture-and-scalability"
                     ]
                   },
                   {
diff --git a/src/langsmith/application-structure.mdx b/src/langsmith/application-structure.mdx
@@ -83,7 +83,7 @@ The `langgraph.json` file is a JSON file that specifies the dependencies, graphs
 See the [LangGraph configuration file reference](/langsmith/cli#configuration-file) for details on all supported keys in the JSON file.
 
 <Tip>
-The [LangGraph CLI](/langsmith/langgraph-cli) defaults to using the configuration file `langgraph.json` in the current directory.
+The [LangGraph CLI](/langsmith/cli) defaults to using the configuration file `langgraph.json` in the current directory.
 </Tip>
 
 ### Examples
diff --git a/src/langsmith/authentication-methods.mdx b/src/langsmith/authentication-methods.mdx
@@ -21,7 +21,7 @@ Enterprise customers can configure [SAML SSO](/langsmith/user-management) and [S
 
 ## Self-Hosted
 
-Self-hosted customers have more control over how their users can login to LangSmith. For more in-depth coverage of configuration options, see [the self-hosting docs](/langsmith/architectural-overview) and [Helm chart](https://github.com/langchain-ai/helm/tree/main/charts/langsmith).
+Self-hosted customers have more control over how their users can login to LangSmith. For more in-depth coverage of configuration options, see [the self-hosting docs](/langsmith/self-hosted) and [Helm chart](https://github.com/langchain-ai/helm/tree/main/charts/langsmith).
 
 ### SSO with OAuth 2.0 and OIDC
 
diff --git a/src/langsmith/cli.mdx b/src/langsmith/cli.mdx
@@ -3,31 +3,52 @@ title: LangGraph CLI
 sidebarTitle: CLI
 ---
 
-The LangGraph command line interface includes commands to build and run a LangSmith Platform API server locally in [Docker](https://www.docker.com/). For development and testing, you can use the CLI to deploy a local API server.
+**LangGraph CLI** is a command-line tool for building and running the [LangGraph API server](/langsmith/langgraph-server) locally. The resulting server exposes all API endpoints for runs, threads, assistants, etc., and includes supporting services such as a managed database for checkpointing and storage.
 
 ## Installation
 
-1. Ensure that Docker is installed (e.g. `docker --version`).
-2. Install the CLI package:
-    <Tabs>
-        <Tab title="Python">
-      ```bash
-      pip install langgraph-cli
-      ```
-        </Tab>
-        <Tab title="JS">
-      ```bash
-      npx @langchain/langgraph-cli
-
-      # Install globally, will be available as `langgraphjs`
-      npm install -g @langchain/langgraph-cli
-      ```
-        </Tab>
-    </Tabs>
-3. Run the command `langgraph --help` or `npx @langchain/langgraph-cli --help` to confirm that the CLI is working correctly.
-
-<a id="configuration-file"></a>
-## Configuration File
+1. Ensure Docker is installed (e.g., `docker --version`).
+1. Install the CLI:
+
+    <CodeGroup>
+    ```bash [Python (pip)]
+    pip install langgraph-cli
+    ```
+    ```bash Homebrew
+    brew install langgraph-cli
+    ```
+    ```bash JavaScript
+    # Use latest on demand
+    npx @langchain/langgraph-cli
+
+    # Or install globally (available as `langgraphjs`)
+    npm install -g @langchain/langgraph-cli
+    ```
+    </CodeGroup>
+
+1. Verify the install
+
+    <CodeGroup>
+    ```bash [Python (pip)]
+    langgraph --help
+    ```
+    ```bash JavaScript
+    npx @langchain/langgraph-cli --help
+    ```
+    </CodeGroup>
+
+### Quick commands
+
+| Command | What it does |
+| --- | --- |
+| [`langgraph dev`](#dev) | Starts a lightweight local dev server (no Docker required), ideal for rapid testing. |
+| [`langgraph build`](#build) | Builds a Docker image of your LangGraph API server for deployment. |
+| [`langgraph dockerfile`](#dockerfile) | Emits a Dockerfile derived from your config for custom builds. |
+| [`langgraph up`](#up) | Starts the LangGraph API server locally in Docker. Requires Docker running; LangSmith API key for local dev; license for production. |
+
+For JS, use `npx @langchain/langgraph-cli <command>` (or `langgraphjs` if installed globally).
+
+## Configuration file
 
 The LangGraph CLI requires a JSON configuration file that follows this [schema](https://raw.githubusercontent.com/langchain-ai/langgraph/refs/heads/main/libs/cli/schemas/schema.json). It contains the following properties:
 
diff --git a/src/langsmith/cloud-architecture-and-scalability.mdx b/src/langsmith/cloud-architecture-and-scalability.mdx
@@ -6,7 +6,7 @@ sidebarTitle: Cloud architecture and scalability
 <Note>
 This section is only relevant for the cloud-managed LangSmith services available at [https://smith.langchain.com](https://smith.langchain.com) and [https://eu.smith.langchain.com](https://eu.smith.langchain.com).
 
-For information on the self-hosted LangSmith solution, please refer to the [self-hosted documentation](/langsmith/architectural-overview).
+For information on the self-hosted LangSmith solution, please refer to the [self-hosted documentation](/langsmith/self-hosted).
 </Note>
 
 LangSmith is deployed on Google Cloud Platform (GCP) and is designed to be highly scalable. Many customers run production workloads on LangSmith for both LLM application observability and evaluation.
diff --git a/src/langsmith/components.mdx b/src/langsmith/components.mdx
@@ -6,7 +6,7 @@ sidebarTitle: Deployment components
 When running the self-hosted [LangSmith Platform with agent deployment](/langsmith/deploy-self-hosted-full-platform), your installation includes several key components. Together these tools and services provide a complete solution for building, deploying, and managing graphs (including agentic applications) in your own infrastructure:
 
 - [LangGraph Server](/langsmith/langgraph-server): Defines an opinionated API and runtime for deploying graphs and agents. Handles execution, state management, and persistence so you can focus on building logic rather than server infrastructure.
-- [LangGraph CLI](/langsmith/langgraph-cli): A command-line interface to build, package, and interact with graphs locally and prepare them for deployment.
+- [LangGraph CLI](/langsmith/cli): A command-line interface to build, package, and interact with graphs locally and prepare them for deployment.
 - [Studio](/langsmith/langgraph-studio): A specialized IDE for visualization, interaction, and debugging. Connects to a local LangGraph Server for developing and testing your graph.
 - [Python/JS SDK](/langsmith/sdk): The Python/JS SDK provides a programmatic way to interact with deployed graphs and agents from your applications.
 - [Remote Graph](/langsmith/use-remote-graph): Allows you to interact with a deployed graph as though it were running locally.
diff --git a/src/langsmith/data-storage-and-privacy.mdx b/src/langsmith/data-storage-and-privacy.mdx
@@ -6,7 +6,7 @@ This document describes how data is processed in the LangGraph CLI and the LangG
 
 ## CLI
 
-LangGraph **CLI** is the command-line interface for building and running LangGraph applications; see the [CLI guide](/langsmith/langgraph-cli) to learn more.
+LangGraph **CLI** is the command-line interface for building and running LangGraph applications; see the [CLI guide](/langsmith/cli) to learn more.
 
 By default, calls to most CLI commands log a single analytics event upon invocation. This helps us better prioritize improvements to the CLI experience. Each telemetry event contains the calling process's OS, OS version, Python version, the CLI version, the command name (`dev`, `up`, `run`, etc.), and booleans representing whether a flag was passed to the command. You can see the full analytics logic [here](https://github.com/langchain-ai/langgraph/blob/main/libs/cli/langgraph-cli/analytics.py).
 
diff --git a/src/langsmith/deploy-hybrid.mdx b/src/langsmith/deploy-hybrid.mdx
@@ -13,8 +13,8 @@ The Hybrid deployment option requires an [Enterprise](/langsmith/plans) plan.
 
 ## Prerequisites
 
-1. Use the [LangGraph CLI](/langsmith/langgraph-cli) to [test your application locally](/langsmith/local-server).
-2. Use the [LangGraph CLI](/langsmith/langgraph-cli) to build a Docker image (i.e. `langgraph build`) and push it to a registry your Kubernetes cluster or Amazon ECS cluster has access to.
+1. Use the [LangGraph CLI](/langsmith/cli) to [test your application locally](/langsmith/local-server).
+2. Use the [LangGraph CLI](/langsmith/cli) to build a Docker image (i.e. `langgraph build`) and push it to a registry your Kubernetes cluster or Amazon ECS cluster has access to.
 
 ## Kubernetes
 
diff --git a/src/langsmith/deploy-self-hosted-full-platform.mdx b/src/langsmith/deploy-self-hosted-full-platform.mdx
@@ -15,8 +15,8 @@ Self-hosting LangSmith Platform with agent deployment requires an [Enterprise](/
 
 1. You are using Kubernetes.
 2. You have an instance of [self-hosted LangSmith Platform](/langsmith/kubernetes) running.
-3. Use the [LangGraph CLI](/langsmith/langgraph-cli) to [test your application locally](/langsmith/local-server).
-4. Use the [LangGraph CLI](/langsmith/langgraph-cli) to build a Docker image (i.e. `langgraph build`) and push it to a registry your Kubernetes cluster has access to.
+3. Use the [LangGraph CLI](/langsmith/cli) to [test your application locally](/langsmith/local-server).
+4. Use the [LangGraph CLI](/langsmith/cli) to build a Docker image (i.e. `langgraph build`) and push it to a registry your Kubernetes cluster has access to.
 5. `KEDA` is installed on your cluster.
 ```bash
   helm repo add kedacore https://kedacore.github.io/charts
diff --git a/src/langsmith/deploy-standalone-server.mdx b/src/langsmith/deploy-standalone-server.mdx
@@ -8,8 +8,8 @@ Before setting up standalone servers, review the [self-hosting overview page](/l
 
 ## Prerequisites
 
-1. Use the [LangGraph CLI](/langsmith/langgraph-cli) to [test your application locally](/langsmith/local-server).
-2. Use the [LangGraph CLI](/langsmith/langgraph-cli) to build a Docker image (i.e. `langgraph build`).
+1. Use the [LangGraph CLI](/langsmith/cli) to [test your application locally](/langsmith/local-server).
+2. Use the [LangGraph CLI](/langsmith/cli) to build a Docker image (i.e. `langgraph build`).
 3. The following environment variables are needed for a data plane deployment.
   1. `REDIS_URI`: Connection details to a Redis instance. Redis will be used as a pub-sub broker to enable streaming real time output from background runs. The value of `REDIS_URI` must be a valid [Redis connection URI](https://redis-py.readthedocs.io/en/stable/connections.html#redis.Redis.from_url).
         <Note>
@@ -27,7 +27,7 @@ Before setting up standalone servers, review the [self-hosting overview page](/l
         </Note>
   3. `LANGSMITH_API_KEY`: LangSmith API key.
   4. `LANGGRAPH_CLOUD_LICENSE_KEY`: LangSmith Platform license key. This will be used to authenticate ONCE at server start up.
-  5. `LANGSMITH_ENDPOINT`: To send traces to a [self-hosted LangSmith](/langsmith/architectural-overview) instance, set `LANGSMITH_ENDPOINT` to the hostname of the self-hosted LangSmith instance.
+  5. `LANGSMITH_ENDPOINT`: To send traces to a [self-hosted LangSmith](/langsmith/self-hosted) instance, set `LANGSMITH_ENDPOINT` to the hostname of the self-hosted LangSmith instance.
 4. Egress to `https://beacon.langchain.com` from your network. This is required for license verification and usage reporting if not running in air-gapped mode. See the [Egress documentation](/langsmith/egress-metrics-metadata) for more details.
 
 <a id="helm"></a>
diff --git a/src/langsmith/docker.mdx b/src/langsmith/docker.mdx
@@ -62,7 +62,7 @@ Copy the `docker-compose.yml` file and all files in that directory from the Lang
 ### 2. Configure environment variables
 
 1. Copy the `.env.example` file from the LangSmith SDK to your project directory and rename it to `.env`.
-2. Configure the appropriate values in the `.env` file. You can find the available configuration options in the [Configuration](/langsmith/architectural-overview) section.
+2. Configure the appropriate values in the `.env` file. You can find the available configuration options in the [Configuration](/langsmith/self-hosted) section.
 
 You can also set these environment variables in the `docker-compose.yml` file directly or export them in your terminal. We recommend setting them in the `.env` file.
 
@@ -110,7 +110,7 @@ docker-compose down
 
 ## Using LangSmith
 
-Now that LangSmith is running, you can start using it to trace your code. You can find more information on how to use self-hosted LangSmith in the [self-hosted usage guide](/langsmith/architectural-overview).
+Now that LangSmith is running, you can start using it to trace your code. You can find more information on how to use self-hosted LangSmith in the [self-hosted usage guide](/langsmith/self-hosted).
 
 Your LangSmith instance is now running but may not be fully setup yet.
 
diff --git a/src/langsmith/env-var.mdx b/src/langsmith/env-var.mdx
@@ -56,13 +56,13 @@ Defaults to `150` connections.
 
 ## `LANGSMITH_API_KEY`
 
-For deployments with [self-hosted LangSmith](/langsmith/architectural-overview) only.
+For deployments with [self-hosted LangSmith](/langsmith/self-hosted) only.
 
 To send traces to a self-hosted LangSmith instance, set `LANGSMITH_API_KEY` to an API key created from the self-hosted instance.
 
 ## `LANGSMITH_ENDPOINT`
 
-For deployments with [self-hosted LangSmith](/langsmith/architectural-overview) only.
+For deployments with [self-hosted LangSmith](/langsmith/self-hosted) only.
 
 To send traces to a self-hosted LangSmith instance, set `LANGSMITH_ENDPOINT` to the hostname of the self-hosted instance.
 
diff --git a/src/langsmith/faq.mdx b/src/langsmith/faq.mdx
@@ -22,7 +22,7 @@ You can find more information on setting up SSO in the [configuration section.](
 
 ### *Can I use external storage services?*
 
-* You can configure LangSmith to use external versions of all storage services. In a production setting, we strongly recommend using external storage services. Check out the [configuration section](/langsmith/architectural-overview) for more information.
+* You can configure LangSmith to use external versions of all storage services. In a production setting, we strongly recommend using external storage services. Check out the [configuration section](/langsmith/self-hosted) for more information.
 
 ### *Does my application need egress to function properly?*
 
diff --git a/src/langsmith/kubernetes.mdx b/src/langsmith/kubernetes.mdx
@@ -115,7 +115,7 @@ For more information, refer to the following setup guides for external services:
 ## Configure your Helm Charts:
 
 1. Create a new file called `langsmith_config.yaml` with the configuration options from the previous step.
-   1. There are several configuration options that you can set in the `langsmith_config.yaml` file. You can find more information on specific configuration options in the [Configuration](/langsmith/architectural-overview) section.
+   1. There are several configuration options that you can set in the `langsmith_config.yaml` file. You can find more information on specific configuration options in the [Configuration](/langsmith/self-hosted) section.
    2. If you are new to Kubernetes or Helm, we’d recommend starting with one of the example configurations in the examples directory of the Helm Chart repository here: [LangSmith helm chart examples](https://github.com/langchain-ai/helm/tree/main/charts/langsmith/examples).
    3. You can see a full list of configuration options in the `values.yaml` file in the Helm Chart repository here: [LangSmith Helm Chart](https://github.com/langchain-ai/helm/tree/main/charts/langsmith/values.yaml)
 
@@ -234,7 +234,7 @@ You will also need to specify connection details for any external databases you
 
 ## Using LangSmith
 
-Now that LangSmith is running, you can start using it to trace your code. You can find more information on how to use self-hosted LangSmith in the [self-hosted usage guide](/langsmith/architectural-overview).
+Now that LangSmith is running, you can start using it to trace your code. You can find more information on how to use self-hosted LangSmith in the [self-hosted usage guide](/langsmith/self-hosted).
 
 Your LangSmith instance is now running but may not be fully setup yet.
 
@@ -248,4 +248,4 @@ As a next step, it is strongly recommended you work with your infrastructure adm
 * Connect LangSmith to external Postgres and Redis instances
 * Set up [Blob Storage](/langsmith/self-host-blob-storage) for storing large files
 
-Review our [configuration section](/langsmith/architectural-overview) for more information on how to configure these options.
+Review our [configuration section](/langsmith/self-hosted) for more information on how to configure these options.
diff --git a/src/langsmith/langgraph-cli.mdx b/src/langsmith/langgraph-cli.mdx
diff --git a/src/langsmith/langgraph-js-ts-sdk.mdx b/src/langsmith/langgraph-js-ts-sdk.mdx
@@ -1,5 +1,5 @@
 ---
-title: SDK (JS/TS)
-sidebarTitle: LG SDK (JS/TS)
+title: LangGraph SDK (JS/TS)
+sidebarTitle: LangGraph SDK (JS/TS)
 url: "https://langchain-ai.github.io/langgraphjs/reference/modules/sdk.html"
 ---
diff --git a/src/langsmith/langgraph-python-sdk.mdx b/src/langsmith/langgraph-python-sdk.mdx
@@ -1,5 +1,5 @@
 ---
-title: SDK (Python)
-sidebarTitle: LG SDK (Python)
+title: LangGraph SDK (Python)
+sidebarTitle: LangGraph SDK (Python)
 url: "https://langchain-ai.github.io/langgraph/cloud/reference/sdk/python_sdk_ref/"
 ---
diff --git a/src/langsmith/langgraph-studio.mdx b/src/langsmith/langgraph-studio.mdx
@@ -6,7 +6,7 @@ title: Overview
 **Prerequisites**
 * [LangSmith Platform](/langsmith/home)
 * [LangGraph Server](/langsmith/langgraph-server)
-* [LangGraph CLI](/langsmith/langgraph-cli)
+* [LangGraph CLI](/langsmith/cli)
 </Info>
 
 Studio is a specialized agent IDE that enables visualization, interaction, and debugging of agentic systems that implement the LangGraph Server API protocol. Studio also integrates with tracing, evaluation, and prompt engineering.
diff --git a/src/langsmith/langsmith-managed-clickhouse.mdx b/src/langsmith/langsmith-managed-clickhouse.mdx
diff --git a/src/langsmith/quick-start-studio.mdx b/src/langsmith/quick-start-studio.mdx
diff --git a/src/langsmith/reference-overview.mdx b/src/langsmith/reference-overview.mdx
diff --git a/src/langsmith/self-host-custom-tls-certificates.mdx b/src/langsmith/self-host-custom-tls-certificates.mdx
diff --git a/src/langsmith/smith-api-ref.mdx b/src/langsmith/smith-api-ref.mdx

Original file line number	Diff line number	Diff line change
`@@ -1019,15 +1019,14 @@`
`1019`	`1019`	`]`
`1020`	`1020`	`},`
`1021`	`1021`	`"langsmith/cli",`
`1022`		`- "langsmith/env-var",`
`1023`		`- "langsmith/langgraph-cli"`
	`1022`	`+ "langsmith/env-var"`
`1024`	`1023`	`]`
`1025`	`1024`	`},`
`1026`	`1025`	`{`
`1027`	`1026`	`"group": "Scalability & resilience",`
`1028`	`1027`	`"pages": [`
`1029`		`- "langsmith/cloud-architecture-and-scalability",`
`1030`		`- "langsmith/scalability-and-resilience"`
	`1028`	`+ "langsmith/scalability-and-resilience",`
	`1029`	`+ "langsmith/cloud-architecture-and-scalability"`
`1031`	`1030`	`]`
`1032`	`1031`	`},`
`1033`	`1032`	`{`
`@@ -2075,15 +2074,14 @@`
`2075`	`2074`	`]`
`2076`	`2075`	`},`
`2077`	`2076`	`"langsmith/cli",`
`2078`		`- "langsmith/env-var",`
`2079`		`- "langsmith/langgraph-cli"`
	`2077`	`+ "langsmith/env-var"`
`2080`	`2078`	`]`
`2081`	`2079`	`},`
`2082`	`2080`	`{`
`2083`	`2081`	`"group": "Scalability & resilience",`
`2084`	`2082`	`"pages": [`
`2085`		`- "langsmith/cloud-architecture-and-scalability",`
`2086`		`- "langsmith/scalability-and-resilience"`
	`2083`	`+ "langsmith/scalability-and-resilience",`
	`2084`	`+ "langsmith/cloud-architecture-and-scalability"`
`2087`	`2085`	`]`
`2088`	`2086`	`},`
`2089`	`2087`	`{`