opencode-onboard 0.4.1 → 0.4.3

package/content/AGENTS.md

@@ -63,13 +63,30 @@ The output must be a real, populated `ARCHITECTURE.md` based on what you found i
 
 ---
 
-### Step 4, Rewrite this file
+### Step 4, Populate OpenSpec config
+
+Read `openspec/config.yaml`. It contains a template with commented-out examples. Fill in the `context:` field with real project information discovered during steps 1-3:
+
+```yaml
+context: |
+  Tech stack: <languages, frameworks, libraries found in the codebase>
+  Build system: <build tools, package managers>
+  Architecture: <monolith, microservices, monorepo, etc.>
+  Conventions: <coding style, commit conventions, branching strategy if found>
+  Domain: <what this project does, in one line>
+```
+
+Keep the `schema: spec-driven` line. Add `rules:` only if the codebase has clear conventions worth enforcing (e.g., max task size, proposal format). Do not invent rules that aren't evidenced by the codebase.
+
+---
+
+### Step 5, Rewrite this file
 
 Replace the entire contents of this file (`AGENTS.md`) with everything below the line `<!-- AGENTS-TEMPLATE-START -->` in this same file. Delete the bootstrap section and the template marker, the file should contain only the template content when done.
 
 ---
 
-### Step 5, Confirm
+### Step 6, Confirm
 
 Tell the user:
 
@@ -80,6 +97,7 @@ Tell the user:
 
 - ARCHITECTURE.md generated
 - DESIGN.md generated
+- openspec/config.yaml populated
 - Project history archived in openspec
 - AGENTS.md updated with real guidance
 
@@ -98,7 +116,7 @@ After restarting you are ready to work.
 - Do NOT create branches or PRs
 - Do NOT modify any project source files
 - Do NOT create CLI wrapper files or scripts
-- Only read source files for analysis, write only to ARCHITECTURE.md, DESIGN.md, AGENTS.md, and openspec/
+- Only read source files for analysis, write only to ARCHITECTURE.md, DESIGN.md, AGENTS.md, openspec/config.yaml, and openspec/
 
 <!-- AGENTS-TEMPLATE-START -->
 # AGENTS.md
@@ -138,18 +156,25 @@ Trigger patterns, I recognize ALL of these, exact wording does not matter:
 
 **Never delegate without a plan. Never write implementation code directly, always spawn specialists, no exceptions. "Small feature", "faster to do it directly", or "environment issues" are not valid reasons to skip ensemble.**
 
-## Multi-Agent Execution, opencode-ensemble
-
-Parallel execution uses the `opencode-ensemble` plugin (`team_create`, `team_spawn`, etc.).
-Works on **all platforms** (Windows, macOS, Linux) via OpenCode's built-in worktree support.
-
-Core tools used in this workflow:
-- `team_create`, `team_spawn`, `team_shutdown`, `team_merge`, `team_cleanup`
-- `team_tasks_add`, `team_tasks_list`, `team_claim`, `team_tasks_complete`
-- `team_message`, `team_results`, `team_status`
+## Multi-Agent Execution, opencode-ensemble
+
+Parallel execution uses the `opencode-ensemble` plugin (`team_create`, `team_spawn`, etc.).
+Works on **all platforms** (Windows, macOS, Linux) via OpenCode's built-in worktree support.
+
+Core tools used in this workflow:
+- `team_create`, `team_spawn`, `team_shutdown`, `team_merge`, `team_cleanup`
+- `team_tasks_add`, `team_tasks_list`, `team_claim`, `team_tasks_complete`
+- `team_message`, `team_results`, `team_status`
 
 **Dashboard**: Monitor running agents at **http://localhost:4747/**
 
+**Hard limits:**
+- **Max {{MAX_CONCURRENT_AGENTS}} truly concurrent agents.** All {{MAX_CONCURRENT_AGENTS}} must be spawned and running simultaneously, not sequentially. Spawn in waves if more than {{MAX_CONCURRENT_AGENTS}} are needed. Wait for wave N to finish before spawning wave N+1.
+- **Non-overlapping file domains.** Each agent owns exclusive directories. Two agents must NEVER touch the same file.
+- **Immediate shutdown on completion.** The moment an agent's domain has no more pending tasks → `team_shutdown` → `team_merge`. Keep agents alive if more tasks in their domain are pending (rolling batch).
+- **Rolling batch assignment.** Agents receive up to 3 tasks initially. When they complete a batch, lead assigns the next batch of up to 3 from the board. Never leave pending tasks orphaned.
+- **Stall detection at 5 minutes.** No commits after 5 min → nudge message → 2 min grace → force shutdown + respawn.
+
 **Progress inspection commands (tell user explicitly after spawning):**
 - `team_status` for live team snapshot
 - `team_tasks_list` for task board state
