Remove ralph-loop tool and delegate to memory-plan-ralph

Author: chriswritescode-dev

docs/features/memory.md

@@ -434,17 +434,6 @@ No parameters required.
 
 Returns a list of all stored keys with their values and expiration times. Useful for debugging or inspecting current project state.
 
-### ralph-loop
-
-Start a Ralph iterative development loop. By default runs in an isolated git worktree. Set `inPlace` to `true` to run in the current directory instead.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | string | Yes | The task prompt to iterate on |
-| `completionPromise` | string | No | Phrase that signals completion when wrapped in `<promise>` tags |
-| `name` | string | No | Name for the worktree branch |
-| `inPlace` | boolean | No | Run in current directory instead of creating a worktree |
-
 ### ralph-cancel
 
 Cancel an active Ralph loop and optionally clean up the worktree.
@@ -551,7 +540,6 @@ During a Ralph loop, certain tools are blocked to keep the agent focused:
 - `question` — No interactive questions; work autonomously
 - `memory-plan-execute` — Cannot start new plan sessions
 - `memory-plan-ralph` — Cannot start nested Ralph loops
-- `ralph-loop` — Cannot start additional loops
 
 Blocking is enforced via `tool.execute.before` (throws error) with `tool.execute.after` as defense in depth.
 
@@ -566,7 +554,7 @@ Blocking is enforced via `tool.execute.before` (throws error) with `tool.execute
 
 | Command | Description |
 |---------|-------------|
-| `/ralph-loop <prompt>` | Start a Ralph loop via the Code agent |
+| `/ralph-loop <prompt>` | Start a Ralph loop (delegates to memory-plan-ralph) |
 | `/cancel-ralph` | Cancel the active Ralph loop |
 
 ---
@@ -654,7 +642,7 @@ The default agent is set to `code`.
 | Command | Description | Agent | Mode |
 |---------|-------------|-------|------|
 | `/review` | Run a code review on current changes | auditor | subtask |
-| `/ralph-loop` | Start a Ralph iterative development loop | code | direct |
+| `/ralph-loop` | Start a Ralph loop (delegates to memory-plan-ralph) | code | direct |
 | `/cancel-ralph` | Cancel the active Ralph loop | code | direct |
 
 ---
@@ -711,7 +699,7 @@ Memory injection is controlled independently by `memoryInjection.enabled` (defau
 
 ### tool.execute.before
 
-Blocks certain tools during active Ralph loops to keep the agent focused on the current task. Throws an error with a descriptive message when a blocked tool is called. Blocked tools: `question`, `memory-plan-execute`, `memory-plan-ralph`, `ralph-loop`.
+Blocks certain tools during active Ralph loops to keep the agent focused on the current task. Throws an error with a descriptive message when a blocked tool is called. Blocked tools: `question`, `memory-plan-execute`, `memory-plan-ralph`.
 
 ### tool.execute.after
 

packages/memory/README.md

@@ -82,7 +82,6 @@ Iterative development loops with automatic auditing. Runs in an isolated git wor
 
 | Tool | Description |
 |------|-------------|
-| `ralph-loop` | Start an iterative development loop with optional auditing |
 | `ralph-cancel` | Cancel an active Ralph loop and clean up the worktree |
 | `ralph-status` | Check status of active Ralph loops |
 | `memory-plan-ralph` | Execute an architect plan using a Ralph iterative loop |
@@ -92,7 +91,7 @@ Iterative development loops with automatic auditing. Runs in an isolated git wor
 | Command | Description | Agent |
 |---------|-------------|-------|
 | `/review` | Run a code review on current changes | auditor (subtask) |
-| `/ralph-loop` | Start a Ralph iterative development loop | code |
+| `/ralph-loop` | Start a Ralph loop (delegates to memory-plan-ralph) | code |
 | `/cancel-ralph` | Cancel the active Ralph loop | code |
 
 ## CLI
@@ -330,7 +329,7 @@ The loop completes when the Code agent outputs the completion promise. It auto-t
 
 By default, Ralph loops run in an isolated git worktree. Set `inPlace: true` to run in the current directory instead (skips worktree creation, auto-commit, and cleanup).
 
-See the [full documentation](https://chriswritescode-dev.github.io/opencode-manager/features/memory/#ralph-loop) for details.
+See the [full documentation](https://chriswritescode-dev.github.io/opencode-manager/features/memory/#ralph-loop) for details on the Ralph loop system.
 
 ## Documentation
 

packages/memory/src/config.ts

@@ -21,7 +21,7 @@ const PLUGIN_COMMANDS: Record<string, { template: string; description: string; a
     description: 'Start a Ralph iterative development loop in a worktree',
     agent: 'code',
     subtask: false,
-    template: 'Use the ralph-loop tool to start a Ralph loop with the following arguments: $ARGUMENTS',
+    template: 'Use the memory-plan-ralph tool to start a Ralph loop. Use the following as the plan: $ARGUMENTS. Derive a short title from the plan.',
   },
   'cancel-ralph': {
     description: 'Cancel the active Ralph loop',

packages/memory/src/index.ts

@@ -592,7 +592,6 @@ export function createMemoryPlugin(config: PluginConfig): Plugin {
       question: 'The question tool is not available during a Ralph loop. Do not ask questions — continue working on the task autonomously.',
       'memory-plan-execute': 'The memory-plan-execute tool is not available during a Ralph loop. Focus on executing the current plan.',
       'memory-plan-ralph': 'The memory-plan-ralph tool is not available during a Ralph loop. Focus on executing the current plan.',
-      'ralph-loop': 'The ralph-loop tool is not available during a Ralph loop. Focus on executing the current plan.',
     }
 
     const PLAN_APPROVAL_LABELS = ['New session', 'Execute here', 'Ralph (worktree)', 'Ralph (in place)']
@@ -936,38 +935,7 @@ Do NOT output text without also making this tool call.
             return `${entries.length} active KV entries:\n\n${formatted.join('\n')}`
           },
         }),
-        'ralph-loop': tool({
-          description: 'Start a Ralph Wiggum iterative development loop. By default runs in an isolated git worktree. Set inPlace to true to run in the current directory instead.',
-          args: {
-            prompt: z.string().describe('The task prompt to iterate on'),
-            completionPromise: z.string().optional().describe('Phrase that signals completion when wrapped in <promise> tags'),
-            name: z.string().optional().describe('Optional name for the worktree branch'),
-            inPlace: z.boolean().optional().describe('Run in current directory instead of creating a worktree'),
-          },
-          execute: async (args, context) => {
-            if (config.ralph?.enabled === false) {
-              return 'Ralph loops are disabled in plugin config.'
-            }
 
-            logger.log(`ralph-loop: creating worktree for prompt="${args.prompt.substring(0, 80)}"`)
-
-            const titlePreview = args.prompt.length > 40 ? `${args.prompt.substring(0, 37)}...` : args.prompt
-            const ralphModel = parseModelString(config.ralph?.model) ?? parseModelString(config.executionModel)
-
-            return setupRalphLoop({
-              prompt: args.prompt,
-              sessionTitle: `Ralph: ${titlePreview}`,
-              worktreeName: args.name,
-              completionPromise: args.completionPromise ?? null,
-              maxIterations: config.ralph?.defaultMaxIterations ?? 0,
-              audit: config.ralph?.defaultAudit ?? true,
-              model: ralphModel,
-              inPlace: args.inPlace,
-              parentSessionId: context.sessionID,
-              onLoopStarted: (id) => ralphHandler.startWatchdog(id),
-            })
-          },
-        }),
         'ralph-cancel': tool({
           description: 'Cancel an active Ralph loop and optionally clean up the worktree.',
           args: {

packages/memory/test/plan-approval.test.ts

@@ -132,7 +132,6 @@ Do NOT output text without also making this tool call.
       question: 'The question tool is not available during a Ralph loop. Do not ask questions — continue working on the task autonomously.',
       'memory-plan-execute': 'The memory-plan-execute tool is not available during a Ralph loop. Focus on executing the current plan.',
       'memory-plan-ralph': 'The memory-plan-ralph tool is not available during a Ralph loop. Focus on executing the current plan.',
-      'ralph-loop': 'The ralph-loop tool is not available during a Ralph loop. Focus on executing the current plan.',
     }
 
     if (!(tool in RALPH_BLOCKED_TOOLS)) return
@@ -348,15 +347,6 @@ Do NOT output text without also making this tool call.
     expect(output.output).toContain('memory-plan-ralph tool is not available')
   })
 
-  test('Ralph blocking works for ralph-loop tool', () => {
-    const output = { title: '', output: 'test', metadata: {} }
-
-    simulateToolExecuteAfter('ralph-loop', {}, output, true)
-
-    expect(output.title).toBe('Tool blocked')
-    expect(output.output).toContain('ralph-loop tool is not available')
-  })
-
   test('Ralph blocking does not affect non-blocked tools', () => {
     const output = { title: '', output: 'test', metadata: {} }
 

packages/memory/test/tool-blocking.test.ts

@@ -107,32 +107,27 @@ describe('Tool Blocking Logic', () => {
 
   describe('Blocked tools list', () => {
     test('includes question tool', () => {
-      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph', 'ralph-loop']
+      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph']
       expect(blockedTools).toContain('question')
     })
 
     test('includes memory-plan-execute tool', () => {
-      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph', 'ralph-loop']
+      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph']
       expect(blockedTools).toContain('memory-plan-execute')
     })
 
     test('includes memory-plan-ralph tool', () => {
-      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph', 'ralph-loop']
+      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph']
       expect(blockedTools).toContain('memory-plan-ralph')
     })
 
-    test('includes ralph-loop tool', () => {
-      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph', 'ralph-loop']
-      expect(blockedTools).toContain('ralph-loop')
-    })
-
     test('does not include memory-read tool', () => {
-      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph', 'ralph-loop']
+      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph']
       expect(blockedTools).not.toContain('memory-read')
     })
 
     test('does not include memory-write tool', () => {
-      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph', 'ralph-loop']
+      const blockedTools = ['question', 'memory-plan-execute', 'memory-plan-ralph']
       expect(blockedTools).not.toContain('memory-write')
     })
   })
@@ -143,7 +138,6 @@ describe('Tool Blocking Logic', () => {
         'question': 'The question tool is not available during a Ralph loop. Do not ask questions — continue working on the task autonomously.',
         'memory-plan-execute': 'The memory-plan-execute tool is not available during a Ralph loop. Focus on executing the current plan.',
         'memory-plan-ralph': 'The memory-plan-ralph tool is not available during a Ralph loop. Focus on executing the current plan.',
-        'ralph-loop': 'The ralph-loop tool is not available during a Ralph loop. Focus on executing the current plan.',
       }
       expect(messages['question']).toContain('question tool is not available')
     })
@@ -153,7 +147,6 @@ describe('Tool Blocking Logic', () => {
         'question': 'The question tool is not available during a Ralph loop. Do not ask questions — continue working on the task autonomously.',
         'memory-plan-execute': 'The memory-plan-execute tool is not available during a Ralph loop. Focus on executing the current plan.',
         'memory-plan-ralph': 'The memory-plan-ralph tool is not available during a Ralph loop. Focus on executing the current plan.',
-        'ralph-loop': 'The ralph-loop tool is not available during a Ralph loop. Focus on executing the current plan.',
       }
       expect(messages['memory-plan-execute']).toContain('memory-plan-execute tool is not available')
     })