takomi 2.0.6 → 2.1.0

package/assets/.agent/skills/pr-comment-fix/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: pr-comment-fix
+description: >
+  Automate fixing GitHub PR review comments. Use this skill whenever the user asks to
+  "fix PR comments", "address review feedback", "resolve PR threads", or references
+  a PR number/branch with unresolved review comments. Also trigger when the user says
+  things like "go through the review comments on my PR", "handle the feedback on #123",
+  or "clean up the review notes". Requires the `gh` CLI to be authenticated.
+---
+
+# PR Comment Fix Workflow
+
+Checkout a PR branch, fetch unresolved review comments, fix each one, commit, reply, resolve, and push — all in one pass.
+
+## Prerequisites
+
+Before starting, verify `gh` is authenticated:
+
+```bash
+gh auth status
+```
+
+If it fails, stop and tell the user to run `gh auth login`.
+
+## Step 1: Identify the PR
+
+Determine the target PR from the user's message. They might give you a PR number (`#142`), a branch name (`feature/new-parser`), or a URL. Normalize to a PR number early:
+
+```bash
+# If given a branch name, find its open PR
+gh pr list --head <branch-name> --state open --json number --jq '.[0].number'
+```
+
+Once you have the PR number, fetch the branch name and check it out:
+
+```bash
+gh pr checkout <pr-number>
+```
+
+This ensures you're on the exact branch the PR tracks — not a stale local copy.
+
+## Step 2: Fetch unresolved review comments
+
+Pull all review comments and filter to unresolved threads. Each comment has a thread ID, file path, line number, and body.
+
+```bash
+gh api graphql -f query='
+  query($owner: String!, $repo: String!, $pr: Int!) {
+    repository(owner: $owner, name: $repo) {
+      pullRequest(number: $pr) {
+        reviewThreads(first: 100) {
+          nodes {
+            id
+            isResolved
+            comments(first: 10) {
+              nodes {
+                body
+                path
+                line
+                author { login }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+' -f owner='{owner}' -f repo='{repo}' -F pr=<pr-number>
+```
+
+Extract `{owner}` and `{repo}` from the current git remote:
+
+```bash
+gh repo view --json owner,name --jq '"\(.owner.login) \(.name)"'
+```
+
+Filter to threads where `isResolved` is `false`. If every thread is already resolved, tell the user there's nothing to fix and stop.
+
+## Step 3: Triage comments
+
+Not every comment is actionable code feedback. Classify each unresolved thread:
+
+- **Actionable** — requests a concrete code change (rename, refactor, fix bug, add validation, change logic, etc.)
+- **Question / Discussion** — asks "why did you do X?" or debates an approach with no clear fix directive
+- **Nit / Style** — trivial formatting or naming preferences
+- **Praise / Acknowledgement** — compliments, thumbs-up, "looks good"
+
+Fix **Actionable** and **Nit/Style** comments. For **Question/Discussion** threads, draft a reply but flag them for the user to review rather than guessing at a code change. Skip **Praise** threads entirely (don't resolve them — the author may want them visible).
+
+## Step 4: Fix each comment
+
+For each actionable comment, in the order they appear per-file:
+
+1. **Read the file at the referenced path.** If the path no longer exists (file was renamed or deleted since the review), note this in your reply and skip.
+2. **Locate the relevant code.** The line number in the comment refers to the diff, which may have shifted. Use the comment's surrounding code context to find the right location in the current file — do not blindly trust line numbers.
+3. **Make the fix.** Apply the smallest change that fully addresses the feedback. If the reviewer's suggestion is ambiguous, prefer the most conservative interpretation.
+4. **Validate the fix compiles/parses.** After each file edit, run the project's build or lint command if one is configured. Catch errors before committing. Validate against the current branch worktree — never against `main` or any other branch.
+
+### Commit strategy
+
+Group related fixes into logical commits rather than one commit per comment. Good groupings:
+
+- All nit/style fixes in one commit
+- Fixes in the same file or module together
+- A single complex fix that touches multiple files in its own commit
+
+Commit message format:
+
+```
+fix(review): <concise summary of what changed>
+
+Addresses PR #<number> review feedback:
+- <thread 1 summary>
+- <thread 2 summary>
+```
+
+## Step 5: Reply and resolve threads
+
+After committing the fixes, reply to each addressed thread and then resolve it:
+
+```bash
+# Reply to the thread
+gh api graphql -f query='
+  mutation($threadId: ID!, $body: String!) {
+    addPullRequestReviewThreadReply(input: {pullRequestReviewThreadId: $threadId, body: $body}) {
+      comment { id }
+    }
+  }
+' -f threadId='<thread-id>' -f body='<reply>'
+
+# Resolve the thread
+gh api graphql -f query='
+  mutation($threadId: ID!) {
+    resolvePullRequestReviewThread(input: {threadId: $threadId}) {
+      thread { isResolved }
+    }
+  }
+' -f threadId='<thread-id>'
+```
+
+Reply guidelines:
+
+- For straightforward fixes: `"Fixed — <brief description of what changed>."`
+- For nits: `"Done."`  or `"Fixed, good catch."`
+- For discussion threads you didn't change code for: Draft a substantive reply explaining the reasoning, but **do not resolve** — leave it for the user.
+
+## Step 6: Push
+
+```bash
+git push
+```
+
+If the push is rejected (e.g., remote has new commits), rebase first:
+
+```bash
+git pull --rebase origin <branch-name>
+```
+
+If rebase conflicts arise, stop and tell the user — don't auto-resolve merge conflicts in a PR fix workflow.
+
+## After completion
+
+Summarize what you did:
+
+1. How many threads were fixed and resolved
+2. How many threads were replied to but left open (discussion/questions) — list these so the user can review
+3. How many threads were skipped (praise, already resolved)
+4. The commit SHAs created
+
+If any fixes felt uncertain or the reviewer's intent was ambiguous, call those out explicitly so the user can double-check before the next review round.
+
+## Error handling
+
+- **`gh` not found or not authenticated** — Stop immediately, tell the user to install/auth `gh`.
+- **No open PR for the given branch** — Tell the user; the PR may be closed or merged.
+- **Comment references deleted file** — Reply noting the file no longer exists, skip the fix, don't resolve.
+- **Build fails after a fix** — Revert that commit, note it in the summary, move on to other fixes.
+- **Rate limiting from GitHub API** — Pause and retry with backoff. If persistent, batch remaining replies and tell the user.
+
+---
+
+Source: https://gist.github.com/GSonofNun/35c67304c35dac7d6b43308b5371f671

package/assets/.agent/skills/takomi/SKILL.md

@@ -1,59 +1,59 @@
----
-name: takomi
-description: Unified Takomi protocol skill for Codex. Routes natural-language requests to built-in workflow playbooks in this skill folder (no slash commands required).
----
-
-# Takomi (Unified Skill)
-
-This single skill contains the full non-legacy Takomi workflow suite.
-Use it whenever a user says "use takomi", asks for Vibe Code lifecycle execution, or references any prior workflow names.
-
-## How To Use
-- Natural language is primary. Slash commands are optional and not required.
-- Examples:
-  - `use takomi`
-  - `use takomi genesis`
-  - `run vibe genesis`
-  - `continue build with takomi`
-
-## Router Behavior
-1. Match user intent to one workflow playbook from `workflows/`.
-2. Execute that playbook's protocol.
-3. Recommend the next workflow stage after completion.
-4. Allow explicit user overrides (guided gates, not hard blocks).
-
-## Lifecycle Gates
-- Discover/Prime: `vibe-primeAgent.md`, `reverse_genesis.md`
-- Plan/Design: `vibe-genesis.md`, `vibe-design.md`, `mode-architect.md`, `mode-visionary.md`
-- Build/Continue: `vibe-build.md`, `vibe-continueBuild.md`, `mode-code.md`, `stitch.md`, `remotion-build.md`
-- Review/Finalize: `mode-review.md`, `review_code.md`, `vibe-finalize.md`, `vibe-syncDocs.md`
-- Recovery/Migration: `agent_reset.md`, `escalate.md`, `migrate.md`, `optimize-agent-context.md`, `mode-orchestrator.md`, `mode-debug.md`, `mode-ask.md`, `vibe-spawnTask.md`, `spawn-jstar-code-review.md`
-
-## Workflow Playbooks (Contained In This Skill)
-- `workflows/vibe-genesis.md`
-- `workflows/vibe-design.md`
-- `workflows/vibe-build.md`
-- `workflows/vibe-continueBuild.md`
-- `workflows/vibe-finalize.md`
-- `workflows/vibe-primeAgent.md`
-- `workflows/vibe-spawnTask.md`
-- `workflows/vibe-syncDocs.md`
-- `workflows/reverse_genesis.md`
-- `workflows/mode-orchestrator.md`
-- `workflows/mode-architect.md`
-- `workflows/mode-code.md`
-- `workflows/mode-debug.md`
-- `workflows/mode-ask.md`
-- `workflows/mode-review.md`
-- `workflows/mode-visionary.md`
-- `workflows/review_code.md`
-- `workflows/spawn-jstar-code-review.md`
-- `workflows/agent_reset.md`
-- `workflows/escalate.md`
-- `workflows/migrate.md`
-- `workflows/optimize-agent-context.md`
-- `workflows/stitch.md`
-- `workflows/remotion-build.md`
-
-## Alias Map
-See [references/migration-map.md](references/migration-map.md).
+---
+name: takomi
+description: Unified Takomi protocol skill for Codex. Routes natural-language requests to built-in workflow playbooks in this skill folder (no slash commands required).
+---
+
+# Takomi (Unified Skill)
+
+This single skill contains the full non-legacy Takomi workflow suite.
+Use it whenever a user says "use takomi", asks for Vibe Code lifecycle execution, or references any prior workflow names.
+
+## How To Use
+- Natural language is primary. Slash commands are optional and not required.
+- Examples:
+  - `use takomi`
+  - `use takomi genesis`
+  - `run vibe genesis`
+  - `continue build with takomi`
+
+## Router Behavior
+1. Match user intent to one workflow playbook from `workflows/`.
+2. Execute that playbook's protocol.
+3. Recommend the next workflow stage after completion.
+4. Allow explicit user overrides (guided gates, not hard blocks).
+
+## Lifecycle Gates
+- Discover/Prime: `vibe-primeAgent.md`, `reverse_genesis.md`
+- Plan/Design: `vibe-genesis.md`, `vibe-design.md`, `mode-architect.md`, `mode-visionary.md`
+- Build/Continue: `vibe-build.md`, `vibe-continueBuild.md`, `mode-code.md`, `stitch.md`, `remotion-build.md`
+- Review/Finalize: `mode-review.md`, `review_code.md`, `vibe-finalize.md`, `vibe-syncDocs.md`
+- Recovery/Migration: `agent_reset.md`, `escalate.md`, `migrate.md`, `optimize-agent-context.md`, `mode-orchestrator.md`, `mode-debug.md`, `mode-ask.md`, `vibe-spawnTask.md`, `spawn-jstar-code-review.md`
+
+## Workflow Playbooks (Contained In This Skill)
+- `workflows/vibe-genesis.md`
+- `workflows/vibe-design.md`
+- `workflows/vibe-build.md`
+- `workflows/vibe-continueBuild.md`
+- `workflows/vibe-finalize.md`
+- `workflows/vibe-primeAgent.md`
+- `workflows/vibe-spawnTask.md`
+- `workflows/vibe-syncDocs.md`
+- `workflows/reverse_genesis.md`
+- `workflows/mode-orchestrator.md`
+- `workflows/mode-architect.md`
+- `workflows/mode-code.md`
+- `workflows/mode-debug.md`
+- `workflows/mode-ask.md`
+- `workflows/mode-review.md`
+- `workflows/mode-visionary.md`
+- `workflows/review_code.md`
+- `workflows/spawn-jstar-code-review.md`
+- `workflows/agent_reset.md`
+- `workflows/escalate.md`
+- `workflows/migrate.md`
+- `workflows/optimize-agent-context.md`
+- `workflows/stitch.md`
+- `workflows/remotion-build.md`
+
+## Alias Map
+See [references/migration-map.md](references/migration-map.md).

package/package.json

@@ -1,42 +1,59 @@
-{
-  "name": "takomi",
-  "version": "2.0.6",
-  "description": "🎯 Stop wrestling with AI. Start building with purpose. The artisan's toolkit that transforms AI from chatbot to development partner.",
-  "type": "module",
-  "bin": {
-    "takomi": "./bin/takomi.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "assets"
-  ],
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/JStaRFilms/VibeCode-Protocol-Suite.git"
-  },
-  "keywords": [
-    "takomi",
-    "ai",
-    "vibecode",
-    "cursor",
-    "windsurf",
-    "protocols"
-  ],
-  "author": "J StaR Films Studios",
-  "license": "ISC",
-  "dependencies": {
-    "commander": "^13.1.0",
-    "figlet": "^1.8.0",
-    "fs-extra": "^11.3.0",
-    "picocolors": "^1.1.1",
-    "prompts": "^2.4.2"
-  },
-  "bugs": {
-    "url": "https://github.com/JStaRFilms/VibeCode-Protocol-Suite/issues"
-  },
-  "homepage": "https://github.com/JStaRFilms/VibeCode-Protocol-Suite#readme"
+{
+  "name": "takomi",
+  "version": "2.1.0",
+  "description": "🎯 Stop wrestling with AI. Start building with purpose. The artisan's toolkit for agent workflows, Codex skills, and original Takomi capabilities like 21st.dev integration.",
+  "type": "module",
+  "bin": {
+    "takomi": "./bin/takomi.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "assets",
+    ".pi/README.md",
+    ".pi/agents",
+    ".pi/extensions",
+    ".pi/prompts",
+    ".pi/themes"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JStaRFilms/VibeCode-Protocol-Suite.git"
+  },
+  "keywords": [
+    "takomi",
+    "ai",
+    "skills",
+    "codex",
+    "agentic",
+    "21st.dev",
+    "vibecode",
+    "cursor",
+    "windsurf",
+    "protocols"
+  ],
+  "author": "J StaR Films Studios",
+  "license": "ISC",
+  "dependencies": {
+    "commander": "^13.1.0",
+    "figlet": "^1.8.0",
+    "fs-extra": "^11.3.0",
+    "pi-subagents": "^0.24.0",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "bugs": {
+    "url": "https://github.com/JStaRFilms/VibeCode-Protocol-Suite/issues"
+  },
+  "homepage": "https://github.com/JStaRFilms/VibeCode-Protocol-Suite#readme",
+  "devDependencies": {
+    "@mariozechner/pi-ai": "^0.70.2",
+    "@mariozechner/pi-coding-agent": "^0.70.2",
+    "@types/node": "^25.5.2",
+    "typebox": "^1.1.33",
+    "typescript": "^6.0.2"
+  }
 }

package/src/cli.js

@@ -15,6 +15,7 @@ import {
   copyAgentReadme,
   copyAgentYamls,
   copyLegacyManual,
+  copyBundledPiAssets,
   updateWorkflows,
   updateSkills,
   updateAgentYamls,
@@ -39,6 +40,10 @@ import {
   getStoreWorkflows,
   isStoreInitialized,
 } from './store.js';
+import { runDoctor } from './doctor.js';
+import { ensurePiInstalled, ensurePiSubagentsInstalled, launchTakomiHarness, printPiInstallResult, printPiSubagentsInstallResult } from './pi-harness.js';
+import { installPiHarnessAssets, printPiInstallSummary, syncPiHarnessAssets, validatePiHarnessInstall } from './pi-installer.js';
+import { installBundledSkills, printSkillsInstallSummary, validateSkillsInstall } from './skills-installer.js';
 
 const program = new Command();
 
@@ -124,6 +129,10 @@ async function init() {
     // 0. Install from local assets
     console.log(pc.cyan('📦 Installing from local bundle...\n'));
 
+    if (await copyBundledPiAssets(destRoot)) {
+      console.log(pc.green('✔ Installed Pi-native Takomi runtime (.pi).'));
+    }
+
     // 1. Handle .agent Folder
     if (response.components.includes('agent')) {
       const agentDest = path.join(destRoot, '.agent');
@@ -160,11 +169,11 @@ async function init() {
       // Handle Skills
       if (response.skillMode === 'core') {
         console.log(pc.green('✔ Downloading Core Skills...'));
-        const coreSkills = [
-          'takomi',
-          'ai-sdk', 'code-review', 'component-analysis',
-          'nextjs-standards', 'security-audit', 'spawn-task',
-          'stitch', 'sync-docs'
+        const coreSkills = [
+          'takomi',
+          'ai-sdk', 'code-review', 'component-analysis',
+          'nextjs-standards', 'security-audit', 'spawn-task',
+          'stitch', 'sync-docs'
         ];
         await copySpecificSkills(coreSkills, skillsDest);
       } else if (response.skillMode === 'all') {
@@ -197,7 +206,8 @@ async function init() {
     console.log(pc.white(`\nNext steps:`));
     if (response.components.includes('agent')) {
       console.log(pc.gray(`1. Your .agent folder is armed and ready.`));
-      console.log(pc.gray(`2. In Codex, say "use takomi genesis" (slash command optional).`));
+      console.log(pc.gray(`2. Your Pi-native .pi Takomi runtime is installed.`));
+      console.log(pc.gray(`3. In Codex, say "use takomi genesis" (slash command optional).`));
     }
     console.log(pc.dim(`\n💡 Pro tip: Run "takomi install" to sync this toolkit across all your IDEs.\n`));
 
@@ -206,11 +216,125 @@ async function init() {
   }
 }
 
+async function installSkillsTarget() {
+  console.log(pc.magenta('🧰 Takomi Skills Install\n'));
+  try {
+    const result = await installBundledSkills(program.version());
+    const validation = await validateSkillsInstall();
+    printSkillsInstallSummary(result, validation);
+    console.log(pc.dim('\nGlobal skills are ready for Pi or other supported harnesses.\n'));
+  } catch (error) {
+    console.log(pc.red('\nSkills install failed.'));
+    console.log(pc.dim(String(error?.message || error)));
+  }
+}
+
+async function installAllTargets() {
+  await installPiTarget();
+  await installSkillsTarget();
+}
+
+async function installPiTarget() {
+  console.log(pc.magenta('🧭 Pi Harness Preflight\n'));
+  const report = await runDoctor({ version: program.version() });
+
+  if (!report.pi.installed) {
+    console.log(pc.cyan('\n📦 Installing Pi...\n'));
+    const installResult = await ensurePiInstalled();
+    printPiInstallResult(installResult);
+    if (!installResult.ok) {
+      console.log(pc.yellow('\nPi harness install stopped because Pi could not be installed.'));
+      console.log(pc.dim('Retry manually with: npm install -g @mariozechner/pi-coding-agent\n'));
+      return;
+    }
+  }
+
+  if (!report.piSubagents.localInstalled && !report.piSubagents.globalInstalled) {
+    console.log(pc.cyan('\n📦 Installing pi-subagents...\n'));
+    const installResult = await ensurePiSubagentsInstalled();
+    printPiSubagentsInstallResult(installResult);
+    if (!installResult.ok) {
+      console.log(pc.yellow('\nPi harness install stopped because pi-subagents could not be installed.'));
+      console.log(pc.dim('Retry manually with: npm install -g pi-subagents\n'));
+      return;
+    }
+  }
+
+  console.log(pc.cyan('\n📦 Installing Takomi Pi harness assets...\n'));
+  try {
+    const result = await installPiHarnessAssets(program.version());
+    const validation = await validatePiHarnessInstall();
+    printPiInstallSummary(result, validation);
+    console.log(pc.dim('\nNext: cd <project> && takomi\n'));
+  } catch (error) {
+    console.log(pc.red('\nPi harness asset install failed.'));
+    console.log(pc.dim(String(error?.message || error)));
+  }
+}
+
+async function syncPiTarget() {
+  console.log(pc.magenta('📡 Takomi Pi Sync\n'));
+  try {
+    const result = await syncPiHarnessAssets(program.version());
+    const validation = await validatePiHarnessInstall();
+    printPiInstallSummary(result, validation);
+  } catch (error) {
+    console.log(pc.red('\nPi sync failed.'));
+    console.log(pc.dim(String(error?.message || error)));
+  }
+}
+
+async function syncSkillsTarget() {
+  console.log(pc.magenta('📡 Takomi Skills Sync\n'));
+  try {
+    const result = await installBundledSkills(program.version());
+    const validation = await validateSkillsInstall();
+    printSkillsInstallSummary(result, validation);
+  } catch (error) {
+    console.log(pc.red('\nSkills sync failed.'));
+    console.log(pc.dim(String(error?.message || error)));
+  }
+}
+
+async function syncAllTargets() {
+  await syncPiTarget();
+  await syncSkillsTarget();
+}
+
+function printUnsupportedInstallTarget(target) {
+  console.log(pc.yellow(`Unsupported install target: ${target}`));
+  console.log(pc.dim('Supported targets right now: pi, skills, all'));
+  console.log(pc.dim('Use plain "takomi install" for the existing interactive global installer.\n'));
+}
+
+function printUnsupportedSyncTarget(target) {
+  console.log(pc.yellow(`Unsupported sync target: ${target}`));
+  console.log(pc.dim('Supported targets right now: pi, skills, all'));
+  console.log(pc.dim('Use plain "takomi sync" for the existing interactive global sync.\n'));
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // takomi install (NEW — Global Setup + Harness Routing)
 // ─────────────────────────────────────────────────────────────────────────────
 
-async function install() {
+async function install(target) {
+  if (target) {
+    if (target === 'pi') {
+      await installPiTarget();
+      return;
+    }
+    if (target === 'skills') {
+      await installSkillsTarget();
+      return;
+    }
+    if (target === 'all') {
+      await installAllTargets();
+      return;
+    }
+
+    printUnsupportedInstallTarget(target);
+    return;
+  }
   console.log(pc.magenta(figlet.textSync('Takomi', { horizontalLayout: 'full' })));
   console.log(pc.cyan('   🌐 One install. Every IDE. Zero friction.\n'));
 
@@ -220,7 +344,7 @@ async function install() {
 
   if (detected.length === 0) {
     console.log(pc.yellow('  No AI harnesses detected on this machine.'));
-    console.log(pc.dim('  We support: Antigravity, KiloCode, Windsurf, Cursor, Gemini CLI'));
+    console.log(pc.dim('  We support: Antigravity, KiloCode, Windsurf, Codex, Cursor, Gemini CLI'));
     console.log(pc.dim('  Run "takomi init" instead for per-project setup.\n'));
     return;
   }
@@ -359,7 +483,23 @@ async function install() {
 // takomi sync (NEW — Re-sync store to all harnesses)
 // ─────────────────────────────────────────────────────────────────────────────
 
-async function sync() {
+async function sync(target) {
+  if (target) {
+    if (target === 'pi') {
+      await syncPiTarget();
+      return;
+    }
+    if (target === 'skills') {
+      await syncSkillsTarget();
+      return;
+    }
+    if (target === 'all') {
+      await syncAllTargets();
+      return;
+    }
+    printUnsupportedSyncTarget(target);
+    return;
+  }
   console.log(pc.magenta('📡 Syncing your toolkit to all connected IDEs...\n'));
 
   // Check if global store exists
@@ -535,7 +675,7 @@ async function harnesses() {
 program
   .name('takomi')
   .description('Your AI team. Activated. 🎯')
-  .version('2.0.0');
+  .version('2.0.7');
 
 // Per-project setup (backward compatible)
 program
@@ -545,14 +685,14 @@ program
 
 // Global installer (NEW)
 program
-  .command('install')
-  .description('Build your global command center')
+  .command('install [target]')
+  .description('Build your global command center or run a target-specific installer')
   .action(install);
 
 // Re-sync (NEW)
 program
-  .command('sync')
-  .description('Push updates to all connected IDEs')
+  .command('sync [target]')
+  .description('Push updates to all connected IDEs or sync a target-specific install')
   .action(sync);
 
 // Add remote skills (NEW)
@@ -567,6 +707,11 @@ program
   .description('See your toolkit status and connected IDEs')
   .action(harnesses);
 
+program
+  .command('doctor')
+  .description('Run Pi/Takomi installation diagnostics')
+  .action(() => runDoctor({ version: program.version() }));
+
 // Update from GitHub (EXISTING — enhanced)
 program
   .command('update')
@@ -636,4 +781,9 @@ program
     console.log(pc.magenta('\n✨ Your toolkit is fresh and ready to ship.'));
   });
 
-program.parse();
+if (process.argv.length <= 2) {
+  const exitCode = await launchTakomiHarness(process.cwd());
+  process.exitCode = exitCode;
+} else {
+  program.parse();
+}