@@ -159,7 +184,7 @@ Core tools used in this workflow:
 If a teammate stalls due to model quota/rate-limit exhaustion:
 1. `team_shutdown name:"<stuck-member>" force:true`
 2. `team_spawn` same member/task with an available model
-3. `team_message` start instruction with the exact next task ID
+3. `team_message` start instruction with the exact next task ID
 
 ---
 
@@ -191,15 +216,16 @@ devops-manager (ship mode)
 5. STOP. Ask user: "Ready to implement? (yes/no)", DO NOT proceed until confirmed.
 ```
 
-### Phase 2, Implement
-
-```
-1. Run /opsx-apply.
-   - Lead adds all tasks to board.
-   - Lead spawns one or more engineers (`basic-engineer` and/or custom engineers) in parallel where safe.
-   - Each engineer must claim task IDs, load relevant abilities, implement, and complete tasks.
-   - Lead merges each engineer branch after shutdown, then marks tasks done in tasks.md.
-2. Verify with tests/build/lint according to task scope.
+### Phase 2, Implement
+
+```
+1. Run /opsx-apply.
+   - Lead adds all tasks to board.
+   - Lead spawns engineers with initial batch of up to 3 tasks each (rolling batch model).
+   - Each engineer claims tasks, implements, completes, messages lead.
+   - Lead assigns next batch (up to 3) to agents that report done. Repeat until board empty.
+   - Lead merges each engineer branch after shutdown, then marks tasks done in tasks.md.
+2. Verify with tests/build/lint according to task scope.
 ```
 
 ### Phase 3, Ship

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-onboard",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Prepare any brownfield codebase for AI agent workflows using OpenCode, OpenSpec, and ensemble orchestration.",
   "keywords": [
     "opencode",

package/src/commands/join.js

@@ -0,0 +1,43 @@
+import chalk from 'chalk'
+import { installBrowser } from '../steps/browser/index.js'
+import { checkRtk } from '../steps/optimization/index.js'
+import { checkPlatform, choosePlatform } from '../steps/platform/index.js'
+import { header, info } from '../utils/exec.js'
+import { readOnboardConfig } from './shared.js'
+
+export async function runJoin() {
+  const logo = chalk.hex('#fe3d57')
+  console.log()
+  console.log(logo('  🤝 opencode-onboard join'))
+  console.log(chalk.dim('  New team member setup, checks & local installs only'))
+  console.log(chalk.dim('  This will NOT modify any project files.'))
+  console.log()
+
+  // Step 1: Platform CLI check
+  header('Step 1, Platform CLI check')
+  const saved = await readOnboardConfig()
+  const savedPlatform = saved?.wizard?.platform
+  if (savedPlatform) {
+    info(`Detected project platform: ${savedPlatform === 'github' ? 'GitHub' : 'Azure DevOps'}`)
+    await checkPlatform(savedPlatform)
+  } else {
+    const platform = await choosePlatform()
+    void platform // result not persisted in join mode
+  }
+
+  // Step 2: rtk check
+  header('Step 2, Checking rtk')
+  await checkRtk({ skipHeader: true })
+
+  // Step 3: Browser extension
+  await installBrowser()
+
+  console.log()
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log(chalk.bold.green('  Join setup complete!'))
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log()
+  console.log('  Your local environment is ready.')
+  console.log('  Open the project in OpenCode and start coding!')
+  console.log()
+}

package/src/commands/shared.js

@@ -0,0 +1,12 @@
+import fse from 'fs-extra'
+import path from 'node:path'
+
+export async function readOnboardConfig() {
+  const cfgPath = path.join(process.cwd(), '.opencode', 'opencode-onboard.json')
+  if (!await fse.pathExists(cfgPath)) return null
+  try {
+    return await fse.readJson(cfgPath)
+  } catch {
+    return null
+  }
+}

package/src/commands/shared.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { readOnboardConfig } from './shared.js'
+
+describe('readOnboardConfig()', () => {
+  let tmpDir, originalCwd
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'shared-test-'))
+    originalCwd = process.cwd()
+    process.chdir(tmpDir)
+  })
+
+  afterEach(() => {
+    process.chdir(originalCwd)
+    fs.rmSync(tmpDir, { recursive: true, force: true })
+  })
+
+  it('returns null when config file does not exist', async () => {
+    const result = await readOnboardConfig()
+
+    expect(result).toBeNull()
+  })
+
+  it('returns parsed config when file exists', async () => {
+    const configDir = path.join(tmpDir, '.opencode')
+    fs.mkdirSync(configDir)
+    fs.writeFileSync(
+      path.join(configDir, 'opencode-onboard.json'),
+      JSON.stringify({ schema: 1, wizard: { platform: 'github' } }),
+      'utf-8'
+    )
+
+    const result = await readOnboardConfig()
+
+    expect(result).not.toBeNull()
+    expect(result.schema).toBe(1)
+    expect(result.wizard.platform).toBe('github')
+  })
+
+  it('returns null when file contains invalid JSON', async () => {
+    const configDir = path.join(tmpDir, '.opencode')
+    fs.mkdirSync(configDir)
+    fs.writeFileSync(
+      path.join(configDir, 'opencode-onboard.json'),
+      'not valid json',
+      'utf-8'
+    )
+
+    const result = await readOnboardConfig()
+
+    expect(result).toBeNull()
+  })
+})

