From a9855c518bedff065a1a1d81a849fb02dacde184 Mon Sep 17 00:00:00 2001
From: middleDuckAi <269711613+middleDuckAi@users.noreply.github.com>
Date: Tue, 24 Mar 2026 23:49:59 +0700
Subject: [PATCH] docs(config): clarify default agent thread limit

---
 codex-rs/core/config.schema.json | 2 +-
 codex-rs/core/src/config/mod.rs  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/codex-rs/core/config.schema.json b/codex-rs/core/config.schema.json
index 0b7cf3ced96..5f67b2cffd1 100644
--- a/codex-rs/core/config.schema.json
+++ b/codex-rs/core/config.schema.json
@@ -49,7 +49,7 @@
           "type": "integer"
         },
         "max_threads": {
-          "description": "Maximum number of agent threads that can be open concurrently. When unset, no limit is enforced.",
+          "description": "Maximum number of agent threads that can be open concurrently. When unset, Codex defaults this limit to 6.",
           "format": "uint",
           "minimum": 1.0,
           "type": "integer"
diff --git a/codex-rs/core/src/config/mod.rs b/codex-rs/core/src/config/mod.rs
index dc04d9bb14e..30678193401 100644
--- a/codex-rs/core/src/config/mod.rs
+++ b/codex-rs/core/src/config/mod.rs
@@ -1585,7 +1585,7 @@ fn resolve_tool_suggest_config(config_toml: &ConfigToml) -> ToolSuggestConfig {
 #[schemars(deny_unknown_fields)]
 pub struct AgentsToml {
     /// Maximum number of agent threads that can be open concurrently.
-    /// When unset, no limit is enforced.
+    /// When unset, Codex defaults this limit to 6.
     #[schemars(range(min = 1))]
     pub max_threads: Option<usize>,
     /// Maximum nesting depth allowed for spawned agent threads.