Files
deepseek-harness/packages/experimental/ralph-bundle/docs/DETAIL.md
T
turtle1999 2738347d06 docs(experimental): make the agent team, terminal, Ralph, and plugin market details more direct
The team illustration shows the conversation whose title bar holds the Agent Team button. The terminal and Ralph pages say plainly that these are the agent's tool calls and what each round sees. The plugin market page describes a market as an index URL you add, without implying who owns it.
2026-10-20 00:22:49 +08:00

1.4 KiB

A Ralph loop that ran three rounds with fresh agents until the last round reported the goal met

Ask for a Ralph loop with a goal, and the agent starts a fresh agent on it, round after round, until a round reports the goal met or a blocker, or the round limit is reached. Each round sees only the goal, the workspace files, and the last round's short report, not the conversation.

How to use

  • Say "Ralph loop" and give a goal that can be checked from the files, for example: "Run a Ralph loop until pnpm lint passes with zero warnings. Give it at most 5 rounds."
  • The loop appears in the conversation as Run ralph loop, marked Worker reported completion, Worker reported a blocker, or Round limit reached. Expand it to see the last report, Rounds, any Remaining work, and the Task.

Good to know

  • Agents are told to use it only when you ask for a Ralph loop or for repeated work with fresh agents.
  • Completion and blockers are the last agent's own report. Check the result yourself.
  • Anything a round does not write to the files or its report is lost. A round without a valid report stops the loop with an error.
  • The conversation waits for the whole loop. Stopping the reply stops the loop.
  • A loop runs at most 64 rounds; asking for more fails. Each round is a full agent run, so cost grows with each round.
  • Turning the plugin off removes the loop from every agent's next request.