package/src/commands/single.js

@@ -0,0 +1,66 @@
+import { cleanAiFiles } from '../steps/clean/index.js'
+import { copyContentStep } from '../steps/copy/index.js'
+import { chooseModels } from '../steps/models/index.js'
+import { initOpenspec } from '../steps/openspec/index.js'
+import { tokenOptimizationStep } from '../steps/optimization/index.js'
+import { choosePlatform } from '../steps/platform/index.js'
+import { installBrowser } from '../steps/browser/index.js'
+import { writeOnboardConfig } from '../steps/metadata/index.js'
+import { readOnboardConfig } from './shared.js'
+
+export async function runSingleCommand(command) {
+  const saved = await readOnboardConfig()
+  const savedWizard = saved?.wizard ?? {}
+  const ctx = {
+    hasDesign: !!savedWizard?.preserved?.design,
+    hasArchitecture: !!savedWizard?.preserved?.architecture,
+    hasOpenspec: !!savedWizard?.preserved?.openspec,
+    sourceMode: savedWizard?.sourceMode ?? 'current',
+    sourceRoots: Array.isArray(savedWizard?.sourceRoots) ? savedWizard.sourceRoots : [],
+    maxConcurrentAgents: savedWizard?.maxConcurrentAgents ?? 4,
+  }
+  const platform = savedWizard?.platform
+  const resolvedPlatform = platform === 'azure' || platform === 'github' ? platform : 'github'
+
+  const handlers = {
+    clean: async () => {
+      await cleanAiFiles()
+    },
+    platform: async () => {
+      await choosePlatform()
+    },
+    copy: async () => {
+      await copyContentStep(resolvedPlatform, ctx)
+    },
+    openspec: async () => {
+      await initOpenspec()
+    },
+    models: async () => {
+      await chooseModels()
+    },
+    optimization: async () => {
+      await tokenOptimizationStep({ ctx })
+    },
+    browser: async () => {
+      await installBrowser()
+    },
+    metadata: async () => {
+      await writeOnboardConfig({
+        ...ctx,
+        platform: resolvedPlatform,
+        maxConcurrentAgents: savedWizard?.maxConcurrentAgents ?? 4,
+        additionalSkillsProvider: 'npx-skills',
+        planModel: savedWizard?.models?.plan ?? null,
+        buildModel: savedWizard?.models?.build ?? null,
+        fastModel: savedWizard?.models?.fast ?? null,
+        optionalTools: savedWizard?.optionalTools ?? null,
+        cavemanGuidance: savedWizard?.cavemanGuidance ?? null,
+      })
+    },
+  }
+
+  const handler = handlers[command]
+  if (!handler) return false
+  await handler()
+  return true
+}

package/src/commands/wizard.js

