uloop-cli 0.45.0 → 0.46.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uloop-cli",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "//version": "x-release-please-version",
   "description": "CLI tool for Unity Editor communication via uLoopMCP",
   "main": "dist/cli.bundle.cjs",
@@ -41,12 +41,14 @@
     "provenance": true
   },
   "dependencies": {
-    "commander": "^14.0.2"
+    "commander": "^14.0.2",
+    "semver": "^7.7.3"
   },
   "devDependencies": {
     "@eslint/js": "9.39.2",
     "@types/jest": "30.0.0",
     "@types/node": "25.0.2",
+    "@types/semver": "^7.7.1",
     "esbuild": "0.27.1",
     "eslint": "9.39.2",
     "eslint-config-prettier": "^10.1.8",

package/src/default-tools.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.45.0",
+  "version": "0.46.0",
   "tools": [
     {
       "name": "compile",

package/src/execute-tool.ts

@@ -10,6 +10,7 @@
 import * as readline from 'readline';
 import { existsSync } from 'fs';
 import { join } from 'path';
+import * as semver from 'semver';
 import { DirectUnityClient } from './direct-unity-client.js';
 import { resolveUnityPort } from './port-resolver.js';
 import { saveToolsCache, getCacheFilePath, ToolsCache, ToolDefinition } from './tool-cache.js';
@@ -70,6 +71,52 @@ function isRetryableError(error: unknown): boolean {
   return message.includes('ECONNREFUSED') || message === 'UNITY_NO_RESPONSE';
 }
 
+/**
+ * Compare two semantic versions safely.
+ * Returns true if v1 < v2, false otherwise.
+ * Falls back to string comparison if versions are invalid.
+ */
+function isVersionOlder(v1: string, v2: string): boolean {
+  const parsed1 = semver.valid(v1);
+  const parsed2 = semver.valid(v2);
+
+  if (parsed1 && parsed2) {
+    return semver.lt(parsed1, parsed2);
+  }
+
+  return v1 < v2;
+}
+
+/**
+ * Print version mismatch warning to stderr.
+ * Does not block execution - just warns the user.
+ */
+function printVersionWarning(cliVersion: string, serverVersion: string): void {
+  const isCliOlder = isVersionOlder(cliVersion, serverVersion);
+  const updateCommand = isCliOlder
+    ? `npm install -g uloop-cli@${serverVersion}`
+    : `Update uLoopMCP package to ${cliVersion} via Unity Package Manager`;
+
+  console.error('\x1b[33m⚠️ Version mismatch detected!\x1b[0m');
+  console.error(`   uloop-cli version:    ${cliVersion}`);
+  console.error(`   uloop server version: ${serverVersion}`);
+  console.error('');
+  console.error('   This may cause unexpected behavior or errors.');
+  console.error('');
+  console.error(`   ${isCliOlder ? 'To update CLI:' : 'To update server:'} ${updateCommand}`);
+  console.error('');
+}
+
+/**
+ * Check server version from response and print warning if mismatched.
+ */
+function checkServerVersion(result: Record<string, unknown>): void {
+  const serverVersion = result['ULoopServerVersion'] as string | undefined;
+  if (serverVersion && serverVersion !== VERSION) {
+    printVersionWarning(VERSION, serverVersion);
+  }
+}
+
 /**
  * Check if Unity is in a busy state (compiling, reloading, or server starting).
  * Throws an error with appropriate message if busy.
@@ -123,7 +170,7 @@ export async function executeToolCommand(
       await client.connect();
 
       spinner.update(`Executing ${toolName}...`);
-      const result = await client.sendRequest(toolName, params);
+      const result = await client.sendRequest<Record<string, unknown>>(toolName, params);
 
       if (result === undefined || result === null) {
         throw new Error('UNITY_NO_RESPONSE');
@@ -132,6 +179,10 @@ export async function executeToolCommand(
       // Success - stop spinner and output result
       spinner.stop();
       restoreStdin();
+
+      // Check server version and warn if mismatched
+      checkServerVersion(result);
+
       console.log(JSON.stringify(result, null, 2));
       return;
     } catch (error) {

package/src/skills/skills-command.ts

@@ -13,53 +13,114 @@ import {
   getInstallDir,
   getTotalSkillCount,
 } from './skills-manager.js';
+import { TargetConfig, ALL_TARGET_IDS, getTargetConfig } from './target-config.js';
+
+interface SkillsOptions {
+  global?: boolean;
+  claude?: boolean;
+  codex?: boolean;
+}
 
 export function registerSkillsCommand(program: Command): void {
-  const skillsCmd = program.command('skills').description('Manage uloop skills for Claude Code');
+  const skillsCmd = program
+    .command('skills')
+    .description('Manage uloop skills for AI coding tools');
 
   skillsCmd
     .command('list')
     .description('List all uloop skills and their installation status')
-    .option('-g, --global', 'Check global installation (~/.claude/skills/)')
-    .action((options: { global?: boolean }) => {
-      listSkills(options.global ?? false);
+    .option('-g, --global', 'Check global installation')
+    .option('--claude', 'Check Claude Code installation')
+    .option('--codex', 'Check Codex CLI installation')
+    .action((options: SkillsOptions) => {
+      const targets = resolveTargets(options);
+      const global = options.global ?? false;
+      listSkills(targets, global);
     });
 
   skillsCmd
     .command('install')
     .description('Install all uloop skills')
-    .option('-g, --global', 'Install to global location (~/.claude/skills/)')
-    .action((options: { global?: boolean }) => {
-      installSkills(options.global ?? false);
+    .option('-g, --global', 'Install to global location')
+    .option('--claude', 'Install to Claude Code')
+    .option('--codex', 'Install to Codex CLI')
+    .action((options: SkillsOptions) => {
+      const targets = resolveTargets(options);
+      if (targets.length === 0) {
+        showTargetGuidance('install');
+        return;
+      }
+      installSkills(targets, options.global ?? false);
     });
 
   skillsCmd
     .command('uninstall')
     .description('Uninstall all uloop skills')
-    .option('-g, --global', 'Uninstall from global location (~/.claude/skills/)')
-    .action((options: { global?: boolean }) => {
-      uninstallSkills(options.global ?? false);
+    .option('-g, --global', 'Uninstall from global location')
+    .option('--claude', 'Uninstall from Claude Code')
+    .option('--codex', 'Uninstall from Codex CLI')
+    .action((options: SkillsOptions) => {
+      const targets = resolveTargets(options);
+      if (targets.length === 0) {
+        showTargetGuidance('uninstall');
+        return;
+      }
+      uninstallSkills(targets, options.global ?? false);
     });
 }
 
-function listSkills(global: boolean): void {
+function resolveTargets(options: SkillsOptions): TargetConfig[] {
+  const targets: TargetConfig[] = [];
+  if (options.claude) {
+    targets.push(getTargetConfig('claude'));
+  }
+  if (options.codex) {
+    targets.push(getTargetConfig('codex'));
+  }
+  return targets;
+}
+
+function showTargetGuidance(command: string): void {
+  console.log(`\nPlease specify at least one target for '${command}':`);
+  console.log('');
+  console.log('Available targets:');
+  console.log('  --claude   Claude Code (.claude/skills/)');
+  console.log('  --codex    Codex CLI (.codex/skills/)');
+  console.log('');
+  console.log('Options:');
+  console.log('  -g, --global   Use global location (~/.claude/ or ~/.codex/)');
+  console.log('');
+  console.log('Examples:');
+  console.log(`  uloop skills ${command} --claude`);
+  console.log(`  uloop skills ${command} --codex --global`);
+  console.log(`  uloop skills ${command} --claude --codex`);
+}
+
+function listSkills(targets: TargetConfig[], global: boolean): void {
   const location = global ? 'Global' : 'Project';
-  const dir = getInstallDir(global);
+  const targetConfigs = targets.length > 0 ? targets : ALL_TARGET_IDS.map(getTargetConfig);
 
-  console.log(`\nuloop Skills Status (${location}):`);
-  console.log(`Location: ${dir}`);
-  console.log('='.repeat(50));
+  console.log(`\nuloop Skills Status:`);
   console.log('');
 
-  const statuses = getAllSkillStatuses(global);
+  for (const target of targetConfigs) {
+    const dir = getInstallDir(target, global);
+
+    console.log(`${target.displayName} (${location}):`);
+    console.log(`Location: ${dir}`);
+    console.log('='.repeat(50));
+
+    const statuses = getAllSkillStatuses(target, global);
 
-  for (const skill of statuses) {
-    const icon = getStatusIcon(skill.status);
-    const statusText = getStatusText(skill.status);
-    console.log(`  ${icon} ${skill.name} (${statusText})`);
+    for (const skill of statuses) {
+      const icon = getStatusIcon(skill.status);
+      const statusText = getStatusText(skill.status);
+      console.log(`  ${icon} ${skill.name} (${statusText})`);
+    }
+
+    console.log('');
   }
 
-  console.log('');
   console.log(`Total: ${getTotalSkillCount()} bundled skills`);
 }
 
@@ -89,33 +150,39 @@ function getStatusText(status: string): string {
   }
 }
 
-function installSkills(global: boolean): void {
+function installSkills(targets: TargetConfig[], global: boolean): void {
   const location = global ? 'global' : 'project';
-  const dir = getInstallDir(global);
 
   console.log(`\nInstalling uloop skills (${location})...`);
   console.log('');
 
-  const result = installAllSkills(global);
+  for (const target of targets) {
+    const dir = getInstallDir(target, global);
+    const result = installAllSkills(target, global);
 
-  console.log(`\x1b[32m✓\x1b[0m Installed: ${result.installed}`);
-  console.log(`\x1b[33m↑\x1b[0m Updated: ${result.updated}`);
-  console.log(`\x1b[90m-\x1b[0m Skipped (up-to-date): ${result.skipped}`);
-  console.log('');
-  console.log(`Skills installed to ${dir}`);
+    console.log(`${target.displayName}:`);
+    console.log(`  \x1b[32m✓\x1b[0m Installed: ${result.installed}`);
+    console.log(`  \x1b[33m↑\x1b[0m Updated: ${result.updated}`);
+    console.log(`  \x1b[90m-\x1b[0m Skipped (up-to-date): ${result.skipped}`);
+    console.log(`  Location: ${dir}`);
+    console.log('');
+  }
 }
 
-function uninstallSkills(global: boolean): void {
+function uninstallSkills(targets: TargetConfig[], global: boolean): void {
   const location = global ? 'global' : 'project';
-  const dir = getInstallDir(global);
 
   console.log(`\nUninstalling uloop skills (${location})...`);
   console.log('');
 
-  const result = uninstallAllSkills(global);
+  for (const target of targets) {
+    const dir = getInstallDir(target, global);
+    const result = uninstallAllSkills(target, global);
 
-  console.log(`\x1b[31m✗\x1b[0m Removed: ${result.removed}`);
-  console.log(`\x1b[90m-\x1b[0m Not found: ${result.notFound}`);
-  console.log('');
-  console.log(`Skills removed from ${dir}`);
+    console.log(`${target.displayName}:`);
+    console.log(`  \x1b[31m✗\x1b[0m Removed: ${result.removed}`);
+    console.log(`  \x1b[90m-\x1b[0m Not found: ${result.notFound}`);
+    console.log(`  Location: ${dir}`);
+    console.log('');
+  }
 }

package/src/skills/skills-manager.ts

@@ -9,6 +9,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import { BUNDLED_SKILLS, BundledSkill } from './bundled-skills.js';
+import { TargetConfig } from './target-config.js';
 
 export type SkillStatus = 'installed' | 'not_installed' | 'outdated';
 
@@ -18,26 +19,26 @@ export interface SkillInfo {
   path?: string;
 }
 
-function getGlobalSkillsDir(): string {
-  return join(homedir(), '.claude', 'skills');
+function getGlobalSkillsDir(target: TargetConfig): string {
+  return join(homedir(), target.projectDir, 'skills');
 }
 
-function getProjectSkillsDir(): string {
-  return join(process.cwd(), '.claude', 'skills');
+function getProjectSkillsDir(target: TargetConfig): string {
+  return join(process.cwd(), target.projectDir, 'skills');
 }
 
-function getSkillPath(skillDirName: string, global: boolean): string {
-  const baseDir = global ? getGlobalSkillsDir() : getProjectSkillsDir();
-  return join(baseDir, skillDirName, 'SKILL.md');
+function getSkillPath(skillDirName: string, target: TargetConfig, global: boolean): string {
+  const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
+  return join(baseDir, skillDirName, target.skillFileName);
 }
 
-function isSkillInstalled(skill: BundledSkill, global: boolean): boolean {
-  const skillPath = getSkillPath(skill.dirName, global);
+function isSkillInstalled(skill: BundledSkill, target: TargetConfig, global: boolean): boolean {
+  const skillPath = getSkillPath(skill.dirName, target, global);
   return existsSync(skillPath);
 }
 
-function isSkillOutdated(skill: BundledSkill, global: boolean): boolean {
-  const skillPath = getSkillPath(skill.dirName, global);
+function isSkillOutdated(skill: BundledSkill, target: TargetConfig, global: boolean): boolean {
+  const skillPath = getSkillPath(skill.dirName, target, global);
   if (!existsSync(skillPath)) {
     return false;
   }
@@ -45,35 +46,45 @@ function isSkillOutdated(skill: BundledSkill, global: boolean): boolean {
   return installedContent !== skill.content;
 }
 
-export function getSkillStatus(skill: BundledSkill, global: boolean): SkillStatus {
-  if (!isSkillInstalled(skill, global)) {
+export function getSkillStatus(
+  skill: BundledSkill,
+  target: TargetConfig,
+  global: boolean,
+): SkillStatus {
+  if (!isSkillInstalled(skill, target, global)) {
     return 'not_installed';
   }
-  if (isSkillOutdated(skill, global)) {
+  if (isSkillOutdated(skill, target, global)) {
     return 'outdated';
   }
   return 'installed';
 }
 
-export function getAllSkillStatuses(global: boolean): SkillInfo[] {
+export function getAllSkillStatuses(target: TargetConfig, global: boolean): SkillInfo[] {
   return BUNDLED_SKILLS.map((skill) => ({
     name: skill.name,
-    status: getSkillStatus(skill, global),
-    path: isSkillInstalled(skill, global) ? getSkillPath(skill.dirName, global) : undefined,
+    status: getSkillStatus(skill, target, global),
+    path: isSkillInstalled(skill, target, global)
+      ? getSkillPath(skill.dirName, target, global)
+      : undefined,
   }));
 }
 
-export function installSkill(skill: BundledSkill, global: boolean): void {
-  const baseDir = global ? getGlobalSkillsDir() : getProjectSkillsDir();
+export function installSkill(skill: BundledSkill, target: TargetConfig, global: boolean): void {
+  const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
   const skillDir = join(baseDir, skill.dirName);
-  const skillPath = join(skillDir, 'SKILL.md');
+  const skillPath = join(skillDir, target.skillFileName);
 
   mkdirSync(skillDir, { recursive: true });
   writeFileSync(skillPath, skill.content, 'utf-8');
 }
 
-export function uninstallSkill(skill: BundledSkill, global: boolean): boolean {
-  const baseDir = global ? getGlobalSkillsDir() : getProjectSkillsDir();
+export function uninstallSkill(
+  skill: BundledSkill,
+  target: TargetConfig,
+  global: boolean,
+): boolean {
+  const baseDir = global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
   const skillDir = join(baseDir, skill.dirName);
 
   if (!existsSync(skillDir)) {
@@ -90,17 +101,17 @@ export interface InstallResult {
   skipped: number;
 }
 
-export function installAllSkills(global: boolean): InstallResult {
+export function installAllSkills(target: TargetConfig, global: boolean): InstallResult {
   const result: InstallResult = { installed: 0, updated: 0, skipped: 0 };
 
   for (const skill of BUNDLED_SKILLS) {
-    const status = getSkillStatus(skill, global);
+    const status = getSkillStatus(skill, target, global);
 
     if (status === 'not_installed') {
-      installSkill(skill, global);
+      installSkill(skill, target, global);
       result.installed++;
     } else if (status === 'outdated') {
-      installSkill(skill, global);
+      installSkill(skill, target, global);
       result.updated++;
     } else {
       result.skipped++;
@@ -115,11 +126,11 @@ export interface UninstallResult {
   notFound: number;
 }
 
-export function uninstallAllSkills(global: boolean): UninstallResult {
+export function uninstallAllSkills(target: TargetConfig, global: boolean): UninstallResult {
   const result: UninstallResult = { removed: 0, notFound: 0 };
 
   for (const skill of BUNDLED_SKILLS) {
-    if (uninstallSkill(skill, global)) {
+    if (uninstallSkill(skill, target, global)) {
       result.removed++;
     } else {
       result.notFound++;
@@ -129,8 +140,8 @@ export function uninstallAllSkills(global: boolean): UninstallResult {
   return result;
 }
 
-export function getInstallDir(global: boolean): string {
-  return global ? getGlobalSkillsDir() : getProjectSkillsDir();
+export function getInstallDir(target: TargetConfig, global: boolean): string {
+  return global ? getGlobalSkillsDir(target) : getProjectSkillsDir(target);
 }
 
 export function getTotalSkillCount(): number {

package/src/skills/target-config.ts

@@ -0,0 +1,34 @@
+/**
+ * Target configuration for multi-AI tool support.
+ * Supports Claude Code and Codex CLI, with extensibility for future targets.
+ */
+
+export type TargetId = 'claude' | 'codex';
+
+export interface TargetConfig {
+  id: TargetId;
+  displayName: string;
+  projectDir: string;
+  skillFileName: string;
+}
+
+export const TARGET_CONFIGS: Record<TargetId, TargetConfig> = {
+  claude: {
+    id: 'claude',
+    displayName: 'Claude Code',
+    projectDir: '.claude',
+    skillFileName: 'SKILL.md',
+  },
+  codex: {
+    id: 'codex',
+    displayName: 'Codex CLI',
+    projectDir: '.codex',
+    skillFileName: 'SKILL.md',
+  },
+};
+
+export const ALL_TARGET_IDS: TargetId[] = ['claude', 'codex'];
+
+export function getTargetConfig(id: TargetId): TargetConfig {
+  return TARGET_CONFIGS[id];
+}

package/src/version.ts

@@ -4,4 +4,4 @@
  * This file exists to avoid bundling the entire package.json into the CLI bundle.
  * This version is automatically updated by release-please.
  */
-export const VERSION = '0.45.0'; // x-release-please-version
+export const VERSION = '0.46.0'; // x-release-please-version