@markjaquith/agency 1.3.0 → 1.4.0

package/cli.ts

@@ -409,11 +409,17 @@ const commands: Record<string, Command> = {
 	loop: {
 		name: "loop",
 		description: "Run a Ralph Wiggum loop to complete all tasks",
-		run: async (_args: string[], options: Record<string, any>) => {
+		run: async (args: string[], options: Record<string, any>) => {
 			if (options.help) {
 				console.log(loopHelp)
 				return
 			}
+
+			// Extract extra args (anything after --)
+			// Note: parseArgs with strict:false and allowPositionals:true will put
+			// args after -- in the positionals array
+			const extraArgs = args.length > 0 ? args : undefined
+
 			await runCommand(
 				loop({
 					silent: options.silent,
@@ -422,6 +428,7 @@ const commands: Record<string, Command> = {
 					minLoops: options["min-loops"],
 					opencode: options.opencode,
 					claude: options.claude,
+					extraArgs,
 				}),
 			)
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markjaquith/agency",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Manages personal agents files",
   "license": "MIT",
   "author": "Mark Jaquith",

package/src/commands/loop.test.ts

@@ -523,4 +523,99 @@ describe("loop command", () => {
 			expect(capturedOptions.stderr).toBe("pipe")
 		})
 	})
+
+	describe("extra args pass-through", () => {
+		test("passes extra args to opencode", async () => {
+			const taskPath = join(tempDir, "TASK.md")
+			writeFileSync(taskPath, "# Test Task\n\n- [x] Already done")
+
+			let capturedArgs: string[] = []
+			const restore = mockCliTools({
+				onSpawn: (args) => {
+					capturedArgs = args
+					return {
+						exited: Promise.resolve(0),
+						exitCode: 0,
+						stdout: createEmptyStream(),
+						stderr: createEmptyStream(),
+					}
+				},
+			})
+
+			await runTestEffect(
+				loop({
+					silent: true,
+					maxLoops: 1,
+					extraArgs: ["--agent", "deep"],
+				}),
+			)
+			restore()
+
+			expect(capturedArgs[0]).toBe("opencode")
+			expect(capturedArgs[1]).toBe("run")
+			expect(capturedArgs[2]).toContain("Find the next logical task")
+			expect(capturedArgs.slice(-2)).toEqual(["--agent", "deep"])
+		})
+
+		test("passes extra args to claude", async () => {
+			const taskPath = join(tempDir, "TASK.md")
+			writeFileSync(taskPath, "# Test Task\n\n- [x] Already done")
+
+			let capturedArgs: string[] = []
+			const restore = mockCliTools({
+				hasClaude: true,
+				onSpawn: (args) => {
+					capturedArgs = args
+					return {
+						exited: Promise.resolve(0),
+						exitCode: 0,
+						stdout: createEmptyStream(),
+						stderr: createEmptyStream(),
+					}
+				},
+			})
+
+			await runTestEffect(
+				loop({
+					silent: true,
+					maxLoops: 1,
+					claude: true,
+					extraArgs: ["--arbitrary", "switches"],
+				}),
+			)
+			restore()
+
+			expect(capturedArgs[0]).toBe("claude")
+			expect(capturedArgs[1]).toContain("Find the next logical task")
+			expect(capturedArgs.slice(-2)).toEqual(["--arbitrary", "switches"])
+		})
+
+		test("works without extra args", async () => {
+			const taskPath = join(tempDir, "TASK.md")
+			writeFileSync(taskPath, "# Test Task\n\n- [x] Already done")
+
+			let capturedArgs: string[] = []
+			const restore = mockCliTools({
+				onSpawn: (args) => {
+					capturedArgs = args
+					return {
+						exited: Promise.resolve(0),
+						exitCode: 0,
+						stdout: createEmptyStream(),
+						stderr: createEmptyStream(),
+					}
+				},
+			})
+
+			await runTestEffect(loop({ silent: true, maxLoops: 1 }))
+			restore()
+
+			// Should just have the base args without extra args
+			expect(capturedArgs).toEqual([
+				"opencode",
+				"run",
+				expect.stringContaining("Find the next logical task"),
+			])
+		})
+	})
 })

package/src/commands/loop.ts

@@ -31,6 +31,10 @@ interface LoopOptions extends BaseCommandOptions {
 	 * Force use of Claude Code CLI
 	 */
 	claude?: boolean
+	/**
+	 * Additional arguments to pass to the CLI tool
+	 */
+	extraArgs?: string[]
 }
 
 interface LoopState {
@@ -193,6 +197,7 @@ export const loop = (options: LoopOptions = {}) =>
 				gitRoot,
 				options.verbose ?? false,
 				verboseLog,
+				options.extraArgs,
 			).pipe(
 				Effect.map(() => true),
 				Effect.catchAll(() => Effect.succeed(false)),
@@ -210,6 +215,7 @@ export const loop = (options: LoopOptions = {}) =>
 					gitRoot,
 					options.verbose ?? false,
 					verboseLog,
+					options.extraArgs,
 				).pipe(
 					Effect.map(() => true),
 					Effect.catchAll(() => Effect.succeed(false)),
@@ -317,6 +323,7 @@ function runHarness(
 	gitRoot: string,
 	verbose: boolean,
 	verboseLog: (msg: string) => void,
+	extraArgs?: string[],
 ): Effect.Effect<void, Error> {
 	return Effect.gen(function* () {
 		const prompt =
@@ -326,9 +333,13 @@ function runHarness(
 		// claude: use `claude "prompt"` (positional argument)
 		const baseArgs = useOpencode ? [cliName, "run", prompt] : [cliName, prompt]
 
+		// Append extra args if provided
+		const cliArgs =
+			extraArgs && extraArgs.length > 0 ? [...baseArgs, ...extraArgs] : baseArgs
+
 		// Log the command being run when verbose
 		// Quote arguments that contain spaces for proper display
-		const quotedArgs = baseArgs.map((arg) =>
+		const quotedArgs = cliArgs.map((arg) =>
 			arg.includes(" ") ? `"${arg}"` : arg,
 		)
 		verboseLog(`Running: ${quotedArgs.join(" ")}`)
@@ -336,7 +347,7 @@ function runHarness(
 		// When verbose, stream output directly to the terminal
 		// When not verbose, capture output silently
 		// Always inherit stdin so the process doesn't hang waiting for input
-		const result = yield* spawnProcess(baseArgs, {
+		const result = yield* spawnProcess(cliArgs, {
 			cwd: gitRoot,
 			stdin: "inherit",
 			stdout: verbose ? "inherit" : "pipe",
@@ -356,7 +367,7 @@ function runHarness(
 }
 
 export const help = `
-Usage: agency loop [options]
+Usage: agency loop [options] [-- extra-args...]
 
 Run a Ralph Wiggum loop that repeatedly invokes the harness (opencode or claude)
 to work on tasks defined in TASK.md until all tasks are complete.
@@ -377,15 +388,19 @@ Options:
   -s, --silent          Suppress output messages
   -v, --verbose         Stream harness output to terminal
 
+Pass-through Arguments:
+  Use -- to pass additional arguments to the underlying CLI tool.
+  Everything after -- will be forwarded to opencode or claude.
+
 Examples:
-  agency loop                      # Run until all tasks are done
-  agency loop --max-loops 5        # Stop after 5 iterations
-  agency loop --min-loops 3        # Require at least 3 iterations
-  agency loop --min-loops 3 --max-loops 10  # Between 3-10 iterations
+  agency loop                          # Run until all tasks are done
+  agency loop --max-loops 5            # Stop after 5 iterations
+  agency loop -- --agent deep          # Pass --agent deep to harness
 
 Notes:
   - Requires TASK.md to exist (run 'agency task' first)
   - Each iteration calls the harness which handles its own commit
   - The loop validates that completion claims match actual task status
   - Use --min-loops as a safeguard if you know the minimum work required
+  - Arguments after -- are passed directly to the underlying tool
 `