@@ -0,0 +1,113 @@
+import { select as wizardSelect } from '@inquirer/prompts'
+import chalk from 'chalk'
+import { chooseSourceScope } from '../steps/source/index.js'
+import { cleanAiFiles } from '../steps/clean/index.js'
+import { choosePlatform } from '../steps/platform/index.js'
+import { copyContentStep } from '../steps/copy/index.js'
+import { initOpenspec } from '../steps/openspec/index.js'
+import { chooseModels } from '../steps/models/index.js'
+import { tokenOptimizationStep } from '../steps/optimization/index.js'
+import { installBrowser } from '../steps/browser/index.js'
+import { writeOnboardConfig } from '../steps/metadata/index.js'
+
+export async function runWizard(version) {
+  const logo = chalk.hex('#fe3d57')
+  const bannerLines = [
+    logo('                             '),
+    logo('        ▒▒▒▒▒▒▒▒▒▒▒▒▒        '),
+    logo('        ▒▒▓       ▓▒▓        '),
+    logo('   ▒▒▒▒▒▒▓▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒   '),
+    logo('  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓  '),
+    logo(' ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓ '),
+    logo(' ▓▒▒▒▒░░░▒▒▒▒▒▒▒▒▒▒▒░░░▒▒▒▓▓ '),
+    logo('  ▓▓▓▓▒▒▒▓▓▓▓▓▓▓▓▓▓▓▒▒▒▓▓▓▓  '),
+    logo('  ▓▓▒▒▒▒▒▒░▒▒▒▒▒▒▒░▒▒▒▒▒▒▓▓  '),
+    logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
+    logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
+    logo('   ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓    '),
+    '',
+    chalk.bold('        🧰 opencode-onboard') + chalk.dim(` v${version}`),
+    chalk.dim('        Prepare your codebase for AI agents'),
+  ]
+
+  for (const line of bannerLines) console.log(line)
+  console.log()
+  console.log('  This tool will set up your project with a team of AI agents,')
+  console.log('  install skills, select models, and configure OpenCode.')
+  console.log()
+
+  // Only wait for Enter in a real interactive TTY
+  if (process.stdin.isTTY) {
+    console.log(chalk.bold('  Press Enter to begin...'))
+    console.log()
+    await new Promise(resolve => {
+      process.stdin.resume()
+      process.stdin.once('data', () => {
+        process.stdin.pause()
+        resolve()
+      })
+    })
+  }
+
+  const scope = await chooseSourceScope()
+
+  const maxConcurrentAgents = await wizardSelect({
+    message: 'Max concurrent agents:',
+    default: 4,
+    choices: [
+      { name: '2', value: 2, description: 'Conservative — lower resource usage' },
+      { name: '3', value: 3, description: 'Moderate parallelism' },
+      { name: '4 (default)', value: 4, description: 'Recommended for most projects' },
+      { name: '5', value: 5, description: 'High parallelism — requires more resources' },
+      { name: '6', value: 6, description: 'Maximum parallelism' },
+    ],
+  })
+
+  const preserve = await cleanAiFiles()
+  const ctx = { ...preserve, ...scope, maxConcurrentAgents }
+
+  const platform = await choosePlatform()
+
+  await copyContentStep(platform, ctx)
+
+  await initOpenspec()
+
+  const selectedModels = await chooseModels()
+
+  const tokenOpt = await tokenOptimizationStep({ ctx })
+  const { rtk, quota, caveman, cavemanGuidance } = tokenOpt
+
+  await installBrowser()
+
+  await writeOnboardConfig({
+    ...ctx,
+    platform,
+    maxConcurrentAgents,
+    additionalSkillsProvider: 'npx-skills',
+    ...selectedModels,
+    optionalTools: { rtk, quota, caveman },
+    cavemanGuidance,
+  })
+
+  const toGenerate = [
+    !ctx.hasDesign && 'DESIGN.md',
+    !ctx.hasArchitecture && 'ARCHITECTURE.md',
+  ].filter(Boolean)
+
+  console.log()
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log(chalk.bold.green('  Onboarding complete!'))
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log()
+  console.log('  Open this project in OpenCode and type:')
+  console.log(chalk.bold('  "init"'))
+  console.log()
+  if (toGenerate.length > 0) {
+    console.log(`  OpenCode will generate ${toGenerate.join(' and ')}`)
+    console.log('  from your actual codebase, then activate the agent team.')
+  } else {
+    console.log('  OpenCode will activate the agent team.')
+  }
+  console.log(`  Source scope: ${ctx.sourceMode === 'parent-selected' ? ctx.sourceRoots.map(p => `../${p.split(/[/\\]/).pop()}`).join(', ') : 'current folder'}`)
+  console.log()
+}

package/src/index.js

@@ -1,17 +1,9 @@
 #!/usr/bin/env node
 import chalk from 'chalk'
-import fse from 'fs-extra'
 import { createRequire } from 'node:module'
