cli-five 0.2.12 → 0.2.15

package/README.md

@@ -1,6 +1,6 @@
 # cli-five
 
-> **Code Like I'm Five** — scaffold a 5-agent VS Code Copilot team into any repo.
+> **Code Like I'm Five** — scaffold a 5-agent AI team into any repo.
 
 ## Two ways to install
 
@@ -10,9 +10,9 @@
 npx cli-five init
 ```
 
-Interviews you, scaffolds agents + memory files + stack-specific instructions, discovers skills from **awesome-copilot** and **skills.sh**, and tells you what to do next.
+Interviews you, lets you pick a target platform and model provider, scaffolds agents + memory files + stack-specific instructions, discovers skills, and tells you what to do next.
 
-### Quick plugin install (personal use)
+### Quick plugin install (personal use, Copilot only)
 
 ```
 copilot plugin install idusortus/cli-five
@@ -20,20 +20,34 @@ copilot plugin install idusortus/cli-five
 
 Installs the 5 agents to your Copilot profile. No project config, no interview — just the agents with the same autonomous contracts shipped by the scaffolded templates.
 
+## Supported platforms
+
+cli-five can scaffold for:
+
+- **GitHub Copilot** — `.github/agents/*.agent.md` + `copilot-instructions.md`
+- **OpenCode** — `.opencode/agents/*.md` + `opencode.json`
+
+Both platforms can optionally include a **CodeGraph** MCP server and instructions.
+
+Run `npx cli-five init` and choose your platform. If you want both, run it again in the same repo.
+
 ## What you get
 
+### GitHub Copilot layout
+
 ```
 your-repo/
 ├── .github/
 │   ├── agents/                  # 5 agents — Orchestrator delegates autonomously
-│   │   ├── orchestrator.agent.md  # Routes tasks: Planner → Coder/Designer → Reviewer
-│   │   ├── planner.agent.md       # Researches codebase, produces implementation plans
-│   │   ├── coder.agent.md         # Writes production code, runs tests
-│   │   ├── designer.agent.md      # UI/UX design, layouts, theming
-│   │   └── reviewer.agent.md      # Code review, convention compliance
+│   │   ├── orchestrator.agent.md
+│   │   ├── planner.agent.md
+│   │   ├── coder.agent.md
+│   │   ├── designer.agent.md
+│   │   └── reviewer.agent.md
 │   ├── copilot-instructions.md  # Persona + project mandates from interview
 │   ├── instructions/            # Stack-specific coding guidelines
 │   └── skills/                  # Installed skills from awesome-copilot + skills.sh
+├── .vscode/mcp.json             # CodeGraph MCP server (optional)
 ├── AGENTS.md                    # Tool-agnostic project context (agents.md standard)
 ├── PROJECT.md                   # Long-form vision (rarely changes)
 ├── STATE.md                     # Cross-session status (changes constantly)
@@ -42,9 +56,31 @@ your-repo/
 └── histories/                   # Per-agent accumulated learnings
 ```
 
+### OpenCode layout
+
+```
+your-repo/
+├── .opencode/
+│   └── agents/                  # 5 agents — Orchestrator delegates autonomously
+│       ├── orchestrator.md
+│       ├── planner.md
+│       ├── coder.md
+│       ├── designer.md
+│       └── reviewer.md
+├── opencode.json                # Project config, model defaults, CodeGraph MCP (optional)
+├── .github/instructions/        # Stack-specific coding guidelines
+├── .github/skills/              # Installed skills
+├── AGENTS.md                    # Project rules + optional CodeGraph block
+├── PROJECT.md
+├── STATE.md
+├── decisions.md
+├── agent-diary.md
+└── histories/
+```
+
 ## How it works
 
