Merge pull request #238 from krissetto/max-iter-docs

Mention max_iterations in the docs

Author: dgageot

README.md

@@ -234,7 +234,7 @@ cagent new --model dmr/ai/gemma3-qat:12B
 # Override the max_tokens used during generation, default is 64k, 16k when using the dmr provider
 cagent new --model openai/gpt-5-mini --max-tokens 32000
 
-# Override max_iterations to limit how much the model can loop autonomously
+# Override max_iterations to limit how much the model can loop autonomously when tool calling
 cagent new --model dmr/ai/gemma3n:2B-F16 --max-iterations 15
 ```
 

docs/USAGE.md

@@ -87,6 +87,7 @@ During CLI sessions, you can use special commands:
 | `toolsets`             | array   | Available tools                                                 | ✗        |
 | `add_date`             | boolean | Add current date to context                                     | ✗        |
 | `add_environment_info` | boolean | Add information about the environment (working dir, OS, git...) | ✗        |
+| `max_iterations`       | int     | Specifies how many times the agent can loop when using tools    | ✗        |
 
 #### Example
 
@@ -100,6 +101,7 @@ agents:
     sub_agents: [] # Sub-agent names (optional)
     add_date: boolean # Add current date to context (optional)
     add_environment_info: boolean # Add information about the environment (working dir, OS, git...) (optional)
+    max_iterations: int # How many times this agent can loop when calling tools (optional, default = unlimited)
 ```
 
 ### Model Properties