diff --git a/packages/opencode/src/cli/cmd/research.ts b/packages/opencode/src/cli/cmd/research.ts
new file mode 100644
index 000000000000..c45e6e9220a1
--- /dev/null
+++ b/packages/opencode/src/cli/cmd/research.ts
@@ -0,0 +1,210 @@
+import { EOL } from "os"
+import path from "path"
+import { mkdir, writeFile, chmod } from "node:fs/promises"
+import { existsSync } from "node:fs"
+import { Effect } from "effect"
+import { effectCmd, fail } from "../effect-cmd"
+import { UI } from "../ui"
+
+function programMD(goal: string): string {
+  return `# Autoresearch
+
+You are an autonomous researcher. Your job: iterate on \`target/\` to improve
+a measurable score. The human edits this file; you do the actual work.
+
+## Research Goal
+
+${goal}
+
+## Setup
+
+1. Read this file and \`eval/eval.sh\` completely.
+2. Read \`target/\` — this is what you will iterate on.
+3. Read \`results.tsv\` if it exists (prior experiment history).
+4. **Establish a baseline**: run \`bash eval/eval.sh\` and record the score.
+5. You are now ready to experiment. Never stop until interrupted.
+
+## What You Can Do
+
+- Modify any file inside \`target/\` — architecture, implementation, params.
+- Create new files inside \`target/\`.
+- Run \`bash eval/eval.sh\` at any time to get the current score.
+- Run any shell command to test your changes (compile, lint, benchmark).
+
+## What You Cannot Do
+
+- Modify anything inside \`eval/\`. These files are read-only.
+- Modify \`program.md\`.
+- Install new system packages.
+
+## The Metric
+
+\`eval/eval.sh\` outputs a single float to stdout (first line). **Lower is better**.
+If the script exits non-zero, the experiment is a crash (score = 999.0).
+
+## Results
+
+Log every experiment in \`results.tsv\` (tab-separated):
+- \`commit\` — git hash or "none"
+- \`score\` — metric value (999.0 for crashes)
+- \`status\` — \`keep\`, \`discard\`, or \`crash\`
+- \`description\` — what you tried
+
+## Experiment Loop
+
+LOOP FOREVER:
+
+1. Review state + past results.
+2. Form a hypothesis: what change might improve the score?
+3. Implement it in \`target/\`.
+4. \`git commit -am "experiment: <desc>"\`.
+5. Run \`bash eval/eval.sh\` and capture the score.
+6. Log the result in \`results.tsv\`.
+7. If score improved → keep the change and advance.
+8. If score regressed → \`git reset --hard HEAD~1\`.
+9. Go to step 1.
+
+## Guidelines
+
+- **Never stop**. You are autonomous. The human may be asleep.
+- **Run out of ideas?** Combine near-misses, try radical changes, re-read prior results.
+- **Crashes**: fix obvious bugs and retry; if fundamentally broken, discard.
+- **Simplicity**: simpler is better.
+- **Timeout**: kill experiments exceeding 10 minutes, treat as crash.
+`
+}
+
+const evalShTemplate = `#!/bin/bash
+# Default: count lines of code in target/ (simplicity metric)
+find target/ -type f \\( -name "*.py" -o -name "*.js" -o -name "*.ts" -o -name "*.go" -o -name "*.rs" \\) 2>/dev/null | xargs wc -l 2>/dev/null | tail -1 | awk '{print $1}' || echo "0"
+`
+
+const startShTemplate = `#!/bin/bash
+set -euo pipefail
+cd "$(dirname "$0")"
+echo "Autoresearch loop starting. Ctrl+C to stop."
+echo "Goal: $(sed -n '1s/^# //p' program.md)"
+opencode run --auto --agent build "I am an autonomous researcher. Read program.md and start the experiment loop. Never stop until interrupted."
+`
+
+async function scaffoldWorkspace(dir: string, goal: string): Promise<void> {
+  const root = path.resolve(dir)
+  await mkdir(path.join(root, "target"), { recursive: true })
+  await mkdir(path.join(root, "eval"), { recursive: true })
+  await writeFile(path.join(root, "program.md"), programMD(goal), "utf-8")
+  await writeFile(path.join(root, "eval", "eval.sh"), evalShTemplate, "utf-8")
+  await writeFile(path.join(root, "start.sh"), startShTemplate, "utf-8")
+  await writeFile(path.join(root, "results.tsv"), "commit\tscore\tstatus\tdescription" + EOL, "utf-8")
+  await writeFile(path.join(root, "target", ".gitkeep"), "", "utf-8")
+  await chmod(path.join(root, "eval", "eval.sh"), 0o755)
+  await chmod(path.join(root, "start.sh"), 0o755)
+  const { execSync } = await import("node:child_process")
+  execSync("git init 2>/dev/null; true", { cwd: root, stdio: "ignore", timeout: 5000 })
+}
+
+function runBaseline(dir: string): Effect.Effect<void> {
+  return Effect.promise(async () => {
+    const { execSync } = await import("node:child_process")
+    const out = execSync("bash eval/eval.sh", { cwd: dir, encoding: "utf-8", timeout: 30000 })
+    const score = out.split(EOL)[0].trim()
+    const line = `none\t${score}\tkeep\tbaseline (initial)` + EOL
+    await writeFile(path.join(dir, "results.tsv"), `commit\tscore\tstatus\tdescription` + EOL + line, "utf-8")
+    UI.println("  Baseline score: " + score)
+  }).pipe(
+    Effect.catch(() =>
+      Effect.sync(() => {
+        UI.println(UI.Style.TEXT_WARNING_BOLD + "  !" + UI.Style.TEXT_NORMAL + " Baseline eval failed (customize eval/eval.sh for your task)")
+      }),
+    ),
+  )
+}
+
+function spawnAgent(dir: string, goal: string, model?: string, agent?: string): Effect.Effect<void> {
+  return Effect.promise(async () => {
+    const opencodeBin = process.env.OPENCODE || "opencode"
+    const runArgs = ["run", "--auto", "--agent", agent || "build", "--dir", dir]
+    if (model) runArgs.push("--model", model)
+    runArgs.push("I am an autonomous researcher. Read program.md and start the experiment loop. Never stop until interrupted.")
+    const { spawn } = await import("node:child_process")
+    const child = spawn(opencodeBin, runArgs, {
+      stdio: "inherit",
+      env: { ...process.env, OPENCODE_RESEARCH_GOAL: goal },
+    })
+    await new Promise<void>((resolve) => {
+      child.on("exit", (code) => {
+        if (code !== 0 && code !== 130 && code !== 143) {
+          UI.println(UI.Style.TEXT_WARNING_BOLD + "!" + UI.Style.TEXT_NORMAL + ` Agent exited with code ${code}`)
+        }
+        resolve()
+      })
+      child.on("error", (err) => {
+        UI.error("Failed to launch agent: " + err.message)
+        resolve()
+      })
+    })
+  })
+}
+
+function printWorkspaceInfo(dir: string, goal: string): void {
+  UI.empty()
+  UI.println("  goal:    " + goal)
+  UI.println("  program: " + path.join(dir, "program.md"))
+  UI.println("  target:  " + path.join(dir, "target/"))
+  UI.println("  eval:    " + path.join(dir, "eval/eval.sh"))
+  UI.println("  results: " + path.join(dir, "results.tsv"))
+  UI.empty()
+}
+
+export const ResearchCommand = effectCmd({
+  command: "research [query..]",
+  describe: "run an autonomous research experiment (autoresearch pattern)",
+  instance: false,
+  builder: (yargs) =>
+    yargs
+      .positional("query", {
+        describe: "research goal",
+        type: "string",
+        array: true,
+      })
+      .option("dir", {
+        type: "string",
+        describe: "workspace directory",
+        default: ".autoresearch",
+      })
+      .option("goal", {
+        type: "string",
+        describe: "research goal (if not provided via query)",
+      })
+      .option("model", {
+        alias: "m",
+        type: "string",
+        describe: "model to use for the research agent",
+      })
+      .option("agent", {
+        alias: "a",
+        type: "string",
+        describe: "agent to use (default: build)",
+        default: "build",
+      })
+      .option("baseline", {
+        type: "boolean",
+        describe: "run baseline eval after scaffolding",
+        default: true,
+      }),
+  handler: Effect.fn("Cli.research")(function* (args) {
+    const goal = args.goal || args.query?.join(" ") || ""
+    if (!goal) return yield* fail("Usage: opencode research <goal>")
+
+    const dir = path.resolve(args.dir)
+    if (!existsSync(dir)) {
+      yield* Effect.promise(() => scaffoldWorkspace(dir, goal))
+      UI.println(UI.Style.TEXT_SUCCESS_BOLD + "✓" + UI.Style.TEXT_NORMAL + " Created " + dir)
+      if (args.baseline) yield* runBaseline(dir)
+    } else UI.println(UI.Style.TEXT_WARNING_BOLD + "!" + UI.Style.TEXT_NORMAL + " Using existing workspace " + dir)
+
+    printWorkspaceInfo(dir, goal)
+    UI.println("Launching research agent... (Ctrl+C to stop)")
+    UI.empty()
+    yield* spawnAgent(dir, goal, args.model, args.agent)
+  }),
+})
diff --git a/packages/opencode/src/index.ts b/packages/opencode/src/index.ts
index 13540a73a36f..05c3ec5c8a95 100644
--- a/packages/opencode/src/index.ts
+++ b/packages/opencode/src/index.ts
@@ -25,6 +25,7 @@ import { EOL } from "os"
 import { WebCommand } from "./cli/cmd/web"
 import { PrCommand } from "./cli/cmd/pr"
 import { SessionCommand } from "./cli/cmd/session"
+import { ResearchCommand } from "./cli/cmd/research"
 import { DbCommand } from "./cli/cmd/db"
 import { errorMessage } from "./util/error"
 import { PluginCommand } from "./cli/cmd/plug"
@@ -99,6 +100,7 @@ const cli = yargs(args)
   .command(GithubCommand)
   .command(PrCommand)
   .command(SessionCommand)
+  .command(ResearchCommand)
   .command(PluginCommand)
   .command(DbCommand)
   .fail((msg, err) => {