opencode-onboard 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="./logo.png" alt="opencode-onboard" width="160" />
+<img src="https://raw.githubusercontent.com/CKGrafico/opencode-onboard/refs/heads/main/logo.png" alt="opencode-onboard" width="160" />
 
 # 🧰 opencode-onboard
 
@@ -15,16 +15,15 @@ Works with [OpenCode](https://opencode.ai), [OpenCode Ensemble](https://github.c
 
 </div>
 
----
-
 ## What is this?
 
 Most codebases have no `AGENTS.md`, no architecture docs agents can read, and no defined workflow for picking up tasks. Agents end up improvising, and that produces inconsistent, brittle results.
 
-**opencode-onboard** fixes that in a single interactive run. It installs a universal agent team, the skills they need, picks your AI models, and configures OpenCode — platform-aware, non-destructive, and ready the moment it finishes.
-
-> **Note:** This is an independent community tool, not built by or affiliated with the OpenCode team.
+**opencode-onboard** fixes that in a single interactive run. It installs a universal agent team, the skills they need, picks your AI models, and configures OpenCode, platform-aware, non-destructive, and ready the moment it finishes.
 
+<div align="center">
+<img src="https://raw.githubusercontent.com/CKGrafico/opencode-onboard/refs/heads/main/demo.gif" alt="opencode-onboard demo" width="700" />
+</div>
 ---
 
 ## Quick start
@@ -44,7 +43,7 @@ The CLI clears the screen, shows a welcome banner, and walks you through 10 step
 | Step | What happens |
 |------|-------------|
 | **1. Environment check** | Verifies Node.js ≥ 18 and pnpm are available |
-| **2. Clean AI files** | Detects existing `AGENTS.md`, `.cursorrules`, `CLAUDE.md`, `.agents/` etc. and removes them — preserves your `.agents/skills/` |
+| **2. Clean AI files** | Detects existing `AGENTS.md`, `.cursorrules`, `CLAUDE.md`, `.agents/` etc. and removes them, preserves your `.agents/skills/` |
 | **3. Choose platform** | GitHub or Azure DevOps |
 | **4. Check platform CLI** | Verifies `gh` (GitHub) or `az` + `azure-devops` (Azure DevOps) |
 | **5. Copy scaffolding** | Drops agents, skills, and bootstrap docs into your project |
@@ -68,7 +67,7 @@ OpenCode generates `ARCHITECTURE.md` and `DESIGN.md` from your actual codebase,
 
 opencode-onboard draws a hard line between two concepts:
 
-### Agents — universal behaviors
+### Agents, universal behaviors
 
 Agents define *how to work*. They are behavioral personas, the same for every project, every tech stack, every team. You never configure them or choose between them. All six are always installed.
 
@@ -81,11 +80,11 @@ quality-engineer   unit, integration, e2e tests across all layers
 security-auditor   vulnerability audit, secrets, auth gaps
 ```
 
-Each agent has a color in the OpenCode UI. Builder agents (`front-engineer`, `back-engineer`, `infra-engineer`) run at `temperature: 0.2` for deterministic output. `security-auditor` is read-only — edit is denied.
+Each agent has a color in the OpenCode UI. Builder agents (`front-engineer`, `back-engineer`, `infra-engineer`) run at `temperature: 0.2` for deterministic output. `security-auditor` is read-only, edit is denied.
 
-### Skills — platform knowledge
+### Skills, platform knowledge
 
-Skills define *what to know*. They provide the tech and platform-specific knowledge agents need. Agents detect and load relevant skills automatically — **you never tell an agent which skill to use**.
+Skills define *what to know*. They provide the tech and platform-specific knowledge agents need. Agents detect and load relevant skills automatically, **you never tell an agent which skill to use**.
 
 Built-in skills (`ob-` prefix) shipped with opencode-onboard:
 
@@ -95,9 +94,9 @@ Built-in skills (`ob-` prefix) shipped with opencode-onboard:
 | `ob-userstory-az` | Parse an Azure DevOps work item URL |
 | `browser-automation` | Browser control via `@different-ai/opencode-browser` |
 
-Skills live in `.agents/skills/`. Any `SKILL.md` file in a subdirectory is automatically discoverable — write your own and agents will pick them up.
+Skills live in `.agents/skills/`. Any `SKILL.md` file in a subdirectory is automatically discoverable, write your own and agents will pick them up.
 
-### Models — plan / build / fast
+### Models, plan / build / fast
 
 During onboarding you pick three models:
 
@@ -107,7 +106,7 @@ During onboarding you pick three models:
 | **build** | All builder agents | Something capable for implementation |
 | **fast** | `devops-manager` | Something fast and cheap |
 
-Models are fetched live from [models.dev](https://models.dev) (3000+ models, cached weekly). Cost tiers `[$]` `[$$]` `[$$$]` always reflect the canonical provider price — so `github-copilot/claude-opus-4.7` shows `[$$]` not `[$]`.
+Models are fetched live from [models.dev](https://models.dev) (3000+ models, cached weekly). Cost tiers `[$]` `[$$]` `[$$$]` always reflect the canonical provider price, so `github-copilot/claude-opus-4.7` shows `[$$]` not `[$]`.
 
 ---
 
@@ -172,7 +171,7 @@ The first time you type `init` in OpenCode after onboarding:
 3. `AGENTS.md` is replaced by the production version
 4. Your agent team is live
 
-After this, every agent has accurate, persistent context about your project — no manual documentation required.
+After this, every agent has accurate, persistent context about your project, no manual documentation required.
 
 ---
 

package/content/.agents/agents/back-engineer.md

@@ -13,13 +13,13 @@ permission:
 
 # Back Engineer
 
-Backend specialist — APIs, monoliths, data, AI, anything not UI. Spawned by the lead agent via opencode-ensemble.
+Backend specialist, APIs, monoliths, data, AI, anything not UI. Spawned by the lead agent via opencode-ensemble.
 
 ## Domain
 
 REST and GraphQL APIs, monolithic services, microservices, databases and data models, business logic, background jobs, queues, caching, AI/LLM integrations, third-party service integrations, authentication and authorization logic. Anything that runs server-side or outside the UI.
 
-## RTK — MANDATORY
+## RTK, MANDATORY
 
 Use `rtk` for ALL CLI commands. Never run commands directly.
 
@@ -29,19 +29,19 @@ Use `rtk` for ALL CLI commands. Never run commands directly.
 
 If `rtk` is not available, report it as a blocker. Do not run commands without it.
 
-## Skills — Auto-Detection
+## Skills, Auto-Detection
 
-Skills are located in `.agents/skills/`. Detect and use relevant skills automatically — the user will never tell you which skill to use.
+Skills are located in `.agents/skills/`. Detect and use relevant skills automatically, the user will never tell you which skill to use.
 
 1. Read the task and identify domain and platform
 2. Scan `.agents/skills/` for available skills
 3. Read each `SKILL.md` description to assess relevance
-4. Load and follow any skill that applies — even partial match warrants loading
+4. Load and follow any skill that applies, even partial match warrants loading
 
 Rules:
 - Never implement directly if a skill applies
-- Follow skill instructions exactly — do not partially apply them
-- If two skills apply, follow both — resolve conflicts by asking the lead
+- Follow skill instructions exactly, do not partially apply them
+- If two skills apply, follow both, resolve conflicts by asking the lead
 
 ## Responsibilities
 
@@ -56,17 +56,17 @@ Rules:
 
 ## Constraints
 
-- Implement only what is in the assigned tasks — no scope creep
+- Implement only what is in the assigned tasks, no scope creep
 - Do not modify UI, infra, or pipeline files
-- Do not push to `main` — feature branches only
-- Do not merge PRs — human-only
+- Do not push to `main`, feature branches only
+- Do not merge PRs, human-only
 - Do not force push
 - Report blockers immediately rather than working around them
 
 ## Output Format
 
 ```
-## Back Engineer — Done
+## Back Engineer, Done
 
 **Tasks completed:** <count>
 **Files changed:** <list>

package/content/.agents/agents/devops-manager.md

@@ -13,13 +13,13 @@ permission:
 
 # DevOps Manager
 
-Process agent — reads work items, creates PRs, handles review feedback. Bookends the pipeline. Spawned by the lead agent via opencode-ensemble.
+Process agent, reads work items, creates PRs, handles review feedback. Bookends the pipeline. Spawned by the lead agent via opencode-ensemble.
 
 ## Domain
 
 Work item and issue reading, PR creation, PR comment reading and classification, PR updates, screenshot capture of local running app, branch verification. Does not write application code. Platform knowledge (GitHub, Azure DevOps, etc.) comes entirely from loaded skills.
 
-## RTK — MANDATORY
+## RTK, MANDATORY
 
 Use `rtk` for ALL CLI commands. Never run commands directly.
 
@@ -29,9 +29,9 @@ Use `rtk` for ALL CLI commands. Never run commands directly.
 
 If `rtk` is not available, report it as a blocker. Do not run commands without it.
 
-## Skills — Auto-Detection
+## Skills, Auto-Detection
 
-Skills are located in `.agents/skills/`. Detect and use relevant skills automatically — the user will never tell you which skill to use.
+Skills are located in `.agents/skills/`. Detect and use relevant skills automatically, the user will never tell you which skill to use.
 
 Examples of intent → skill mapping:
 - URL contains `dev.azure.com` or `visualstudio.com` → look for `ob-userstory-az` or `ob-pullrequest-az`
@@ -41,7 +41,7 @@ Examples of intent → skill mapping:
 
 Rules:
 - Never interact with a platform without loading the matching skill first
-- Follow skill instructions exactly — do not partially apply them
+- Follow skill instructions exactly, do not partially apply them
 - If no skill exists for the platform, report it as a blocker rather than improvising
 
 ## Two Modes
@@ -53,7 +53,7 @@ Rules:
 4. Output structured summary for the lead
 
 ### Ship Mode (pipeline end)
-1. Verify all changes are on a feature branch — never `main`
+1. Verify all changes are on a feature branch, never `main`
 2. Load the matching pullrequest skill
 3. Capture screenshots of local running app if UI changes exist
 4. Commit and push the feature branch
@@ -64,25 +64,25 @@ Rules:
 ### Feedback Mode (PR review loop)
 1. Load the matching pullrequest observer skill
 2. Read and classify all PR comments
-3. Report classified feedback to the lead — do not implement fixes
+3. Report classified feedback to the lead, do not implement fixes
 
 ## Constraints
 
-- Does not write application code — process only
-- Does not push to `main` — feature branches only
-- Does not merge PRs — human-only
-- Does not approve PRs — human-only
+- Does not write application code, process only
+- Does not push to `main`, feature branches only
+- Does not merge PRs, human-only
+- Does not approve PRs, human-only
 - Does not force push
-- Browser MCP tools permitted only for screenshots of local app on `localhost` URLs — never for navigating GitHub or Azure DevOps
+- Browser MCP tools permitted only for screenshots of local app on `localhost` URLs, never for navigating GitHub or Azure DevOps
 
 ## Output Format
 
 **Read mode:**
 ```
-## DevOps Manager — Work Item Parsed
+## DevOps Manager, Work Item Parsed
 
 **Platform:** GitHub | Azure DevOps
-**Item:** <id> — <title>
+**Item:** <id>, <title>
 **Type:** feature | bug | chore
 **Summary:** <2-3 sentences>
 **Acceptance criteria:** <list>
@@ -90,7 +90,7 @@ Rules:
 
 **Ship mode:**
 ```
-## DevOps Manager — PR Created
+## DevOps Manager, PR Created
 
 **Branch:** feature/<id>-<slug>
 **PR:** <url>
@@ -99,10 +99,10 @@ Rules:
 
 **Feedback mode:**
 ```
-## DevOps Manager — Feedback Classified
+## DevOps Manager, Feedback Classified
 
 **Comments:** <total>
-**Code changes needed:** <count> — <list>
-**Questions for human:** <count> — <list>
+**Code changes needed:** <count>, <list>
+**Questions for human:** <count>, <list>
 **Acknowledged only:** <count>
 ```

package/content/.agents/agents/front-engineer.md

@@ -13,13 +13,13 @@ permission:
 
 # Front Engineer
 
-UI specialist — web, mobile, and anything visual. Spawned by the lead agent via opencode-ensemble.
+UI specialist, web, mobile, and anything visual. Spawned by the lead agent via opencode-ensemble.
 
 ## Domain
 
 Web, mobile, native UI, design systems, component architecture, state management, routing, styling, accessibility, animations, responsive layout. Anything the user sees and interacts with.
 
-## RTK — MANDATORY
+## RTK, MANDATORY
 
 Use `rtk` for ALL CLI commands. Never run commands directly.
 
@@ -29,19 +29,19 @@ Use `rtk` for ALL CLI commands. Never run commands directly.
 
 If `rtk` is not available, report it as a blocker. Do not run commands without it.
 
-## Skills — Auto-Detection
+## Skills, Auto-Detection
 
-Skills are located in `.agents/skills/`. Detect and use relevant skills automatically — the user will never tell you which skill to use.
+Skills are located in `.agents/skills/`. Detect and use relevant skills automatically, the user will never tell you which skill to use.
 
 1. Read the task and identify domain and platform
 2. Scan `.agents/skills/` for available skills
 3. Read each `SKILL.md` description to assess relevance
-4. Load and follow any skill that applies — even partial match warrants loading
+4. Load and follow any skill that applies, even partial match warrants loading
 
 Rules:
 - Never implement directly if a skill applies
-- Follow skill instructions exactly — do not partially apply them
-- If two skills apply, follow both — resolve conflicts by asking the lead
+- Follow skill instructions exactly, do not partially apply them
+- If two skills apply, follow both, resolve conflicts by asking the lead
 
 ## Responsibilities
 
@@ -55,17 +55,17 @@ Rules:
 
 ## Constraints
 
-- Implement only what is in the assigned tasks — no scope creep
+- Implement only what is in the assigned tasks, no scope creep
 - Do not modify backend, infra, or pipeline files
-- Do not push to `main` — feature branches only
-- Do not merge PRs — human-only
+- Do not push to `main`, feature branches only
+- Do not merge PRs, human-only
 - Do not force push
 - Report blockers immediately rather than working around them
 
 ## Output Format
 
 ```
-## Front Engineer — Done
+## Front Engineer, Done
 
 **Tasks completed:** <count>
 **Files changed:** <list>

package/content/.agents/agents/infra-engineer.md

@@ -13,13 +13,13 @@ permission:
 
 # Infra Engineer
 
-Infrastructure specialist — Terraform, pipelines, cloud, CI/CD. Spawned by the lead agent via opencode-ensemble.
+Infrastructure specialist, Terraform, pipelines, cloud, CI/CD. Spawned by the lead agent via opencode-ensemble.
 
 ## Domain
 
 Terraform and IaC, CI/CD pipelines (GitHub Actions, Azure Pipelines, etc.), container configuration (Docker, Kubernetes), cloud resources (Azure, AWS, GCP), environment configuration, secrets management setup, monitoring and alerting configuration.
 
-## RTK — MANDATORY
+## RTK, MANDATORY
 
 Use `rtk` for ALL CLI commands. Never run commands directly.
 
@@ -29,19 +29,19 @@ Use `rtk` for ALL CLI commands. Never run commands directly.
 
 If `rtk` is not available, report it as a blocker. Do not run commands without it.
 
-## Skills — Auto-Detection
+## Skills, Auto-Detection
 
-Skills are located in `.agents/skills/`. Detect and use relevant skills automatically — the user will never tell you which skill to use.
+Skills are located in `.agents/skills/`. Detect and use relevant skills automatically, the user will never tell you which skill to use.
 
 1. Read the task and identify domain and platform
 2. Scan `.agents/skills/` for available skills
 3. Read each `SKILL.md` description to assess relevance
-4. Load and follow any skill that applies — even partial match warrants loading
+4. Load and follow any skill that applies, even partial match warrants loading
 
 Rules:
 - Never implement directly if a skill applies
-- Follow skill instructions exactly — do not partially apply them
-- If two skills apply, follow both — resolve conflicts by asking the lead
+- Follow skill instructions exactly, do not partially apply them
+- If two skills apply, follow both, resolve conflicts by asking the lead
 
 ## Responsibilities
 
@@ -49,23 +49,23 @@ Rules:
 - CI/CD pipeline definitions
 - Docker and container configs
 - Cloud resource provisioning scripts
-- Environment variable and secret configuration (structure only — never values)
+- Environment variable and secret configuration (structure only, never values)
 - Monitoring and alerting rules
 
 ## Constraints
 
 - Do not apply Terraform in production without explicit human approval
-- Do not store secret values — structure and references only
+- Do not store secret values, structure and references only
 - Do not modify application code (UI, backend, tests)
-- Do not push to `main` — feature branches only
-- Do not merge PRs — human-only
+- Do not push to `main`, feature branches only
+- Do not merge PRs, human-only
 - Do not force push
 - Report blockers immediately rather than working around them
 
 ## Output Format
 
 ```
-## Infra Engineer — Done
+## Infra Engineer, Done
 
 **Tasks completed:** <count>
 **Files changed:** <list>

package/content/.agents/agents/quality-engineer.md

@@ -12,13 +12,13 @@ permission:
 
 # Quality Engineer
 
-Testing specialist — unit, integration, and e2e across front and back. Spawned by the lead agent via opencode-ensemble.
+Testing specialist, unit, integration, and e2e across front and back. Spawned by the lead agent via opencode-ensemble.
 
 ## Domain
 
-Unit tests, integration tests, end-to-end tests, test strategy, coverage analysis, acceptance criteria verification, build verification, linting. Works across frontend and backend — does not specialize in one layer.
+Unit tests, integration tests, end-to-end tests, test strategy, coverage analysis, acceptance criteria verification, build verification, linting. Works across frontend and backend, does not specialize in one layer.
 
-## RTK — MANDATORY
+## RTK, MANDATORY
 
 Use `rtk` for ALL CLI commands. Never run commands directly.
 
@@ -29,19 +29,19 @@ Use `rtk` for ALL CLI commands. Never run commands directly.
 
 If `rtk` is not available, report it as a blocker. Do not run commands without it.
 
-## Skills — Auto-Detection
+## Skills, Auto-Detection
 
-Skills are located in `.agents/skills/`. Detect and use relevant skills automatically — the user will never tell you which skill to use.
+Skills are located in `.agents/skills/`. Detect and use relevant skills automatically, the user will never tell you which skill to use.
 
 1. Read the task and identify domain and platform
 2. Scan `.agents/skills/` for available skills
 3. Read each `SKILL.md` description to assess relevance
-4. Load and follow any skill that applies — even partial match warrants loading
+4. Load and follow any skill that applies, even partial match warrants loading
 
 Rules:
 - Never implement directly if a skill applies
-- Follow skill instructions exactly — do not partially apply them
-- If two skills apply, follow both — resolve conflicts by asking the lead
+- Follow skill instructions exactly, do not partially apply them
+- If two skills apply, follow both, resolve conflicts by asking the lead
 
 ## Responsibilities
 
@@ -54,16 +54,16 @@ Rules:
 
 ## Constraints
 
-- Do not implement features — testing and verification only
-- Do not push to `main` — feature branches only
-- Do not merge PRs — human-only
+- Do not implement features, testing and verification only
+- Do not push to `main`, feature branches only
+- Do not merge PRs, human-only
 - Do not force push
-- Report all failures — do not silently skip failing tests
+- Report all failures, do not silently skip failing tests
 
 ## Output Format
 
 ```
-## Quality Engineer — Done
+## Quality Engineer, Done
 
 **Tests added:** <count> (front: <n>, back: <n>, e2e: <n>)
 **Tests passing:** <count>/<total>

package/content/.agents/agents/security-auditor.md

@@ -12,13 +12,13 @@ permission:
 
 # Security Auditor
 
-Security specialist — finds vulnerabilities across all layers. Spawned by the lead agent via opencode-ensemble after quality-engineer passes.
+Security specialist, finds vulnerabilities across all layers. Spawned by the lead agent via opencode-ensemble after quality-engineer passes.
 
 ## Domain
 
-OWASP Top 10 vulnerabilities, secrets and credential exposure, authentication and authorization gaps, injection risks (SQL, XSS, command), insecure dependencies, misconfigured CORS or headers, data exposure in logs or responses. Works across all layers — UI, backend, infra.
+OWASP Top 10 vulnerabilities, secrets and credential exposure, authentication and authorization gaps, injection risks (SQL, XSS, command), insecure dependencies, misconfigured CORS or headers, data exposure in logs or responses. Works across all layers, UI, backend, infra.
 
-## RTK — MANDATORY
+## RTK, MANDATORY
 
 Use `rtk` for ALL CLI commands. Never run commands directly.
 
@@ -27,19 +27,19 @@ Use `rtk` for ALL CLI commands. Never run commands directly.
 
 If `rtk` is not available, report it as a blocker. Do not run commands without it.
 
-## Skills — Auto-Detection
+## Skills, Auto-Detection
 
-Skills are located in `.agents/skills/`. Detect and use relevant skills automatically — the user will never tell you which skill to use.
+Skills are located in `.agents/skills/`. Detect and use relevant skills automatically, the user will never tell you which skill to use.
 
 1. Read the task and identify domain and platform
 2. Scan `.agents/skills/` for available skills
 3. Read each `SKILL.md` description to assess relevance
-4. Load and follow any skill that applies — even partial match warrants loading
+4. Load and follow any skill that applies, even partial match warrants loading
 
 Rules:
 - Never implement directly if a skill applies
-- Follow skill instructions exactly — do not partially apply them
-- If two skills apply, follow both — resolve conflicts by asking the lead
+- Follow skill instructions exactly, do not partially apply them
+- If two skills apply, follow both, resolve conflicts by asking the lead
 
 ## Responsibilities
 
@@ -54,22 +54,22 @@ Rules:
 
 ## Severity Levels
 
-- **Critical** — Must block merge: secret exposure, auth bypass, data loss risk
-- **High** — Should fix before merge: injection risk, missing auth, sensitive data leak
-- **Medium** — Fix soon: missing rate limiting, weak validation, insecure config
-- **Low** — Informational: minor hardening opportunities
+- **Critical**, Must block merge: secret exposure, auth bypass, data loss risk
+- **High**, Should fix before merge: injection risk, missing auth, sensitive data leak
+- **Medium**, Fix soon: missing rate limiting, weak validation, insecure config
+- **Low**, Informational: minor hardening opportunities
 
 ## Constraints
 
-- Audit only — `edit: deny` enforced
+- Audit only, `edit: deny` enforced
 - Do not push to `main`
-- Do not merge PRs — human-only
-- Critical findings must block the PR — report to lead immediately
+- Do not merge PRs, human-only
+- Critical findings must block the PR, report to lead immediately
 
 ## Output Format
 
 ```
-## Security Auditor — Done
+## Security Auditor, Done
 
 **Status:** pass | blocked
 **Critical:** <count>
@@ -78,7 +78,7 @@ Rules:
 **Low:** <count>
 
 ### Findings
-- [severity] [file:line] <description> — <recommended fix>
+- [severity] [file:line] <description>, <recommended fix>
 
 **Blockers:** none | <critical findings that must be resolved before PR>
 ```

package/package.json

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

package/src/index.js

@@ -1,98 +1,106 @@
-#!/usr/bin/env node
-import chalk from 'chalk'
-import { checkEnv } from './steps/check-env.js'
-import { checkPlatform } from './steps/check-platform.js'
-import { checkRtk } from './steps/check-rtk.js'
-import { chooseModels } from './steps/choose-models.js'
-import { choosePlatform } from './steps/choose-platform.js'
-import { chooseSkillsProvider } from './steps/choose-skills-provider.js'
-import { cleanAiFiles } from './steps/clean-ai-files.js'
-import { copyContentStep } from './steps/copy-content.js'
-import { initOpenspec } from './steps/init-openspec.js'
-import { installBrowser } from './steps/install-browser.js'
-
-console.clear()
-console.log()
-const logo = chalk.hex('#fe3d57')
-console.log(logo('                             '))
-console.log(logo('        ▒▒▒▒▒▒▒▒▒▒▒▒▒        '))
-console.log(logo('        ▓▒▓       ▓▒▓        '))
-console.log(logo('   ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '))
-console.log(logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓  '))
-console.log(logo(' ▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓ '))
-console.log(logo(' ▓▓▒▒▒░░░▒▒▒▒▒▒▒▒▒▒▒░░░▒▒▒▓▓ '))
-console.log(logo('  ▓▓▓▓▒▒▒▓▓▓▓▓▓▓▓▓▓▓▒▒▒▓▓▓▓  '))
-console.log(logo('  ▓▒▒▒▒▒▒▒░▒▒▒▒▒▒▒░▒▒▒▒▒▒▒▓  '))
-console.log(logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓  '))
-console.log(logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '))
-console.log(logo('   ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ '))
-console.log()
-console.log(chalk.bold('        🧰 opencode-onboard'))
-console.log(chalk.dim('        Prepare your codebase for AI agents'))
-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()
-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 {
-  // 1. Check Node + pnpm
-  await checkEnv()
-
-  // 2. Clean existing AI config files
-  await cleanAiFiles()
-
-  // 3. Choose platform
-  const platform = await choosePlatform()
-
-  // 4. Check platform CLI (az or gh)
-  await checkPlatform(platform)
-
-  // 5. Copy content
-  await copyContentStep(platform)
-
-  // 6. Init OpenSpec
-  await initOpenspec()
-
-  // 7. Install skills
-  await chooseSkillsProvider()
-
-  // 8. Choose models
-  await chooseModels()
-
-  // 9. Check RTK
-  await checkRtk()
-
-  // 10. Install opencode-browser
-  await installBrowser()
-
-  // Done
-  console.log()
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log(chalk.bold.green('  Onboarding complete!'))
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log()
-  console.log('  Next step:')
-  console.log(chalk.hex('#fe3d57')('  Open OpenCode in this project and type: ') + chalk.bold('"init"'))
-  console.log()
-  console.log('  OpenCode will generate ARCHITECTURE.md and DESIGN.md')
-  console.log('  from your actual codebase, then activate the agent team.')
-  console.log()
-} 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)
-  }
+#!/usr/bin/env node
+import chalk from 'chalk'
+import { checkEnv } from './steps/check-env.js'
+import { checkPlatform } from './steps/check-platform.js'
+import { checkRtk } from './steps/check-rtk.js'
+import { chooseModels } from './steps/choose-models.js'
+import { choosePlatform } from './steps/choose-platform.js'
+import { chooseSkillsProvider } from './steps/choose-skills-provider.js'
+import { cleanAiFiles } from './steps/clean-ai-files.js'
+import { copyContentStep } from './steps/copy-content.js'
+import { initOpenspec } from './steps/init-openspec.js'
+import { installBrowser } from './steps/install-browser.js'
+
+if (process.stdout.isTTY) console.clear()
+console.log()
+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('        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 {
+  // 1. Check Node + pnpm
+  await checkEnv()
+
+  // 2. Clean existing AI config files
+  await cleanAiFiles()
+
+  // 3. Choose platform
+  const platform = await choosePlatform()
+
+  // 4. Check platform CLI (az or gh)
+  await checkPlatform(platform)
+
+  // 5. Copy content
+  await copyContentStep(platform)
+
+  // 6. Init OpenSpec
+  await initOpenspec()
+
+  // 7. Install skills
+  await chooseSkillsProvider()
+
+  // 8. Choose models
+  await chooseModels()
+
+  // 9. Check RTK
+  await checkRtk()
+
+  // 10. Install opencode-browser
+  await installBrowser()
+
+  // Done
+  console.log()
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log(chalk.bold.green('  Onboarding complete!'))
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log()
+  console.log('  Next step:')
+  console.log(chalk.hex('#fe3d57')('  Open OpenCode in this project and type: ') + chalk.bold('"init"'))
+  console.log()
+  console.log('  OpenCode will generate ARCHITECTURE.md and DESIGN.md')
+  console.log('  from your actual codebase, then activate the agent team.')
+  console.log()
+} 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)
+  }
+}

package/src/steps/choose-models.js

@@ -30,7 +30,7 @@ function buildDisplayModels(rawModels) {
       : ''
     return {
       ...m,
-      label: `${m.name}${COST_TIER_DISPLAY(m.cost, m.canonicalCost)} — ${m.id}`,
+      label: `${m.name}${COST_TIER_DISPLAY(m.cost, m.canonicalCost)}, ${m.id}`,
       description: `${priceStr}${canonicalNote} · context: ${m.context ? (m.context / 1000) + 'k' : '?'}`,
     }
   })
@@ -78,7 +78,7 @@ export async function chooseModels() {
   }
 
   if (source === 'stale-cache') {
-    warn('Network unavailable — using cached model list (may be outdated).')
+    warn('Network unavailable, using cached model list (may be outdated).')
   } else if (source === 'cache') {
     info('Using cached model list (refreshes weekly).')
   }
@@ -91,20 +91,20 @@ export async function chooseModels() {
   console.log()
 
   // Plan model
-  info('PLAN model — used by the main agent for proposals, specs, architecture decisions.')
+  info('PLAN model, used by the main agent for proposals, specs, architecture decisions.')
   info('Pick something capable with strong reasoning.')
   const planModel = await pickModel('Plan model:', models)
   console.log()
 
   // Build model
-  info('BUILD model — used by front-engineer, back-engineer, infra-engineer, quality-engineer, security-auditor.')
+  info('BUILD model, used by front-engineer, back-engineer, infra-engineer, quality-engineer, security-auditor.')
   info('Pick something capable for implementation work.')
   const buildModel = await pickModel('Build model:', models)
   console.log()
 
   // Fast model
-  info('FAST model — used by devops-manager for reading issues, classifying PR comments.')
-  info('Pick something fast and cheap — no heavy reasoning needed.')
+  info('FAST model, used by devops-manager for reading issues, classifying PR comments.')
+  info('Pick something fast and cheap, no heavy reasoning needed.')
   const fastModel = await pickModel('Fast model:', models)
   console.log()
 

package/src/steps/choose-skills-provider.js

@@ -1,8 +1,8 @@
 import { select } from '@inquirer/prompts'
+import { execa } from 'execa'
 import fse from 'fs-extra'
 import path from 'path'
 import { fileURLToPath } from 'url'
-import { execa } from 'execa'
 import { header, info, success, warn } from '../utils/exec.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -30,13 +30,13 @@ async function installObSkills() {
 export async function chooseSkillsProvider() {
   header('Step 7, Installing skills')
 
-  // ob-skills are always installed — mandatory
+  // ob-skills are always installed, mandatory
   info('Installing built-in ob-skills...')
   await installObSkills()
   console.log()
 
   info('Skills provide platform and tech-specific knowledge to your agents.')
-  info('Agents detect and load skills automatically — you never need to specify them.')
+  info('Agents detect and load skills automatically, you never need to specify them.')
   info('You can add more skills on top of the built-in ones.')
   console.log()
 
@@ -49,7 +49,7 @@ export async function chooseSkillsProvider() {
         description: 'Install skills from the vercel-labs community skills registry',
       },
       {
-        name: 'None — built-in skills are enough',
+        name: 'None, built-in skills are enough',
         value: 'none',
       },
     ],

package/src/utils/exec.js

@@ -1,161 +1,161 @@
-import chalk from 'chalk'
-import { execa } from 'execa'
-import ora from 'ora'
-
-// ── Screen / step state ──────────────────────────────────────────────────────
-
-const previousSteps = []    // up to 2 completed steps, each is an array of lines
-let currentStepLines = []   // lines accumulated in the current step
-let stepSpinner = null      // ora spinner shown while step is working
-
-function appendLine(line) {
-  currentStepLines.push(line)
-}
-
-function stopSpinner() {
-  if (stepSpinner) {
-    stepSpinner.stop()
-    stepSpinner = null
-  }
-}
-
-function redraw() {
-  console.clear()
-
-  // Show up to 2 previous steps dimmed
-  for (const stepLines of previousSteps) {
-    for (const line of stepLines) {
-      process.stdout.write(chalk.dim(line) + '\n')
-    }
-    process.stdout.write('\n')
-  }
-
-  // Current step output
-  for (const line of currentStepLines) {
-    process.stdout.write(line + '\n')
-  }
-}
-
-// ── Public API ───────────────────────────────────────────────────────────────
-
-/**
- * Run a shell command with a spinner.
- * Returns { success, stdout, stderr }
- */
-export async function run(command, args = [], { label, cwd = process.cwd() } = {}) {
-  const spinner = ora(label ?? `${command} ${args.join(' ')}`).start()
-  try {
-    const result = await execa(command, args, { cwd, reject: false })
-    if (result.exitCode === 0) {
-      spinner.succeed()
-    } else {
-      spinner.fail()
-    }
-    return { success: result.exitCode === 0, stdout: result.stdout, stderr: result.stderr }
-  } catch (err) {
-    spinner.fail()
-    return { success: false, stdout: '', stderr: err.message }
-  }
-}
-
-/**
- * Check if a command is available on PATH.
- * Returns true/false.
- */
-export async function commandExists(command) {
-  try {
-    const result = await execa(command, ['--version'], { reject: false })
-    return result.exitCode === 0
-  } catch {
-    return false
-  }
-}
-
-/**
- * Print a section header — clears screen, shows previous step dimmed, starts new step.
- */
-export function header(text) {
-  // Rotate buffers — keep last 2 completed steps
-  previousSteps.push(currentStepLines)
-  if (previousSteps.length > 2) previousSteps.shift()
-  currentStepLines = []
-
-  const line1 = ''
-  const line2 = chalk.bold.hex('#fe3d57')(`━━ ${text}`)
-  const line3 = ''
-
-  appendLine(line1)
-  appendLine(line2)
-  appendLine(line3)
-
-  redraw()
-
-  // Start a spinner while the step is working
-  stepSpinner = ora({ text: chalk.dim('working...'), color: 'red' }).start()
-}
-
-/**
- * Print a success line.
- */
-export function success(text) {
-  stopSpinner()
-  const line = chalk.green('✓ ') + text
-  appendLine(line)
-  console.log(line)
-}
-
-/**
- * Print a warning line.
- */
-export function warn(text) {
-  stopSpinner()
-  const line = chalk.yellow('⚠ ') + text
-  appendLine(line)
-  console.log(line)
-}
-
-/**
- * Print an error line.
- */
-export function error(text) {
-  stopSpinner()
-  const line = chalk.red('✗ ') + text
-  appendLine(line)
-  console.log(line)
-}
-
-/**
- * Print an info line.
- */
-export function info(text) {
-  stopSpinner()
-  const line = chalk.dim('  ' + text)
-  appendLine(line)
-  console.log(line)
-}
-
-/**
- * Print an action prompt line (white bold — requires user interaction).
- */
-export function prompt(text) {
-  stopSpinner()
-  const line = chalk.bold('  ' + text)
-  appendLine(line)
-  console.log(line)
-}
-
-/**
- * Print a code block.
- */
-export function code(lines) {
-  stopSpinner()
-  appendLine('')
-  console.log()
-  for (const line of lines) {
-    const formatted = chalk.bgGray.white('  ' + line + '  ')
-    appendLine(formatted)
-    console.log(formatted)
-  }
-  appendLine('')
-  console.log()
-}
+import chalk from 'chalk'
+import { execa } from 'execa'
+import ora from 'ora'
+
+// ── Screen / step state ──────────────────────────────────────────────────────
+
+const previousSteps = []    // up to 2 completed steps, each is an array of lines
+let currentStepLines = []   // lines accumulated in the current step
+let stepSpinner = null      // ora spinner shown while step is working
+
+function appendLine(line) {
+  currentStepLines.push(line)
+}
+
+function stopSpinner() {
+  if (stepSpinner) {
+    stepSpinner.stop()
+    stepSpinner = null
+  }
+}
+
+function redraw() {
+  if (process.stdout.isTTY) console.clear()
+
+  // Show up to 2 previous steps dimmed
+  for (const stepLines of previousSteps) {
+    for (const line of stepLines) {
+      process.stdout.write(chalk.dim(line) + '\n')
+    }
+    process.stdout.write('\n')
+  }
+
+  // Current step output
+  for (const line of currentStepLines) {
+    process.stdout.write(line + '\n')
+  }
+}
+
+// ── Public API ───────────────────────────────────────────────────────────────
+
+/**
+ * Run a shell command with a spinner.
+ * Returns { success, stdout, stderr }
+ */
+export async function run(command, args = [], { label, cwd = process.cwd() } = {}) {
+  const spinner = ora(label ?? `${command} ${args.join(' ')}`).start()
+  try {
+    const result = await execa(command, args, { cwd, reject: false })
+    if (result.exitCode === 0) {
+      spinner.succeed()
+    } else {
+      spinner.fail()
+    }
+    return { success: result.exitCode === 0, stdout: result.stdout, stderr: result.stderr }
+  } catch (err) {
+    spinner.fail()
+    return { success: false, stdout: '', stderr: err.message }
+  }
+}
+
+/**
+ * Check if a command is available on PATH.
+ * Returns true/false.
+ */
+export async function commandExists(command) {
+  try {
+    const result = await execa(command, ['--version'], { reject: false })
+    return result.exitCode === 0
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Print a section header, clears screen, shows previous step dimmed, starts new step.
+ */
+export function header(text) {
+  // Rotate buffers, keep last 2 completed steps
+  previousSteps.push(currentStepLines)
+  if (previousSteps.length > 2) previousSteps.shift()
+  currentStepLines = []
+
+  const line1 = ''
+  const line2 = chalk.bold.hex('#fe3d57')(`━━ ${text}`)
+  const line3 = ''
+
+  appendLine(line1)
+  appendLine(line2)
+  appendLine(line3)
+
+  redraw()
+
+  // Start a spinner while the step is working
+  stepSpinner = ora({ text: chalk.dim('working...'), color: 'red' }).start()
+}
+
+/**
+ * Print a success line.
+ */
+export function success(text) {
+  stopSpinner()
+  const line = chalk.green('✓ ') + text
+  appendLine(line)
+  console.log(line)
+}
+
+/**
+ * Print a warning line.
+ */
+export function warn(text) {
+  stopSpinner()
+  const line = chalk.yellow('⚠ ') + text
+  appendLine(line)
+  console.log(line)
+}
+
+/**
+ * Print an error line.
+ */
+export function error(text) {
+  stopSpinner()
+  const line = chalk.red('✗ ') + text
+  appendLine(line)
+  console.log(line)
+}
+
+/**
+ * Print an info line.
+ */
+export function info(text) {
+  stopSpinner()
+  const line = chalk.dim('  ' + text)
+  appendLine(line)
+  console.log(line)
+}
+
+/**
+ * Print an action prompt line (white bold, requires user interaction).
+ */
+export function prompt(text) {
+  stopSpinner()
+  const line = chalk.bold('  ' + text)
+  appendLine(line)
+  console.log(line)
+}
+
+/**
+ * Print a code block.
+ */
+export function code(lines) {
+  stopSpinner()
+  appendLine('')
+  console.log()
+  for (const line of lines) {
+    const formatted = chalk.bgGray.white('  ' + line + '  ')
+    appendLine(formatted)
+    console.log(formatted)
+  }
+  appendLine('')
+  console.log()
+}

package/src/utils/models-cache.js

@@ -1,6 +1,6 @@
 import fse from 'fs-extra'
-import path from 'path'
 import os from 'os'
+import path from 'path'
 
 const CACHE_DIR = path.join(os.homedir(), '.config', 'opencode-onboard')
 const CACHE_FILE = path.join(CACHE_DIR, 'models-cache.json')
@@ -87,7 +87,7 @@ export async function fetchModels() {
     await saveCache(models)
     return { models, source: 'network' }
   } catch {
-    // 3. Network failed — fall back to stale cache if available
+    // 3. Network failed, fall back to stale cache if available
     try {
       if (await fse.pathExists(CACHE_FILE)) {
         const cache = await fse.readJson(CACHE_FILE)