diff --git a/packages/opencode/src/cli/cmd/command-groups.ts b/packages/opencode/src/cli/cmd/command-groups.ts
index eae0625860ea..5b56a496cb09 100644
--- a/packages/opencode/src/cli/cmd/command-groups.ts
+++ b/packages/opencode/src/cli/cmd/command-groups.ts
@@ -206,6 +206,7 @@ export const COMMAND_CATEGORY_MAP: Record<string, string> = {
   generate: "core",
   debug: "core",
   auth: "core",
+  login: "core",
   agent: "core",
   upgrade: "core",
   uninstall: "core",
diff --git a/packages/opencode/src/index.ts b/packages/opencode/src/index.ts
index a459071fc6bf..f7618d68dc5f 100644
--- a/packages/opencode/src/index.ts
+++ b/packages/opencode/src/index.ts
@@ -3,7 +3,7 @@ import { hideBin } from "yargs/helpers"
 import { RunCommand } from "./cli/cmd/run"
 import { GenerateCommand } from "./cli/cmd/generate"
 import { Log } from "./util/log"
-import { AuthCommand } from "./cli/cmd/auth"
+import { AuthCommand, AuthLoginCommand } from "./cli/cmd/auth"
 import { AgentCommand } from "./cli/cmd/agent"
 import { UpgradeCommand } from "./cli/cmd/upgrade"
 import { UninstallCommand } from "./cli/cmd/uninstall"
@@ -245,6 +245,8 @@ const cli = yargs(rawArgs)
   .command(reg(GenerateCommand))
   .command(reg(DebugCommand))
   .command(reg(AuthCommand))
+  // Top-level alias for `iris auth login` — same command module, so behavior can't drift.
+  .command(reg(AuthLoginCommand))
   .command(reg(AgentCommand))
   .command(reg(UpgradeCommand))
   .command(reg(UninstallCommand))