-import path from 'node:path'
-import { installBrowser } from './steps/browser/index.js'
-import { cleanAiFiles } from './steps/clean/index.js'
-import { copyContentStep } from './steps/copy/index.js'
-import { chooseModels } from './steps/models/index.js'
-import { initOpenspec } from './steps/openspec/index.js'
-import { tokenOptimizationStep } from './steps/optimization/index.js'
-import { choosePlatform } from './steps/platform/index.js'
-import { chooseSourceScope } from './steps/source/index.js'
-import { writeOnboardConfig } from './steps/metadata/index.js'
+import { runJoin } from './commands/join.js'
+import { runSingleCommand } from './commands/single.js'
+import { runWizard } from './commands/wizard.js'
 
 function printHelp(version) {
   console.log(`opencode-onboard v${version}`)
@@ -21,6 +13,7 @@ function printHelp(version) {
   console.log('  npx opencode-onboard <command>      Run a single step command')
   console.log()
   console.log('Commands:')
+  console.log('  join            New team member setup (checks & local installs only)')
   console.log('  clean           Run AI files cleanup step')
   console.log('  platform        Run platform selection step')
   console.log('  copy            Run content copy step')
@@ -34,71 +27,6 @@ function printHelp(version) {
   console.log('  -h, --help      Show this help message')
 }
 
-async function readOnboardConfig() {
-  const cfgPath = path.join(process.cwd(), '.opencode', 'opencode-onboard.json')
-  if (!await fse.pathExists(cfgPath)) return null
-  try {
-    return await fse.readJson(cfgPath)
-  } catch {
-    return null
-  }
-}
-
-async function runSingleCommand(command) {
-  const saved = await readOnboardConfig()
-  const savedWizard = saved?.wizard ?? {}
-  const ctx = {
-    hasDesign: !!savedWizard?.preserved?.design,
-    hasArchitecture: !!savedWizard?.preserved?.architecture,
-    hasOpenspec: !!savedWizard?.preserved?.openspec,
-    sourceMode: savedWizard?.sourceMode ?? 'current',
-    sourceRoots: Array.isArray(savedWizard?.sourceRoots) ? savedWizard.sourceRoots : [],
-  }
-  const platform = savedWizard?.platform
-  const resolvedPlatform = platform === 'azure' || platform === 'github' ? platform : 'github'
-
-  const handlers = {
-    clean: async () => {
-      await cleanAiFiles()
-    },
-    platform: async () => {
-      await choosePlatform()
-    },
-    copy: async () => {
-      await copyContentStep(resolvedPlatform, ctx)
-    },
-    openspec: async () => {
-      await initOpenspec()
-    },
-    models: async () => {
-      await chooseModels()
-    },
-    optimization: async () => {
-      await tokenOptimizationStep({ ctx })
-    },
-    browser: async () => {
-      await installBrowser()
-    },
-    metadata: async () => {
-      await writeOnboardConfig({
-        ...ctx,
-        platform: resolvedPlatform,
-        additionalSkillsProvider: 'npx-skills',
-        planModel: savedWizard?.models?.plan ?? null,
-        buildModel: savedWizard?.models?.build ?? null,
-        fastModel: savedWizard?.models?.fast ?? null,
-        optionalTools: savedWizard?.optionalTools ?? null,
-        cavemanGuidance: savedWizard?.cavemanGuidance ?? null,
-      })
-    },
-  }
-
-  const handler = handlers[command]
-  if (!handler) return false
-  await handler()
-  return true
-}
-
 if (process.stdout.isTTY) console.clear()
 console.log()
 const require = createRequire(import.meta.url)
@@ -111,103 +39,32 @@ if (args.includes('-h') || args.includes('--help')) {
 }
 
 if (args.length > 0) {
-  const ok = await runSingleCommand(args[0])
-  if (!ok) {
-    console.log(chalk.red(`Unknown command: ${args[0]}`))
-    console.log()
-    printHelp(version)
-    process.exit(1)
+  try {
+    if (args[0] === 'join') {
+      await runJoin()
+    } else {
+      const ok = await runSingleCommand(args[0])
+      if (!ok) {
+        console.log(chalk.red(`Unknown command: ${args[0]}`))
+        console.log()
+        printHelp(version)
+        process.exit(1)
+      }
+    }
+  } catch (err) {
+    if (err.name === 'ExitPromptError') {
+      console.log()
+      console.log(chalk.yellow('Cancelled.'))
+    } else {
+      console.error(chalk.red('\nUnexpected error:'), err.message)
+      process.exit(1)
+    }
   }
   process.exit(0)
 }
 
-const logo = chalk.hex('#fe3d57')
-const bannerLines = [
-  logo('                             '),
-  logo('        ▒▒▒▒▒▒▒▒▒▒▒▒▒        '),
-  logo('        ▒▒▓       ▓▒▓        '),
-  logo('   ▒▒▒▒▒▒▓▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒   '),
-  logo('  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓  '),
-  logo(' ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓ '),
-  logo(' ▓▒▒▒▒░░░▒▒▒▒▒▒▒▒▒▒▒░░░▒▒▒▓▓ '),
-  logo('  ▓▓▓▓▒▒▒▓▓▓▓▓▓▓▓▓▓▓▒▒▒▓▓▓▓  '),
-  logo('  ▓▓▒▒▒▒▒▒░▒▒▒▒▒▒▒░▒▒▒▒▒▒▓▓  '),
-  logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
-  logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
-  logo('   ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓    '),
-  '',
-  chalk.bold('        🧰 opencode-onboard') + chalk.dim(` v${version}`),
-  chalk.dim('        Prepare your codebase for AI agents'),
-]
-
-for (const line of bannerLines) console.log(line)
-console.log()
-console.log('  This tool will set up your project with a team of AI agents,')
-console.log('  install skills, select models, and configure OpenCode.')
-console.log()
-
-// Only wait for Enter in a real interactive TTY
-if (process.stdin.isTTY) {
-  console.log(chalk.bold('  Press Enter to begin...'))
-  console.log()
-  await new Promise(resolve => {
-    process.stdin.resume()
-    process.stdin.once('data', () => {
-      process.stdin.pause()
-      resolve()
-    })
-  })
-}
-
 try {
-  const scope = await chooseSourceScope()
-
-  const preserve = await cleanAiFiles()
-  const ctx = { ...preserve, ...scope }
-
-  const platform = await choosePlatform()
-
-  await copyContentStep(platform, ctx)
-
-  await initOpenspec()
-
-  const selectedModels = await chooseModels()
-
-  const tokenOpt = await tokenOptimizationStep({ ctx })
-  const { rtk, quota, caveman, cavemanGuidance } = tokenOpt
-
-  await installBrowser()
-
-  await writeOnboardConfig({
-    ...ctx,
-    platform,
-    additionalSkillsProvider: 'npx-skills',
-    ...selectedModels,
-    optionalTools: { rtk, quota, caveman },
-    cavemanGuidance,
-  })
-
-  const toGenerate = [
-    !ctx.hasDesign && 'DESIGN.md',
-    !ctx.hasArchitecture && 'ARCHITECTURE.md',
-  ].filter(Boolean)
-
-  console.log()
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log(chalk.bold.green('  Onboarding complete!'))
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log()
-  console.log('  Open this project in OpenCode and type:')
-  console.log(chalk.bold('  "init"'))
-  console.log()
-  if (toGenerate.length > 0) {
-    console.log(`  OpenCode will generate ${toGenerate.join(' and ')}`)
-    console.log('  from your actual codebase, then activate the agent team.')
-  } else {
-    console.log('  OpenCode will activate the agent team.')
-  }
-  console.log(`  Source scope: ${ctx.sourceMode === 'parent-selected' ? ctx.sourceRoots.map(p => `../${p.split(/[/\\]/).pop()}`).join(', ') : 'current folder'}`)
-  console.log()
+  await runWizard(version)
 } catch (err) {
   if (err.name === 'ExitPromptError') {
     console.log()

package/src/presets/source.json

@@ -11,7 +11,13 @@
       "name": "Select folders in parent (../)",
       "value": "parent",
       "description": "Use when this repo only contains agent config"
+    },
+    {
+      "name": "Select child folders (./*/)",
+      "value": "children",
+      "description": "Use when source code lives in subdirectories of this repo"
     }
   ],
-  "parentSelectionMessage": "Select source folders from parent directory:"
+  "parentSelectionMessage": "Select source folders from parent directory:",
+  "childrenSelectionMessage": "Select child folders to include as source:"
 }

package/src/steps/browser/browser.test.js

@@ -44,7 +44,7 @@ describe('installBrowser()', () => {
 
     await installBrowser()
 
-    expect(execa).toHaveBeenCalledWith('npx', expect.arrayContaining('@different-ai/opencode-browser'), expect.any(Object))
+    expect(execa).toHaveBeenCalledWith('npx', expect.arrayContaining(['@different-ai/opencode-browser']), expect.any(Object))
   })
 
   it('logs success when exit code is 0', async () => {