Skip to content

Commit ad52ebf

Browse files
Kasper JungeRalphify
authored andcommitted
docs: add --timeout safety tip to iteration guidance
The "How many iterations?" section covered -n and --stop-on-error but didn't mention --timeout, which is important for unattended runs where the agent could hang on an interactive prompt or enter an infinite loop. Co-authored-by: Ralphify <noreply@ralphify.co>
1 parent 0e0ffa0 commit ad52ebf

1 file changed

Lines changed: 1 addition & 0 deletions

File tree

docs/when-to-use.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,7 @@ Some tasks seem like they don't fit but can be adapted:
8080
- **Use `-n 10-20`** for bounded tasks (a TODO list with known items)
8181
- **Run unlimited** (`ralph run my-ralph` without `-n`) for open-ended improvement tasks with good command feedback — the commands prevent the agent from going off the rails
8282
- **Use `--stop-on-error`** when each iteration must succeed before the next one makes sense
83+
- **Set `--timeout`** as a safety net for unattended runs — if the agent enters an unexpected state (interactive prompt, infinite loop), the timeout kills it instead of blocking the loop forever
8384

8485
## Next steps
8586

0 commit comments

Comments
 (0)