auriga-cli 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+English | [中文](README.zh-CN.md)
+
+# auriga-cli
+
+A modular Claude Code harness — install only the parts you need.
+
+This repo itself is a fully configured harness project. You can clone it to see the full setup, or use the CLI to install individual modules into your own project.
+
+## What's Included
+
+| Module | Description |
+|---|---|
+| **Workflow** | `CLAUDE.md` development workflow: requirement clarification -> TDD -> Review, Harness principles, Subagent usage guide |
+| **Skills** | Development process skills — brainstorming, systematic-debugging, TDD, verification, planning, playwright |
+| **Plugins** | Recommended Claude Code plugins — skill-creator, claude-md-management, hookify, codex |
+
+## Quick Start
+
+```bash
+npx auriga-cli
+```
+
+Interactive menu — select what to install:
+
+```
+? Select module types to install:
+  ◉ Workflow — CLAUDE.md + AGENTS.md
+  ◉ Skills — Development process skills
+  ◉ Plugins — Claude Code plugins
+```
+
+Each module supports scope selection (Skills: project/global, Plugins: user/project).
+
+## Module Details
+
+### Workflow
+
+Copies `CLAUDE.md` to the target project and creates an `AGENTS.md` symlink for compatibility with different Agent frameworks. Supports English and Chinese — you choose during installation.
+
+- Backs up existing `CLAUDE.md` before overwriting
+- Covers: requirement clarification, TDD, code review, branch workflow, subagent orchestration
+
+### Skills
+
+Installs selected skills via `npx skills add`, targeting both Claude Code and Codex.
+
+| Skill | Source | Description |
+|---|---|---|
+| brainstorming | [obra/superpowers](https://github.com/obra/superpowers) | Requirement clarification and design exploration |
+| systematic-debugging | [obra/superpowers](https://github.com/obra/superpowers) | Systematic debugging — find root cause before fixing |
+| test-driven-development | [obra/superpowers](https://github.com/obra/superpowers) | Test-driven development workflow |
+| verification-before-completion | [obra/superpowers](https://github.com/obra/superpowers) | Pre-completion verification — evidence before assertions |
+| planning-with-files | [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files) | File-based task planning and progress tracking |
+| playwright-cli | [microsoft/playwright-cli](https://github.com/microsoft/playwright-cli) | Browser automation and testing |
+| ui-ux-pro-max | [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) | UI/UX design and development enhancement |
+
+Supports both project and global installation scopes.
+
+### Plugins
+
+Installs selected plugins via `claude plugins install`, automatically adding required marketplaces.
+
+| Plugin | Description |
+|---|---|
+| skill-creator | Create and manage custom skills |
+| claude-md-management | Audit and improve CLAUDE.md |
+| hookify | Create hooks from conversation analysis |
+| codex | Codex cross-model collaboration |
+
+## Requirements
+
+- Node.js >= 18
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (required for Plugins module)
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,77 @@
+[English](README.md) | 中文
+
+# auriga-cli
+
+模块化的 Claude Code harness —— 按需选装你需要的部分。
+
+这个仓库本身就是一个完整配置好的 harness 项目。可以直接 clone 查看完整配置，也可以用 CLI 把各模块安装到你自己的项目中。
+
+## 包含什么
+
+| 模块 | 说明 |
+|---|---|
+| **Workflow** | `CLAUDE.md` 开发工作流：需求澄清 → TDD → Review，Harness 原则，Subagent 使用指南 |
+| **Skills** | 开发流程 skills —— brainstorming、systematic-debugging、TDD、verification、planning、playwright |
+| **Plugins** | 推荐的 Claude Code 插件 —— skill-creator、claude-md-management、hookify、codex |
+
+## 快速开始
+
+```bash
+npx auriga-cli
+```
+
+交互式菜单，按需选择安装：
+
+```
+? 选择要安装的模块类型：
+  ◉ Workflow — CLAUDE.md + AGENTS.md
+  ◉ Skills — 开发流程 skills
+  ◉ Plugins — Claude Code 插件
+```
+
+每个模块支持作用域选择（Skills: project/global，Plugins: user/project）。
+
+## 模块详情
+
+### Workflow
+
+将 `CLAUDE.md` 复制到目标项目，并创建 `AGENTS.md` 软链接以兼容不同 Agent 框架。支持中英文版本，安装时可选择。
+
+- 目标已有 `CLAUDE.md` 时会自动备份后覆盖
+- 涵盖：需求澄清、TDD、代码 Review、分支工作流、Subagent 编排
+
+### Skills
+
+通过 `npx skills add` 逐个安装选中的 skills，同时安装到 Claude Code 和 Codex。
+
+| Skill | 来源 | 说明 |
+|---|---|---|
+| brainstorming | [obra/superpowers](https://github.com/obra/superpowers) | 需求澄清与设计探索 |
+| systematic-debugging | [obra/superpowers](https://github.com/obra/superpowers) | 系统化调试，先找根因再修复 |
+| test-driven-development | [obra/superpowers](https://github.com/obra/superpowers) | 测试驱动开发流程 |
+| verification-before-completion | [obra/superpowers](https://github.com/obra/superpowers) | 完成前验证，用证据说话 |
+| planning-with-files | [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files) | 文件化任务计划与进度跟踪 |
+| playwright-cli | [microsoft/playwright-cli](https://github.com/microsoft/playwright-cli) | 浏览器自动化与测试 |
+| ui-ux-pro-max | [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) | UI/UX 设计与开发增强 |
+
+支持 project 和 global 两种安装范围。
+
+### Plugins
+
+通过 `claude plugins install` 安装选中的插件，自动添加所需的 marketplace。
+
+| 插件 | 说明 |
+|---|---|
+| skill-creator | 创建和管理自定义 skills |
+| claude-md-management | 审计和改进 CLAUDE.md |
+| hookify | 从对话分析创建 hooks |
+| codex | Codex 跨模型协作 |
+
+## 环境要求
+
+- Node.js >= 18
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)（Plugins 模块需要）
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { checkbox } from "@inquirer/prompts";
+import { fetchContentRoot, printBanner, withEsc } from "./utils.js";
+import { installWorkflow } from "./workflow.js";
+import { installSkills, installRecommendedSkills } from "./skills.js";
+import { installPlugins } from "./plugins.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+async function main() {
+    printBanner(version);
+    console.log("");
+    if (process.env.DEV === "1") {
+        console.log("Using local content (DEV mode)\n");
+    }
+    else {
+        console.log("Fetching latest content from GitHub...");
+    }
+    const packageRoot = await fetchContentRoot();
+    if (process.env.DEV !== "1")
+        console.log("");
+    const moduleTypes = await withEsc(checkbox({
+        message: "Select module types to install:",
+        choices: [
+            {
+                name: "Workflow — CLAUDE.md + AGENTS.md",
+                value: "workflow",
+                checked: true,
+            },
+            {
+                name: "Skills — Development process skills (brainstorming, TDD, debugging...)",
+                value: "skills",
+                checked: true,
+            },
+            {
+                name: "Recommended Skills — Extra utility skills (claude-code-agent, codex-agent...)",
+                value: "recommended",
+                checked: true,
+            },
+            {
+                name: "Plugins — Claude Code plugins (skill-creator, hookify, codex...)",
+                value: "plugins",
+                checked: true,
+            },
+        ],
+    }));
+    if (moduleTypes.length === 0) {
+        console.log("Nothing selected. Bye!");
+        return;
+    }
+    if (moduleTypes.includes("workflow")) {
+        console.log("\n--- Workflow ---\n");
+        await installWorkflow(packageRoot);
+    }
+    if (moduleTypes.includes("skills")) {
+        console.log("\n--- Skills ---\n");
+        await installSkills(packageRoot);
+    }
+    if (moduleTypes.includes("recommended")) {
+        console.log("\n--- Recommended Skills ---\n");
+        await installRecommendedSkills(packageRoot);
+    }
+    if (moduleTypes.includes("plugins")) {
+        console.log("\n--- Plugins ---\n");
+        await installPlugins(packageRoot);
+    }
+    console.log("\n\u2728 Installation complete!\n");
+}
+main().catch((err) => {
+    if (err instanceof Error &&
+        ["ExitPromptError", "CancelPromptError"].includes(err.name)) {
+        console.log("\nCancelled.");
+        process.exit(0);
+    }
+    console.error(err);
+    process.exit(1);
+});

package/dist/plugins.d.ts

@@ -0,0 +1 @@
+export declare function installPlugins(packageRoot: string): Promise<void>;

package/dist/plugins.js

@@ -0,0 +1,112 @@
+import fs from "node:fs";
+import path from "node:path";
+import { checkbox, select } from "@inquirer/prompts";
+import { exec, log, withEsc } from "./utils.js";
+function getInstalledPlugins() {
+    try {
+        const output = exec("claude plugins list --json");
+        const plugins = JSON.parse(output);
+        const cwd = process.cwd();
+        const installed = new Map();
+        for (const p of plugins) {
+            // project scope 只匹配当前目录
+            if (p.scope === "project" && p.projectPath !== cwd)
+                continue;
+            const scopes = installed.get(p.id) || [];
+            scopes.push(p.scope);
+            installed.set(p.id, scopes);
+        }
+        return installed;
+    }
+    catch {
+        return new Map();
+    }
+}
+function getInstalledMarketplaces() {
+    try {
+        const output = exec("claude plugins marketplace list");
+        const names = new Set();
+        for (const match of output.matchAll(/❯\s+(\S+)/g)) {
+            names.add(match[1]);
+        }
+        return names;
+    }
+    catch {
+        return new Set();
+    }
+}
+export async function installPlugins(packageRoot) {
+    // Check claude CLI availability
+    try {
+        exec("which claude");
+    }
+    catch {
+        log.error("'claude' CLI not found. Please install Claude Code first.");
+        return;
+    }
+    const configPath = path.join(packageRoot, ".claude", "plugins.json");
+    if (!fs.existsSync(configPath)) {
+        log.warn("No .claude/plugins.json found");
+        return;
+    }
+    const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    if (config.plugins.length === 0) {
+        log.warn("No plugins defined in plugins.json");
+        return;
+    }
+    const scope = await withEsc(select({
+        message: "Plugins installation scope:",
+        choices: [
+            { name: "User (user-level)", value: "user" },
+            { name: "Project (current project)", value: "project" },
+        ],
+    }));
+    const installed = getInstalledPlugins();
+    const selected = await withEsc(checkbox({
+        message: "Select plugins to install:",
+        choices: config.plugins.map((p) => {
+            const scopes = installed.get(p.package);
+            const suffix = scopes ? ` (installed: ${scopes.join(", ")})` : "";
+            return {
+                name: `${p.name} — ${p.description}${suffix}`,
+                value: p,
+                checked: !scopes || !(scopes.includes("user") && scopes.includes("project")),
+            };
+        }),
+    }));
+    if (selected.length === 0) {
+        log.skip("No plugins selected");
+        return;
+    }
+    // Install required marketplaces
+    const existingMarketplaces = getInstalledMarketplaces();
+    const marketplacesToAdd = new Map();
+    for (const plugin of selected) {
+        if (plugin.marketplace && !existingMarketplaces.has(plugin.marketplace.name)) {
+            marketplacesToAdd.set(plugin.marketplace.name, plugin.marketplace.source);
+        }
+    }
+    for (const [name, source] of marketplacesToAdd) {
+        console.log(`\nAdding marketplace: ${name}...`);
+        try {
+            exec(`claude plugins marketplace add ${source}`, { inherit: true });
+            log.ok(`Marketplace ${name} added`);
+        }
+        catch {
+            log.error(`Failed to add marketplace: ${name}`);
+        }
+    }
+    // Install plugins
+    for (const plugin of selected) {
+        console.log(`\nInstalling ${plugin.name}...`);
+        try {
+            exec(`claude plugins install ${plugin.package} --scope ${scope}`, {
+                inherit: true,
+            });
+            log.ok(`${plugin.name} installed`);
+        }
+        catch {
+            log.error(`Failed to install: ${plugin.name}`);
+        }
+    }
+}

package/dist/skills.d.ts

@@ -0,0 +1,2 @@
+export declare function installSkills(packageRoot: string): Promise<void>;
+export declare function installRecommendedSkills(packageRoot: string): Promise<void>;

package/dist/skills.js

@@ -0,0 +1,68 @@
+import fs from "node:fs";
+import path from "node:path";
+import { checkbox, select } from "@inquirer/prompts";
+import { exec, log, withEsc } from "./utils.js";
+const WORKFLOW_SKILLS = [
+    "brainstorming",
+    "planning-with-files",
+    "playwright-cli",
+    "systematic-debugging",
+    "test-driven-development",
+    "ui-ux-pro-max",
+    "verification-before-completion",
+];
+const RECOMMENDED_DESCRIPTIONS = {
+    "claude-code-agent": "Delegate tasks to another Claude Code CLI instance",
+    "codex-agent": "Delegate tasks to Codex CLI",
+};
+function loadLock(packageRoot) {
+    return JSON.parse(fs.readFileSync(path.join(packageRoot, "skills-lock.json"), "utf-8"));
+}
+async function installSelected(entries, defaultChecked, descriptionMap) {
+    if (entries.length === 0) {
+        log.warn("No skills found");
+        return;
+    }
+    const scope = await withEsc(select({
+        message: "Skills installation scope:",
+        choices: [
+            { name: "Project (current directory)", value: "project" },
+            { name: "Global (user-level)", value: "global" },
+        ],
+    }));
+    const selected = await withEsc(checkbox({
+        message: "Select skills to install:",
+        choices: entries.map(([name, entry]) => {
+            const desc = descriptionMap?.[name];
+            const label = desc ? `${name} — ${desc}` : `${name} (${entry.source})`;
+            return { name: label, value: name, checked: defaultChecked };
+        }),
+    }));
+    if (selected.length === 0) {
+        log.skip("No skills selected");
+        return;
+    }
+    const globalFlag = scope === "global" ? " -g" : "";
+    const lock = Object.fromEntries(entries);
+    for (const name of selected) {
+        const entry = lock[name];
+        console.log(`\nInstalling ${name}...`);
+        try {
+            exec(`npx skills add ${entry.source}${globalFlag} --skill ${name} --agent claude-code codex --yes`, { inherit: true });
+            log.ok(`${name}: installed`);
+        }
+        catch {
+            log.error(`${name}: failed to install`);
+        }
+    }
+}
+export async function installSkills(packageRoot) {
+    const lock = loadLock(packageRoot);
+    const entries = Object.entries(lock.skills).filter(([name]) => WORKFLOW_SKILLS.includes(name));
+    await installSelected(entries, true);
+}
+export async function installRecommendedSkills(packageRoot) {
+    const lock = loadLock(packageRoot);
+    const entries = Object.entries(lock.skills).filter(([name]) => !WORKFLOW_SKILLS.includes(name));
+    await installSelected(entries, false, RECOMMENDED_DESCRIPTIONS);
+}

package/dist/utils.d.ts

@@ -0,0 +1,44 @@
+export interface SkillEntry {
+    source: string;
+    sourceType: string;
+    computedHash: string;
+}
+export interface SkillsLock {
+    version: number;
+    skills: Record<string, SkillEntry>;
+}
+export interface PluginDef {
+    name: string;
+    package: string;
+    description: string;
+    marketplace?: {
+        name: string;
+        source: string;
+    };
+}
+export interface PluginsConfig {
+    plugins: PluginDef[];
+}
+export declare function getPackageRoot(): string;
+export declare function exec(cmd: string, opts?: {
+    cwd?: string;
+    inherit?: boolean;
+}): string;
+export interface LangOption {
+    value: string;
+    label: string;
+    file: string;
+}
+export declare const LANGUAGES: LangOption[];
+export declare function fetchContentRoot(): Promise<string>;
+export declare function fetchExtraContent(tmpDir: string, file: string): Promise<void>;
+export declare function withEsc<T>(prompt: Promise<T> & {
+    cancel?: () => void;
+}): Promise<T>;
+export declare function printBanner(version: string): void;
+export declare const log: {
+    ok: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    skip: (msg: string) => void;
+};

package/dist/utils.js

@@ -0,0 +1,230 @@
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+// --- Package root ---
+export function getPackageRoot() {
+    const __filename = fileURLToPath(import.meta.url);
+    // dist/utils.js -> package root
+    return path.resolve(path.dirname(__filename), "..");
+}
+// --- Exec ---
+export function exec(cmd, opts) {
+    return execSync(cmd, {
+        cwd: opts?.cwd,
+        stdio: opts?.inherit ? "inherit" : "pipe",
+        encoding: "utf-8",
+    });
+}
+export const LANGUAGES = [
+    { value: "en", label: "English", file: "CLAUDE.md" },
+    { value: "zh-CN", label: "中文", file: "CLAUDE.zh-CN.md" },
+];
+// --- Remote content ---
+const REPO = "Ben2pc/auriga-cli";
+const BRANCH = "main";
+const CONTENT_FILES = [
+    "CLAUDE.md",
+    "skills-lock.json",
+    ".claude/plugins.json",
+];
+async function fetchFile(file) {
+    const url = `https://raw.githubusercontent.com/${REPO}/${BRANCH}/${file}`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Failed to fetch ${url}: ${res.status}`);
+    return res.text();
+}
+export async function fetchContentRoot() {
+    if (process.env.DEV === "1") {
+        return getPackageRoot();
+    }
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "auriga-cli-"));
+    for (const file of CONTENT_FILES) {
+        const content = await fetchFile(file);
+        const dest = path.join(tmpDir, file);
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.writeFileSync(dest, content);
+    }
+    return tmpDir;
+}
+export async function fetchExtraContent(tmpDir, file) {
+    const content = await fetchFile(file);
+    const dest = path.join(tmpDir, file);
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, content);
+}
+// --- ESC support ---
+export function withEsc(prompt) {
+    const onKeypress = (_, key) => {
+        if (key.name === "escape") {
+            prompt.cancel?.();
+        }
+    };
+    process.stdin.on("keypress", onKeypress);
+    return prompt.finally(() => {
+        process.stdin.removeListener("keypress", onKeypress);
+    });
+}
+// --- ANSI ---
+const reset = "\x1b[0m";
+const green = "\x1b[32m";
+const yellow = "\x1b[33m";
+const red = "\x1b[31m";
+const dim = "\x1b[2m";
+// --- Banner ---
+const ORIGINAL_ART = [
+    "  ▄▀█ █ █ █▀█ █ █▀▀ ▄▀█",
+    "  █▀█ █▄█ █▀▄ █ █▄█ █▀█",
+];
+// Winter Sky: #2C3E6B (靛蓝) → #5B7EA1 (钢蓝) → #D4A84B (暖金)
+const GRADIENT_STOPS = [
+    [0x2C, 0x3E, 0x6B],
+    [0x5B, 0x7E, 0xA1],
+    [0xD4, 0xA8, 0x4B],
+];
+const SHADOW_COLOR = "\x1b[38;5;238m";
+const SHADOW_DX = 1;
+const SHADOW_DY = 1;
+const SCALE = 2;
+function decodeBanner(lines) {
+    const width = Math.max(...lines.map((l) => l.length));
+    const pixels = [];
+    for (const line of lines) {
+        const topRow = [];
+        const botRow = [];
+        for (let i = 0; i < width; i++) {
+            const ch = line[i] || " ";
+            if (ch === "█") {
+                topRow.push(1);
+                botRow.push(1);
+            }
+            else if (ch === "▀") {
+                topRow.push(1);
+                botRow.push(0);
+            }
+            else if (ch === "▄") {
+                topRow.push(0);
+                botRow.push(1);
+            }
+            else {
+                topRow.push(0);
+                botRow.push(0);
+            }
+        }
+        pixels.push(topRow, botRow);
+    }
+    return pixels;
+}
+function scaleBanner(pixels, n) {
+    const result = [];
+    for (const row of pixels) {
+        const scaledRow = row.flatMap((px) => Array(n).fill(px));
+        for (let i = 0; i < n; i++)
+            result.push([...scaledRow]);
+    }
+    return result;
+}
+function renderBannerWithShadow(pixels, dx, dy) {
+    const h = pixels.length;
+    const w = pixels[0].length;
+    // Build composite: 1=main, 2=shadow, 0=empty
+    const comp = pixels.map((r) => [...r]);
+    for (let i = 0; i < dy; i++)
+        comp.push(new Array(w + dx).fill(0));
+    for (const row of comp)
+        while (row.length < w + dx)
+            row.push(0);
+    for (let y = 0; y < h; y++) {
+        for (let x = 0; x < w; x++) {
+            if (pixels[y][x] === 1) {
+                const sy = y + dy, sx = x + dx;
+                if (sy < comp.length && sx < comp[0].length && comp[sy][sx] === 0) {
+                    comp[sy][sx] = 2;
+                }
+            }
+        }
+    }
+    // Render with per-character coloring
+    const totalW = comp[0].length;
+    const lines = [];
+    for (let y = 0; y < comp.length; y += 2) {
+        const top = comp[y];
+        const bot = y + 1 < comp.length ? comp[y + 1] : new Array(totalW).fill(0);
+        let line = "";
+        for (let x = 0; x < totalW; x++) {
+            const t = top[x], b = bot[x];
+            const tFill = t > 0, bFill = b > 0;
+            let ch;
+            if (tFill && bFill)
+                ch = "█";
+            else if (tFill && !bFill)
+                ch = "▀";
+            else if (!tFill && bFill)
+                ch = "▄";
+            else
+                ch = " ";
+            if (ch === " ") {
+                line += " ";
+                continue;
+            }
+            if (t === 1 || b === 1) {
+                const ratio = totalW <= 1 ? 0 : x / (totalW - 1);
+                const seg = ratio < 0.5 ? 0 : 1;
+                const localT = seg === 0 ? ratio * 2 : (ratio - 0.5) * 2;
+                const from = GRADIENT_STOPS[seg], to = GRADIENT_STOPS[seg + 1];
+                const r = Math.round(from[0] + localT * (to[0] - from[0]));
+                const g = Math.round(from[1] + localT * (to[1] - from[1]));
+                const bv = Math.round(from[2] + localT * (to[2] - from[2]));
+                line += `\x1b[38;2;${r};${g};${bv}m${ch}${reset}`;
+            }
+            else {
+                line += `${SHADOW_COLOR}${ch}${reset}`;
+            }
+        }
+        lines.push(line);
+    }
+    return lines.join("\n");
+}
+function renderBannerPlain(pixels) {
+    const lines = [];
+    for (let y = 0; y < pixels.length; y += 2) {
+        const top = pixels[y];
+        const bot = y + 1 < pixels.length ? pixels[y + 1] : top.map(() => 0);
+        let line = "";
+        for (let x = 0; x < top.length; x++) {
+            const t = top[x], b = bot[x];
+            if (t && b)
+                line += "█";
+            else if (t && !b)
+                line += "▀";
+            else if (!t && b)
+                line += "▄";
+            else
+                line += " ";
+        }
+        lines.push(line);
+    }
+    return lines.join("\n");
+}
+export function printBanner(version) {
+    const noColor = process.env.NO_COLOR !== undefined;
+    const pixels = scaleBanner(decodeBanner(ORIGINAL_ART), SCALE);
+    const art = noColor
+        ? renderBannerPlain(pixels)
+        : renderBannerWithShadow(pixels, SHADOW_DX, SHADOW_DY);
+    const subtitle = noColor
+        ? `  Claude Code Harness Installer  v${version}`
+        : `${dim}  Claude Code Harness Installer  v${version}${reset}`;
+    console.log("");
+    console.log(art);
+    console.log(subtitle);
+}
+// --- Log ---
+export const log = {
+    ok: (msg) => console.log(`${green}\u2713${reset} ${msg}`),
+    warn: (msg) => console.log(`${yellow}\u26a0${reset} ${msg}`),
+    error: (msg) => console.log(`${red}\u2717${reset} ${msg}`),
+    skip: (msg) => console.log(`${dim}  skip: ${msg}${reset}`),
+};

package/dist/workflow.d.ts

@@ -0,0 +1 @@
+export declare function installWorkflow(packageRoot: string): Promise<void>;

package/dist/workflow.js

@@ -0,0 +1,47 @@
+import fs from "node:fs";
+import path from "node:path";
+import { input, select } from "@inquirer/prompts";
+import { LANGUAGES, fetchExtraContent, log, withEsc } from "./utils.js";
+export async function installWorkflow(packageRoot) {
+    const lang = await withEsc(select({
+        message: "CLAUDE.md language:",
+        choices: LANGUAGES.map((l) => ({ name: l.label, value: l.value })),
+        default: "en",
+    }));
+    const targetDir = await withEsc(input({
+        message: "Workflow install target directory:",
+        default: process.cwd(),
+    }));
+    const resolved = path.resolve(targetDir);
+    if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
+        log.error(`Not a valid directory: ${resolved}`);
+        return;
+    }
+    const langOpt = LANGUAGES.find((l) => l.value === lang);
+    // Lazy fetch: only download non-default language file when needed
+    if (langOpt.file !== "CLAUDE.md") {
+        console.log(`Fetching ${langOpt.label} template...`);
+        await fetchExtraContent(packageRoot, langOpt.file);
+    }
+    const sourceClaude = path.join(packageRoot, langOpt.file);
+    const targetClaude = path.join(resolved, "CLAUDE.md");
+    const targetAgents = path.join(resolved, "AGENTS.md");
+    // Copy CLAUDE.md
+    if (fs.existsSync(targetClaude)) {
+        const bakPath = targetClaude + ".bak";
+        fs.copyFileSync(targetClaude, bakPath);
+        log.warn(`Existing CLAUDE.md backed up to CLAUDE.md.bak`);
+    }
+    fs.copyFileSync(sourceClaude, targetClaude);
+    log.ok(`CLAUDE.md copied (${langOpt.label})`);
+    // Create AGENTS.md symlink
+    try {
+        fs.lstatSync(targetAgents);
+        fs.unlinkSync(targetAgents);
+    }
+    catch {
+        // does not exist, proceed
+    }
+    fs.symlinkSync("CLAUDE.md", targetAgents);
+    log.ok("AGENTS.md -> CLAUDE.md symlink created");
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "auriga-cli",
+  "version": "1.0.0",
+  "description": "Interactive CLI to install Claude Code harness modules (Workflow, Skills, Plugins)",
+  "type": "module",
+  "bin": {
+    "auriga-cli": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}