-Select the **Orchestrator** agent in Copilot Chat and describe what you want. The Orchestrator autonomously calls Planner → Coder/Designer → Reviewer without any manual handoff clicks.
+Select the **Orchestrator** agent and describe what you want. The Orchestrator autonomously calls Planner → Coder/Designer → Reviewer without any manual handoff clicks.
 
 ```
 User: implement from plan.md
@@ -53,13 +89,13 @@ Orchestrator → [calls Planner] → [calls Coder] → [calls Reviewer] → done
 
 No buttons. No "click here to continue". Just results.
 
-The plugin agents and scaffolded `.github/agents/*.agent.md` templates are intentionally kept in sync. The repository test suite now checks that parity so the quick-install path does not quietly degrade.
+The plugin agents and scaffolded `.github/agents/*.agent.md` templates are intentionally kept in sync. The repository test suite checks that parity so the quick-install path does not quietly degrade.
 
 ## Commands
 
 ```bash
 npx cli-five init              # interview + scaffold + skill discovery
-npx cli-five doctor            # validate an existing setup
+npx cli-five doctor            # validate an existing cli-five setup
 npx cli-five list-stacks       # show detectable tech stacks
 npx cli-five help
 ```
@@ -72,34 +108,69 @@ npx cli-five help
 | `--force` | Overwrite without confirmation (use with `--yes`) |
 | `--dry-run` | Print actions, write nothing |
 | `--no-skills` | Skip skills.sh discovery step |
-| `--cost-mode <m>` | Set cost mode: `premium`, `cheap`, or `mixed` |
+| `--no-codegraph` | Skip CodeGraph MCP + instructions |
+| `--target <t>` | Target platform: `copilot` or `opencode` (default: `copilot`) |
+| `--provider <p>` | Model provider: `copilot`, `opencode`, `opencode-go` (default: platform default) |
+| `--cost-mode <m>` | Set cost mode for Copilot: `premium`, `cheap`, or `mixed` |
+| `--doc <file>` | Read project docs to pre-fill interview (repeatable) |
 | `--cwd <path>` | Run against a different directory |
 
 ## What `init` does
 
 1. **Detect** — fingerprints stack (Node/TS, Python, .NET, Kotlin, Rust, Go, etc.). Brownfield-aware.
-2. **git init** — if needed. Asks first.
-3. **Overwrite gate** — double-confirms ("Proceed?" then "R U Sure?"). Only `--force --yes` bypasses.
-4. **Interview** — name, one-liner, stack, frameworks, goals, constraints, cost mode, persona toggle.
-5. **Scaffold** — writes 18 files. Substitutes answers into templates. Swaps `model:` per cost mode.
-6. **Skill discovery** — the hero feature. Multi-source discovery from **awesome-copilot** (30k+ ★ community marketplace) and **skills.sh**. Color-coded recommendations, source attribution, multiselect install, and post-install breadcrumbs with copy-paste commands for the awesome-copilot suggestion skill and MCP server.
-7. **Custom instructions** — generates stack-specific `.instructions.md` files for detected languages.
-8. **Next steps** — tells you to open Copilot Chat, select Orchestrator, and start building. No button-clicking required.
+2. **Choose platform** — GitHub Copilot or OpenCode, with optional CodeGraph pairing.
+3. **git init** — if needed. Asks first.
+4. **Overwrite gate** — double-confirms ("Proceed?" then "R U Sure?"). Only `--force --yes` bypasses.
+5. **Project info** — name, one-liner, stack, frameworks, goals, constraints, persona toggle.
+6. **Model configuration** — pick a provider and optionally override each agent's model.
+7. **Scaffold** — writes platform-specific files. Swaps `model:` per provider/selection.
+8. **Skill discovery** — multi-source discovery from **awesome-copilot** and **skills.sh**.
+9. **Custom instructions** — generates stack-specific `.instructions.md` files for detected languages.
+10. **Next steps** — platform-specific instructions. No button-clicking required.
+
+## Model providers
+
+During `init` you can choose the model provider and optionally customize each agent's model.
 
-## Cost modes
+| Provider | Platform | Example model |
+|---|---|---|
+| GitHub Copilot | Copilot | `Claude Sonnet 4.6 (copilot)` |
+| OpenCode Zen | OpenCode | `opencode/gpt-5.3-codex` |
+| OpenCode Go | OpenCode | `opencode-go/qwen3.8-max` |
+
+`--yes` uses the provider's defaults. `--provider opencode-go --yes` skips the provider prompt.
+
+### Copilot cost modes
 
 | Agent | `premium` (1x–3x) | `cheap` (0x) | `mixed` |
 |---|---|---|---|
 | Orchestrator | Claude Sonnet 4.6 | GPT-4.1 | GPT-4.1 |
 | Planner | Claude Opus 4.6 | GPT-4o | GPT-4o |
 | Coder | GPT-5.3-Codex | GPT-4.1 | GPT-5.3-Codex |
-| Designer | Claude Opus 4.6 | GPT-4o | GPT-4o |
-| Reviewer | Claude Opus 4.6 | GPT-5 mini | Claude Opus 4.6 |
+| Designer | Gemini 3.1 Pro (Preview) | GPT-4o | GPT-4o |
+| Reviewer | Claude Sonnet 4.6 | GPT-5 mini | Claude Sonnet 4.6 |
 
 Override from CLI: `npx cli-five init --cost-mode cheap`
-Change anytime by editing the `model:` line in `.github/agents/*.agent.md`.
+Change anytime by editing the `model:` line in the agent files.
+
+## CodeGraph
 
-## Required VS Code settings
+CodeGraph adds a local, graph-backed codebase context server. When enabled, cli-five:
+
+- Registers the CodeGraph MCP server in `opencode.json` (OpenCode) or `.vscode/mcp.json` (Copilot).
+- Adds a marker-fenced CodeGraph section to `AGENTS.md`.
+- Tells you to run `codegraph init` to index the project.
+
+cli-five does **not** install or run the CodeGraph CLI automatically. After scaffolding:
+
+```bash
+npm i -g @colbymchenry/codegraph
+codegraph init
+```
+
+## Required settings
+
+### GitHub Copilot
 
 ```jsonc
 {
@@ -107,6 +178,10 @@ Change anytime by editing the `model:` line in `.github/agents/*.agent.md`.
 }
 ```
 
+### OpenCode
+
+No extra settings required. Project agents live in `.opencode/agents/` and the project config in `opencode.json`.
+
 ## Skill discovery
 
 cli-five searches **two sources** for skills matching your detected stack:
@@ -127,7 +202,7 @@ Take time to read each installed skill so you understand what it does and can ca
 ## What this is not
 
 - **Not a runtime.** Once scaffolded, your repo doesn't depend on `cli-five`. You can uninstall the package and the agents still work.
-- **Not a workflow engine.** No `/plan-phase`, no `/ship`, no 50 slash commands. Use `/agent-customization` in Copilot Chat to extend.
+- **Not a workflow engine.** No `/plan-phase`, no `/ship`, no 50 slash commands. Use `/agent-customization` in Copilot Chat or OpenCode commands to extend.
 - **Not Ralph.** No issue-polling daemons, no autonomous loops, no crypto tokens.
 
 ## Why the name
@@ -144,6 +219,7 @@ ELI5 → CLI5. Code Like I'm Five. Five agents. Get it? Yeah, it's a stretch. Bu
 
 - The plugin install path and the scaffolded project path are both supported and now validated against each other.
 - `npm test` includes agent integrity checks in addition to the existing skill-step tests.
+- Google Antigravity AGY CLI support is planned but not implemented yet.
 
 ## Local development
 

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "cli-five",
-  "version": "0.2.12",
-  "description": "Code Like I'm Five — scaffold a 5-agent VS Code Copilot team into any repo.",
+  "version": "0.2.15",
+  "description": "Code Like I'm Five — scaffold a 5-agent AI team (GitHub Copilot or OpenCode) into any repo.",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/idusortus/cli-five.git"
+  },
+  "homepage": "https://github.com/idusortus/cli-five#readme",
+  "bugs": {
+    "url": "https://github.com/idusortus/cli-five/issues"
+  },
   "bin": {
     "cli-five": "bin/cli-five.mjs"
   },
@@ -24,6 +32,8 @@
   },
   "keywords": [
     "copilot",
+    "opencode",
+    "codegraph",
     "vscode",
     "agents",
     "scaffold",
@@ -33,6 +43,7 @@
   "dependencies": {
     "kleur": "^4.1.5",
     "prompts": "^2.4.2",
-    "skills": "^1.5.0"
+    "skills": "^1.5.0",
+    "yaml": "^2.8.3"
   }
 }

package/plugin-agents/designer.agent.md

@@ -1,7 +1,7 @@
 ---
 name: Designer
 description: "Handles all UI/UX design tasks. Use when: creating screens, layouts, theming, navigation flows, design systems."
-model: Claude Opus 4.6 (copilot)
+model: Gemini 3.1 Pro (Preview) (copilot)
 tools: ['read', 'edit', 'search', 'web', 'io.github.upstash/context7/*', 'vscode/memory']
 agents: []
 ---
@@ -10,7 +10,7 @@ agents: []
 
 | Mode | Model | Premium Cost |
 |---|---|---|
-| **Default** | Claude Opus 4.6 | 3x |
+| **Default** | Gemini 3.1 Pro (Preview) (copilot) | 1x |
 | **Cheap** | GPT-4o | 0x (free) |
 
 To switch: change the `model` key in frontmatter above.

package/plugin-agents/planner.agent.md

@@ -13,7 +13,7 @@ You create plans. You do NOT write code.
 
 | Mode | Model | Premium Cost |
 |---|---|---|
-| **Default** | Claude Sonnet 4.6 | 1x |
+| **Default** | Claude Opus 4.6 | 3x |
 | **Cheap** | GPT-4o | 0x (free) |
 
 To switch: change the `model` key in frontmatter above.

package/src/cli.mjs

@@ -8,13 +8,13 @@ import { listStacks } from './commands/list-stacks.mjs';
 import { STACK_SIGNATURES } from './steps/detect.mjs';
 
 const HELP = `${kleur.bold('cli-five')} ${kleur.gray('— Code Like I\'m Five')}
-Scaffold a 5-agent Copilot team into any repo.
+Scaffold a 5-agent AI team into any repo.
 
 ${kleur.bold('Usage')}
   npx cli-five <command> [options]
 
 ${kleur.bold('Commands')}
-  init            Interview + scaffold .github/* and project memory files
+  init            Interview + scaffold agents + project memory files
   doctor          Validate an existing cli-five setup
   list-stacks     Show detectable tech stacks
   help            Show this message
@@ -26,6 +26,9 @@ ${kleur.bold('Flags')}
   --no-skills     Skip the skills.sh discovery step
   --doc <file>    Read project docs to pre-fill interview (repeatable)
   --cost-mode <m> Override cost mode (premium, cheap, mixed) — skips interview question
+  --target <t>    Target platform: copilot or opencode (default: copilot)
+  --provider <p>  Model provider: copilot, opencode, opencode-go (default: platform default)
+  --no-codegraph  Skip CodeGraph MCP + instructions
   --cwd <path>    Run against a directory other than the current one
   --version, -v   Print version and exit
 `;
@@ -60,15 +63,30 @@ export async function run(argv) {
 }
 
 function parse(argv) {
-  const out = { _: [], yes: false, force: false, dryRun: false, skills: true, docs: [], costMode: null, cwd: process.cwd() };
+  const out = {
+    _: [],
+    yes: false,
+    force: false,
+    dryRun: false,
+    skills: true,
+    codegraph: true,
+    docs: [],
+    costMode: null,
+    target: null,
+    provider: null,
+    cwd: process.cwd(),
+  };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === '--yes' || a === '-y') out.yes = true;
     else if (a === '--force') out.force = true;
     else if (a === '--dry-run') out.dryRun = true;
     else if (a === '--no-skills') out.skills = false;
+    else if (a === '--no-codegraph') out.codegraph = false;
     else if (a === '--doc') out.docs.push(argv[++i]);
     else if (a === '--cost-mode') out.costMode = argv[++i];
+    else if (a === '--target') out.target = argv[++i];
+    else if (a === '--provider') out.provider = argv[++i];
     else if (a === '--cwd') out.cwd = argv[++i];
     else if (a === '--help' || a === '-h') out._.push('help');
     else if (a === '--version' || a === '-v') out._.push('--version');

package/src/commands/doctor.mjs

@@ -2,9 +2,15 @@ import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import kleur from 'kleur';
 import { log } from '../util/log.mjs';
-import { AGENT_FILES, validateAgentSource } from '../util/agents.mjs';
+import {
+  AGENT_FILES,
+  OPENCODE_AGENT_FILES,
+  validateAgentSource,
+  validateOpenCodeAgentSource,
+} from '../util/agents.mjs';
+import { PLATFORM_COPILOT, PLATFORM_OPENCODE } from '../util/platforms.mjs';
 
-const REQUIRED = [
+const COPILOT_REQUIRED = [
   '.github/copilot-instructions.md',
   '.github/agents/orchestrator.agent.md',
   '.github/agents/planner.agent.md',
@@ -17,6 +23,19 @@ const REQUIRED = [
   'agent-diary.md',
 ];
 
+const OPENCODE_REQUIRED = [
+  'opencode.json',
+  '.opencode/agents/orchestrator.md',
+  '.opencode/agents/planner.md',
+  '.opencode/agents/coder.md',
+  '.opencode/agents/designer.md',
+  '.opencode/agents/reviewer.md',
+  'PROJECT.md',
+  'STATE.md',
+  'decisions.md',
+  'agent-diary.md',
+];
+
 const OPTIONAL = [
   '.github/instructions',
   '.github/skills',
@@ -26,11 +45,15 @@ const OPTIONAL = [
 
 export async function doctor(args) {
   const cwd = args.cwd;
+  const platform = detectPlatform(cwd);
   log.raw(kleur.bold().magenta('\ncli-five doctor') + kleur.gray(`  ${cwd}`));
+  log.info(`Detected platform: ${kleur.bold(platform)}`);
   let fail = 0;
 
+  const required = platform === PLATFORM_OPENCODE ? OPENCODE_REQUIRED : COPILOT_REQUIRED;
+
   log.step('Required');
-  for (const p of REQUIRED) {
+  for (const p of required) {
     const ok = existsSync(join(cwd, p));
     if (ok) log.ok(p);
     else {
@@ -40,22 +63,60 @@ export async function doctor(args) {
   }
 
   log.step('Agent integrity');
-  for (const file of AGENT_FILES) {
-    const relPath = join('.github', 'agents', file);
-    const fullPath = join(cwd, relPath);
-    if (!existsSync(fullPath)) continue;
+  if (platform === PLATFORM_OPENCODE) {
+    for (const file of OPENCODE_AGENT_FILES) {
+      const relPath = join('.opencode', 'agents', file);
+      const fullPath = join(cwd, relPath);
+      if (!existsSync(fullPath)) continue;
 
-    const errors = validateAgentSource(readFileSync(fullPath, 'utf8'), file);
-    if (errors.length === 0) {
-      log.ok(relPath);
-      continue;
+      const errors = validateOpenCodeAgentSource(readFileSync(fullPath, 'utf8'), file);
+      if (errors.length === 0) {
+        log.ok(relPath);
+        continue;
+      }
+
+      log.err(relPath);
+      for (const error of errors) {
+        log.raw(kleur.red(`  - ${error}`));
+      }
+      fail++;
     }
+  } else {
+    for (const file of AGENT_FILES) {
+      const relPath = join('.github', 'agents', file);
+      const fullPath = join(cwd, relPath);
+      if (!existsSync(fullPath)) continue;
+
+      const errors = validateAgentSource(readFileSync(fullPath, 'utf8'), file);
+      if (errors.length === 0) {
+        log.ok(relPath);
+        continue;
+      }
+
+      log.err(relPath);
+      for (const error of errors) {
+        log.raw(kleur.red(`  - ${error}`));
+      }
+      fail++;
+    }
+  }
 
-    log.err(relPath);
-    for (const error of errors) {
-      log.raw(kleur.red(`  - ${error}`));
+  if (platform === PLATFORM_OPENCODE) {
+    log.step('OpenCode config');
+    const opencodePath = join(cwd, 'opencode.json');
+    if (existsSync(opencodePath)) {
+      try {
+        const cfg = JSON.parse(readFileSync(opencodePath, 'utf8'));
+        if (cfg.mcp?.codegraph) {
+          log.ok('opencode.json has CodeGraph MCP entry');
+        } else {
+          log.warn('opencode.json missing CodeGraph MCP entry (ok if CodeGraph disabled)');
+        }
+      } catch (err) {
+        log.err(`opencode.json is not valid JSON: ${err.message}`);
+        fail++;
+      }
     }
-    fail++;
   }
 
   log.step('Optional');
@@ -72,3 +133,9 @@ export async function doctor(args) {
     process.exit(1);
   }
 }
+
+function detectPlatform(cwd) {
+  if (existsSync(join(cwd, '.opencode', 'agents'))) return PLATFORM_OPENCODE;
+  if (existsSync(join(cwd, '.github', 'agents', 'orchestrator.agent.md'))) return PLATFORM_COPILOT;
+  return PLATFORM_COPILOT;
+}

package/src/commands/init.mjs

@@ -9,21 +9,30 @@ import { interview } from '../steps/interview.mjs';
 import { scaffold, summarize } from '../steps/scaffold.mjs';
 import { skillDiscovery } from '../steps/skills.mjs';
 import { instructionGeneration } from '../steps/instructions.mjs';
+import { choosePlatform, chooseModels } from '../steps/platform.mjs';
 import { isGitRepo, gitInit } from '../util/git.mjs';
+import { platformLabel } from '../util/platforms.mjs';
 
 export async function init(args) {
   const cwd = args.cwd;
   log.raw(kleur.bold().magenta('\ncli-five init') + kleur.gray(`  ${cwd}`));
 
   // 1. Detect
-  log.step('1/6 Detect workspace');
+  log.step('1/8 Detect workspace');
   const detected = detect(cwd);
   log.info(`Project: ${kleur.bold(detected.projectName)}`);
   log.info(`Mode:    ${detected.isBrownfield ? kleur.yellow('brownfield') : kleur.green('greenfield')}`);
   if (detected.stacks.length) log.info(`Stack:   ${detected.stacks.map((s) => s.label).join(', ')}`);
   if (!detected.hasGit) log.warn('Not a git repository.');
 
-  // 2. git init if needed
+  // 2. Platform + CodeGraph
+  log.step('2/8 Choose platform');
+  const { platform, codegraph } = await choosePlatform(args);
+  log.info(`Target:  ${kleur.bold(platformLabel(platform))}`);
+  if (codegraph) log.info(`CodeGraph: ${kleur.green('enabled')}`);
+  else log.info('CodeGraph: disabled');
+
+  // 3. git init if needed
   if (!detected.hasGit) {
     if (args.yes || (await ask('Run `git init`?', true))) {
       gitInit(cwd);
@@ -33,8 +42,8 @@ export async function init(args) {
     }
   }
 
-  // 3. Overwrite gate
-  log.step('2/6 Confirm overwrites');
+  // 4. Overwrite gate
+  log.step('3/8 Confirm overwrites');
   const ok = await confirmOverwriteIfNeeded(detected, args);
   if (!ok) {
     log.warn('Aborted. Nothing written.');
@@ -42,8 +51,8 @@ export async function init(args) {
   }
   if (!detected.hasAgents && !detected.hasCopilotInstructions) log.dim('No collisions.');
 
-  // 4. Input mode — docs or manual interview
-  log.step('3/6 Project info');
+  // 5. Input mode — docs or manual interview
+  log.step('4/8 Project info');
   let docHints;
 
   if (args.docs.length > 0) {
@@ -64,7 +73,15 @@ export async function init(args) {
     if (docHints.oneLiner) log.dim(`  → description: ${docHints.oneLiner}`);
   }
 
-  // 5. Interview (pre-filled from docs if available, otherwise manual)
+  // 6. Model configuration
+  log.step('5/8 Model configuration');
+  const modelConfig = await chooseModels(platform, args);
+  log.info(`Provider: ${kleur.bold(modelConfig.provider)}`);
+  if (modelConfig.customized) log.info('Models:  customized');
+  else log.info('Models:  defaults');
+
+  // 7. Interview (pre-filled from docs if available, otherwise manual)
+  args.__platform = platform;
   const answers = await interview(detected, args, docHints);
 
   // CLI --cost-mode override
@@ -72,24 +89,31 @@ export async function init(args) {
     answers.costMode = args.costMode;
   }
 
+  // Attach platform/model choices to answers so scaffold can use them.
+  answers.platform = platform;
+  answers.codegraph = codegraph;
+  answers.provider = modelConfig.provider;
+  answers.modelMap = modelConfig.modelMap;
+  answers.customizedModels = modelConfig.customized;
+
   if (answers.presetId && answers.presetId !== 'custom') {
     log.info(`Preset: ${answers.presetId}`);
   }
   if (answers.frameworks.length) log.info(`Stack:  ${answers.stack.join(', ')} + ${answers.frameworks.join(', ')}`);
 
-  // 5. Scaffold
-  log.step('4/6 Scaffold');
+  // 8. Scaffold
+  log.step('6/8 Scaffold');
   const written = scaffold({ cwd, answers, args });
   if (args.dryRun) log.warn('--dry-run: no files written. Plan:');
   log.raw(summarize(written, cwd));
   if (!args.dryRun) log.ok(`Wrote ${written.length} files.`);
 
-  // 6. Skill discovery
-  log.step('5/6 Skill discovery');
+  // 9. Skill discovery
+  log.step('7/8 Skill discovery');
   await skillDiscovery({ cwd, answers, args });
 
-  // 7. Custom instructions
-  log.step('6/6 Custom instructions');
+  // 10. Custom instructions
+  log.step('8/8 Custom instructions');
   const instrWritten = await instructionGeneration({ cwd, answers, args });
   if (instrWritten && instrWritten.length > 0) {
     if (args.dryRun) log.warn('--dry-run: instruction plan:');
@@ -99,7 +123,7 @@ export async function init(args) {
     if (!args.dryRun) log.ok(`Wrote ${instrWritten.length} instruction file${instrWritten.length > 1 ? 's' : ''}.`);
   }
 
-  // 8. Next steps
+  // 11. Next steps
   printNextSteps(answers);
 }
 
@@ -110,15 +134,29 @@ async function ask(message, initial = false) {
 
 function printNextSteps(answers) {
   const hasDocs = answers.docFiles?.length > 0;
+  const platform = answers.platform || 'copilot';
+  const codegraph = answers.codegraph;
 
   log.raw('');
   log.raw(kleur.bold().green('Done. Next steps:'));
   log.raw('');
-  log.raw(`  1. Open this folder in VS Code Insiders.`);
-  log.raw(`  2. Enable Copilot subagent invocations (settings.json):`);
-  log.raw(kleur.gray(`        "chat.subagents.allowInvocationsFromSubagents": true`));
-  log.raw(`  3. Open Copilot Chat — select an agent from the dropdown (${kleur.bold('not')} @mention).`);
-  log.raw(`  4. Select ${kleur.bold('Orchestrator')} — it routes tasks autonomously to Planner, Coder, Designer, and Reviewer.`);
+
+  if (platform === 'opencode') {
+    log.raw(`  1. Install the CodeGraph CLI if you haven't:`);
+    log.raw(kleur.gray(`        npm i -g @colbymchenry/codegraph`));
+    log.raw(`  2. Index this project with CodeGraph:`);
+    log.raw(kleur.gray(`        codegraph init`));
+    log.raw(`  3. Run OpenCode from this directory:`);
+    log.raw(kleur.gray(`        opencode`));
+    log.raw(`  4. Select ${kleur.bold('Orchestrator')} and describe what you want built.`);
+  } else {
+    log.raw(`  1. Open this folder in VS Code Insiders.`);
+    log.raw(`  2. Enable Copilot subagent invocations (settings.json):`);
+    log.raw(kleur.gray(`        "chat.subagents.allowInvocationsFromSubagents": true`));
+    log.raw(`  3. Open Copilot Chat — select an agent from the dropdown (${kleur.bold('not')} @mention).`);
+    log.raw(`  4. Select ${kleur.bold('Orchestrator')} — it routes tasks autonomously to Planner, Coder, Designer, and Reviewer.`);
+  }
+
   log.raw(`  5. ${hasDocs ? 'Kickoff prompt (paste this into Orchestrator):' : 'Start building:'}`);
   if (hasDocs) {
     const docList = answers.docFiles.join(', ');
@@ -129,11 +167,22 @@ function printNextSteps(answers) {
   }
   log.raw(`  6. Review generated instruction files in .github/instructions/.`);
   log.raw(kleur.gray(`        Edit applyTo globs and guidelines to fit your project.`));
-  log.raw('');
-  log.raw(kleur.dim('  Quick plugin install (personal, no project config):'));
-  log.raw(kleur.dim('    copilot plugin install idusortus/cli-five'));
-  log.raw('');
-  log.raw(kleur.dim('Edit cost mode anytime by changing `model:` in .github/agents/*.agent.md.'));
+
+  if (codegraph) {
+    log.raw('');
+    log.raw(kleur.dim('  CodeGraph is configured. Remember to run `codegraph init` before asking agents to explore the codebase.'));
+  }
+
+  if (platform === 'copilot') {
+    log.raw('');
+    log.raw(kleur.dim('  Quick plugin install (personal, no project config):'));
+    log.raw(kleur.dim('    copilot plugin install idusortus/cli-five'));
+    log.raw('');
+    log.raw(kleur.dim('Edit cost mode anytime by changing `model:` in .github/agents/*.agent.md.'));
+  } else {
+    log.raw('');
+    log.raw(kleur.dim('Edit agent models anytime by changing `model:` in .opencode/agents/*.md.'));
+  }
   log.raw('');
 }
 

package/src/steps/confirm.mjs

@@ -34,5 +34,7 @@ function collideList(detected) {
   const out = [];
   if (detected.hasAgents) out.push('.github/agents/');
   if (detected.hasCopilotInstructions) out.push('.github/copilot-instructions.md');
+  if (detected.hasOpencodeAgents) out.push('.opencode/agents/');
+  if (detected.hasOpencodeConfig) out.push('opencode.json');
   return out;
 }