pruff-skills 0.2.0 → 0.3.0

package/dist/_chunks/libs/@clack/prompts.mjs

@@ -1,5 +1,5 @@
 import { __toESM } from "../../rolldown-runtime.mjs";
-import { LD, SD, _D, dD, fD, require_picocolors, require_src } from "./core.mjs";
+import { LD, RD, SD, _D, dD, fD, require_picocolors, require_src } from "./core.mjs";
 import { stripVTControlCharacters } from "node:util";
 import y from "node:process";
 var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
@@ -24,7 +24,29 @@ const V = ce(), u = (t, n) => V ? t : n, le = u("◆", "*"), L = u("■", "x"),
 		const j = v === 0 && $, E = v === f.length - 1 && g;
 		return j || E ? import_picocolors.default.dim("...") : i(p, v + l === n);
 	});
-}, ye = (t) => {
+}, he = (t) => new RD({
+	validate: t.validate,
+	placeholder: t.placeholder,
+	defaultValue: t.defaultValue,
+	initialValue: t.initialValue,
+	render() {
+		const n = `${import_picocolors.default.gray(o)}
+${b(this.state)}  ${t.message}
+`, r = t.placeholder ? import_picocolors.default.inverse(t.placeholder[0]) + import_picocolors.default.dim(t.placeholder.slice(1)) : import_picocolors.default.inverse(import_picocolors.default.hidden("_")), i = this.value ? this.valueWithCursor : r;
+		switch (this.state) {
+			case "error": return `${n.trim()}
+${import_picocolors.default.yellow(o)}  ${i}
+${import_picocolors.default.yellow(d)}  ${import_picocolors.default.yellow(this.error)}
+`;
+			case "submit": return `${n}${import_picocolors.default.gray(o)}  ${import_picocolors.default.dim(this.value || t.placeholder)}`;
+			case "cancel": return `${n}${import_picocolors.default.gray(o)}  ${import_picocolors.default.strikethrough(import_picocolors.default.dim(this.value ?? ""))}${this.value?.trim() ? `
+${import_picocolors.default.gray(o)}` : ""}`;
+			default: return `${n}${import_picocolors.default.cyan(o)}  ${i}
+${import_picocolors.default.cyan(d)}
+`;
+		}
+	}
+}).prompt(), ye = (t) => {
 	const n = t.active ?? "Yes", r = t.inactive ?? "No";
 	return new dD({
 		active: n,
@@ -329,4 +351,4 @@ ${J}${i.trimStart()}`), r = 3 + stripVTControlCharacters(i.trimStart()).length);
 		}
 	};
 };
-export { Ie, M, Me, Se, Y, be, fe, ve, xe, ye };
+export { Ie, M, Me, Se, Y, be, fe, he, ve, xe, ye };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { __toESM } from "./_chunks/rolldown-runtime.mjs";
 import { pD, require_picocolors } from "./_chunks/libs/@clack/core.mjs";
-import { Ie, M, Me, Se, Y, be, fe, ve, xe, ye } from "./_chunks/libs/@clack/prompts.mjs";
+import { Ie, M, Me, Se, Y, be, fe, he, ve, xe, ye } from "./_chunks/libs/@clack/prompts.mjs";
 import { esm_default } from "./_chunks/libs/simple-git.mjs";
 import { xdgConfig } from "./_chunks/libs/xdg-basedir.mjs";
 import { require_dist } from "./_chunks/libs/@vercel/detect-agent.mjs";
@@ -16,7 +16,7 @@ import { promisify } from "util";
 import { execFile, execSync, spawn, spawnSync } from "child_process";
 import { access, cp, lstat, mkdir, mkdtemp, readFile, readdir, readlink, realpath, rm, stat, symlink, writeFile } from "fs/promises";
 import { parse } from "yaml";
-import { createHash } from "crypto";
+import { createHash, randomBytes } from "crypto";
 import { createHash as createHash$1 } from "node:crypto";
 import { gunzipSync, inflateRawSync } from "node:zlib";
 var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
@@ -555,7 +555,7 @@ function buildGitHubAuthError(url, repo, message) {
 	if (repo) return `Authentication failed for ${url}.\n  - For private repos, ensure you have access\n  - Retry with SSH: npx pruff-skills add ${repo.sshUrl}\n  - Check access with: gh auth status -h github.com or ssh -T git@github.com`;
 	return `Authentication failed for ${url}.\n  - For private repos, ensure you have access\n  - For SSH: Check your keys with 'ssh -T git@github.com'\n  - For HTTPS: Run 'gh auth login' or configure git credentials`;
 }
-async function cloneRepo(url, ref) {
+async function cloneRepo$1(url, ref) {
 	const tempDir = await mkdtemp(join(tmpdir(), "skills-"));
 	const cloneOptions = ref ? [
 		"--depth",
@@ -3467,7 +3467,7 @@ async function runAdd(args, options = {}) {
 				spinner.stop(`Found ${import_picocolors.default.green(skills.length)} skill${skills.length > 1 ? "s" : ""}`);
 			} else {
 				spinner.start("Cloning repository...");
-				tempDir = await cloneRepo(parsed.url, parsed.ref);
+				tempDir = await cloneRepo$1(parsed.url, parsed.ref);
 				spinner.stop("Repository cloned");
 				spinner.start("Discovering skills...");
 				skills = await discoverSkills(tempDir, parsed.subpath, {
@@ -3477,7 +3477,7 @@ async function runAdd(args, options = {}) {
 			}
 		} else {
 			spinner.start("Cloning repository...");
-			tempDir = await cloneRepo(parsed.url, parsed.ref);
+			tempDir = await cloneRepo$1(parsed.url, parsed.ref);
 			spinner.stop("Repository cloned");
 			spinner.start("Discovering skills...");
 			skills = await discoverSkills(tempDir, parsed.subpath, {
@@ -4020,7 +4020,7 @@ async function fetchAgentFile(source, name) {
 		return null;
 	}
 	try {
-		const file = join(await cloneRepo(source), rel);
+		const file = join(await cloneRepo$1(source), rel);
 		return existsSync(file) ? readFile(file, "utf8") : null;
 	} catch {
 		return null;
@@ -4134,7 +4134,7 @@ async function fetchFromCatalog(source, rel) {
 		return null;
 	}
 	try {
-		const file = join(await cloneRepo(source), rel);
+		const file = join(await cloneRepo$1(source), rel);
 		return existsSync(file) ? readFile(file, "utf8") : null;
 	} catch {
 		return null;
@@ -5466,7 +5466,7 @@ async function updateGlobalSkills(options = {}) {
 				}
 				continue;
 			}
-			tempDir = await cloneRepo(sourceUrl, firstEntry.ref);
+			tempDir = await cloneRepo$1(sourceUrl, firstEntry.ref);
 			const discoveredPaths = (await discoverSkills(tempDir)).map((skill) => {
 				return join(relative(tempDir, skill.path), "SKILL.md").split(sep).join("/");
 			});
@@ -5622,7 +5622,7 @@ async function updateProjectSkills(options = {}) {
 		let tempDir = null;
 		let deletedSkills = [];
 		try {
-			tempDir = await cloneRepo(sourceUrl, ref);
+			tempDir = await cloneRepo$1(sourceUrl, ref);
 			const discoveredPaths = (await discoverSkills(tempDir)).map((s) => {
 				return join(relative(tempDir, s.path), "SKILL.md").split(sep).join("/");
 			});
@@ -5841,14 +5841,14 @@ async function runUse(sourceArgs, options = {}, parseErrors = []) {
 				});
 				if (blobResult) skills = blobResult.skills;
 				else {
-					cloneTempDir = await cloneRepo(parsed.url, parsed.ref);
+					cloneTempDir = await cloneRepo$1(parsed.url, parsed.ref);
 					skills = await discoverSkills(cloneTempDir, parsed.subpath, {
 						includeInternal,
 						fullDepth: options.fullDepth
 					});
 				}
 			} else {
-				cloneTempDir = await cloneRepo(parsed.url, parsed.ref);
+				cloneTempDir = await cloneRepo$1(parsed.url, parsed.ref);
 				skills = await discoverSkills(cloneTempDir, parsed.subpath, {
 					includeInternal,
 					fullDepth: options.fullDepth
@@ -6071,6 +6071,291 @@ function fail(message) {
 	process.exit(1);
 }
 var UseCommandError = class extends Error {};
+const RESET = "\x1B[0m";
+const DIM = "\x1B[38;5;102m";
+const BLUES = [
+	"\x1B[38;2;110;139;255m",
+	"\x1B[38;2;91;118;249m",
+	"\x1B[38;2;72;97;242m",
+	"\x1B[38;2;53;77;236m",
+	"\x1B[38;2;34;56;229m",
+	"\x1B[38;2;15;35;223m"
+];
+const SWEEP = "\x1B[38;2;214;226;255m";
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function canAnimate() {
+	return !!process.stdout.isTTY && !process.env.CI && !process.env.NO_COLOR && !process.env.PRUFF_SKILLS_NO_ANIM;
+}
+function columnColor(col, width) {
+	return BLUES[Math.min(BLUES.length - 1, Math.floor(col / Math.max(1, width - 1) * BLUES.length))];
+}
+function renderSweepLine(chars, indent, pos, band) {
+	let out = indent;
+	let mode = "";
+	for (let c = 0; c < chars.length; c++) {
+		const color = c >= pos && c < pos + band ? SWEEP : columnColor(c, chars.length);
+		if (color !== mode) {
+			out += color;
+			mode = color;
+		}
+		out += chars[c];
+	}
+	return out + RESET;
+}
+async function sweepLine(text, { slow = false, indent = "  " } = {}) {
+	const chars = Array.from(text);
+	const width = chars.length;
+	const band = 5;
+	const step = slow ? 2 : 3;
+	const ms = slow ? 42 : 24;
+	if (!canAnimate()) {
+		console.log(renderSweepLine(chars, indent, -1, 0));
+		return;
+	}
+	process.stdout.write("\x1B[?25l");
+	try {
+		let first = true;
+		for (let pos = -5; pos <= width; pos += step) {
+			if (!first) process.stdout.write("\x1B[1A");
+			process.stdout.write("\r" + renderSweepLine(chars, indent, pos, band) + "\n");
+			first = false;
+			await sleep(ms);
+		}
+		process.stdout.write("\x1B[1A\r" + renderSweepLine(chars, indent, -1, 0) + "\n");
+	} finally {
+		process.stdout.write("\x1B[?25h");
+	}
+}
+const CLAUDE_CODE_PKG = "@anthropic-ai/claude-code";
+const KNOWLEDGE_REPO = "https://github.com/Pruff-Tech/pruff-knowledge";
+const KNOWLEDGE_DIR = "Pruff Knowledge";
+const DEFAULT_WORKSPACE = join(homedir(), "pruff");
+const MAIN_REPOS = [{
+	name: "Pruff-server",
+	url: "https://github.com/Pruff-Tech/Pruff-server"
+}, {
+	name: "Pruff-Client",
+	url: "https://github.com/Pruff-Tech/Pruff-Client"
+}];
+const CORE_SKILLS = [
+	"commit",
+	"create-pr",
+	"linear",
+	"start-issue",
+	"handoff",
+	"pruff-logs",
+	"pruff-pr-review",
+	"review-pr-comments",
+	"react-doctor"
+];
+const CORE_AGENTS = [
+	"codebase-navigator",
+	"db-query-reviewer",
+	"pruff-logs-investigator"
+];
+async function runOnboarding(args) {
+	if (process.platform !== "darwin") {
+		M.error(`${import_picocolors.default.bold("onboarding")} currently supports macOS only (detected ${import_picocolors.default.cyan(process.platform)}).`);
+		return;
+	}
+	Ie(import_picocolors.default.bold("Pruff onboarding"));
+	installClaudeCode();
+	ensureObsidian();
+	const workspace = await resolveWorkspace(args);
+	mkdirSync(workspace, { recursive: true });
+	M.success(`Workspace ${import_picocolors.default.cyan(workspace)}`);
+	cloneKnowledge(workspace);
+	for (const repo of MAIN_REPOS) cloneRepo(repo.name, repo.url, workspace);
+	await installCatalog(workspace);
+	await showGuidance(workspace);
+	Se(`${import_picocolors.default.green("Done.")} Welcome to Pruff — happy building.`);
+}
+function has(cmd) {
+	return spawnSync("command", ["-v", cmd], {
+		shell: true,
+		stdio: "ignore"
+	}).status === 0;
+}
+function run(cmd, args, cwd) {
+	return spawnSync(cmd, args, {
+		stdio: "inherit",
+		cwd
+	}).status === 0;
+}
+function expandHome(input) {
+	return input.startsWith("~") ? join(homedir(), input.slice(1)) : input;
+}
+function installClaudeCode() {
+	if (has("claude")) {
+		M.success("Claude Code already installed");
+		return;
+	}
+	const s = Y();
+	s.start("Installing Claude Code…");
+	if (run("npm", [
+		"install",
+		"-g",
+		CLAUDE_CODE_PKG
+	])) s.stop("Claude Code installed");
+	else {
+		s.stop(import_picocolors.default.yellow("Claude Code install failed"));
+		M.warn(`Install it manually: ${import_picocolors.default.cyan(`npm i -g ${CLAUDE_CODE_PKG}`)}`);
+	}
+}
+function ensureObsidian() {
+	if (existsSync("/Applications/Obsidian.app")) {
+		M.success("Obsidian already installed");
+		return;
+	}
+	if (!has("brew")) {
+		M.warn(`Obsidian not found and Homebrew is unavailable.\n  Install it from ${import_picocolors.default.cyan("https://obsidian.md")} and re-run.`);
+		return;
+	}
+	const s = Y();
+	s.start("Installing Obsidian (brew)…");
+	if (run("brew", [
+		"install",
+		"--cask",
+		"obsidian"
+	])) s.stop("Obsidian installed");
+	else {
+		s.stop(import_picocolors.default.yellow("Obsidian install failed"));
+		M.warn(`Install manually: ${import_picocolors.default.cyan("brew install --cask obsidian")}`);
+	}
+}
+async function resolveWorkspace(args) {
+	const fromArg = args.find((a) => !a.startsWith("-"));
+	if (fromArg) return expandHome(fromArg);
+	if (!process.stdout.isTTY) return DEFAULT_WORKSPACE;
+	const answer = await he({
+		message: "Where should the Pruff workspace live?",
+		placeholder: DEFAULT_WORKSPACE,
+		defaultValue: DEFAULT_WORKSPACE
+	});
+	if (pD(answer)) {
+		xe("Onboarding cancelled.");
+		process.exit(0);
+	}
+	return expandHome((answer || DEFAULT_WORKSPACE).trim());
+}
+function cloneKnowledge(workspace) {
+	const vaultPath = join(workspace, KNOWLEDGE_DIR);
+	const s = Y();
+	if (existsSync(join(vaultPath, ".git"))) {
+		s.start("Updating Pruff knowledge…");
+		const ok = run("git", [
+			"-C",
+			vaultPath,
+			"pull",
+			"--ff-only"
+		]);
+		s.stop(ok ? "Pruff knowledge up to date" : import_picocolors.default.yellow("git pull failed (keeping local copy)"));
+		registerVault(vaultPath);
+		return;
+	}
+	s.start("Cloning Pruff knowledge…");
+	if (run("git", [
+		"clone",
+		KNOWLEDGE_REPO,
+		vaultPath
+	])) {
+		s.stop(`Cloned knowledge to ${import_picocolors.default.dim(vaultPath)}`);
+		registerVault(vaultPath);
+		return;
+	}
+	s.stop(import_picocolors.default.yellow("Knowledge clone failed"));
+	M.warn(`Could not clone ${import_picocolors.default.cyan(KNOWLEDGE_REPO)}.\n  It's private — authenticate first with ${import_picocolors.default.cyan("gh auth login")} (or an SSH key), then re-run.`);
+}
+function cloneRepo(name, url, workspace) {
+	const target = join(workspace, name);
+	if (existsSync(join(target, ".git"))) {
+		M.success(`${name} already cloned`);
+		return;
+	}
+	const s = Y();
+	s.start(`Cloning ${name}…`);
+	if (run("git", [
+		"clone",
+		url,
+		target
+	], workspace)) s.stop(`Cloned ${import_picocolors.default.cyan(name)}`);
+	else {
+		s.stop(import_picocolors.default.yellow(`${name} clone failed`));
+		M.warn(`Could not clone ${name}. Authenticate with ${import_picocolors.default.cyan("gh auth login")} then run:\n  ${import_picocolors.default.dim(`git clone ${url}`)}  (inside ${workspace})`);
+	}
+}
+async function installCatalog(workspace) {
+	const prevCwd = process.cwd();
+	M.step("Installing Pruff rules, agents and skills into the workspace…");
+	try {
+		process.chdir(workspace);
+		await runRules(["add", "--all"]);
+		await runAgents(["add", ...CORE_AGENTS]);
+		await runAdd([PRUFF_CATALOG], {
+			skill: CORE_SKILLS,
+			agent: ["claude-code"],
+			yes: true
+		});
+	} catch (error) {
+		M.warn(`Catalog install hit an error: ${error instanceof Error ? error.message : String(error)}\n  Re-run once authenticated: ${import_picocolors.default.cyan("npx pruff-skills onboarding")}`);
+	} finally {
+		process.chdir(prevCwd);
+	}
+}
+async function showGuidance(workspace) {
+	console.log();
+	await sweepLine("W O R K S P A C E   R E A D Y", { slow: true });
+	console.log();
+	const line = (s) => console.log(`  ${s}`);
+	line(import_picocolors.default.bold("Recommended structure") + import_picocolors.default.dim("  (keep everything under one parent)"));
+	line("");
+	line(`${import_picocolors.default.cyan(workspace)}/`);
+	const tree = [
+		[".claude/", "rules · agents · skills (apply to every repo below)"],
+		[`${KNOWLEDGE_DIR}/`, "Obsidian vault — open it in Obsidian"],
+		["Pruff-server/", "backend"],
+		["Pruff-Client/", "frontend"],
+		["sls-*/", "serverless services — clone as you need them"]
+	];
+	const labelWidth = Math.max(...tree.map(([label]) => label.length)) + 2;
+	tree.forEach(([label, desc], i) => {
+		const connector = i === tree.length - 1 ? "└──" : "├──";
+		line(`${import_picocolors.default.dim(connector)} ${label.padEnd(labelWidth)}${import_picocolors.default.dim(desc)}`);
+	});
+	line("");
+	line(import_picocolors.default.bold("Next steps"));
+	line(`${import_picocolors.default.dim("1.")} Open ${import_picocolors.default.bold("Obsidian")} → the ${import_picocolors.default.cyan(KNOWLEDGE_DIR)} vault is registered and ready.`);
+	line(`${import_picocolors.default.dim("2.")} Start Claude Code from ${import_picocolors.default.cyan(workspace)} so the shared ${import_picocolors.default.dim(".claude/")} applies everywhere.`);
+	line(`${import_picocolors.default.dim("3.")} Backend:  ${import_picocolors.default.dim("cd Pruff-server && npm i && npm run local")}`);
+	line(`${import_picocolors.default.dim("4.")} Frontend: ${import_picocolors.default.dim("cd Pruff-Client && yarn && yarn start-local")}`);
+	line(`${import_picocolors.default.dim("5.")} Clone any serverless service into this folder with ${import_picocolors.default.dim("git clone <repo>")}.`);
+	console.log();
+}
+function registerVault(vaultPath) {
+	const dir = join(homedir(), "Library", "Application Support", "obsidian");
+	const configPath = join(dir, "obsidian.json");
+	let config = { vaults: {} };
+	if (existsSync(configPath)) try {
+		config = JSON.parse(readFileSync(configPath, "utf-8"));
+		if (!config.vaults) config.vaults = {};
+	} catch {
+		M.warn(`Could not parse ${import_picocolors.default.dim(configPath)} — leaving it untouched.`);
+		return;
+	}
+	else mkdirSync(dir, { recursive: true });
+	if (Object.values(config.vaults).some((v) => v.path === vaultPath)) {
+		M.success("Vault already registered in Obsidian");
+		return;
+	}
+	const id = randomBytes(8).toString("hex");
+	config.vaults[id] = {
+		path: vaultPath,
+		ts: Date.now(),
+		open: true
+	};
+	writeFileSync(configPath, JSON.stringify(config), "utf-8");
+	M.success("Registered vault in Obsidian");
+}
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function getVersion() {
 	try {
@@ -6081,9 +6366,7 @@ function getVersion() {
 	}
 }
 const VERSION = getVersion();
-const RESET = "\x1B[0m";
 const BOLD = "\x1B[1m";
-const DIM = "\x1B[38;5;102m";
 const TEXT = "\x1B[38;5;145m";
 const BLUE = "\x1B[38;2;110;139;255m";
 const LOGO_LINES = [
@@ -6094,16 +6377,6 @@ const LOGO_LINES = [
 	"██║     ██║  ██║╚██████╔╝██║     ██║     ",
 	"╚═╝     ╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝     "
 ];
-const BLUES = [
-	"\x1B[38;2;110;139;255m",
-	"\x1B[38;2;91;118;249m",
-	"\x1B[38;2;72;97;242m",
-	"\x1B[38;2;53;77;236m",
-	"\x1B[38;2;34;56;229m",
-	"\x1B[38;2;15;35;223m"
-];
-const SWEEP = "\x1B[38;2;214;226;255m";
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 function printStaticLogo() {
 	LOGO_LINES.forEach((line, i) => {
 		console.log(`${BLUES[i]}${line}${RESET}`);
@@ -6139,7 +6412,7 @@ function renderLogoFrame(pos, band) {
 		return out + RESET;
 	}).join("\n");
 }
-async function showLogo() {
+async function showLogo(slow = false) {
 	console.log();
 	if (!(!!process.stdout.isTTY && !process.env.CI && !process.env.NO_COLOR && !process.env.PRUFF_SKILLS_NO_ANIM)) {
 		printStaticLogo();
@@ -6148,6 +6421,9 @@ async function showLogo() {
 	const rows = LOGO_LINES.length;
 	const width = Math.max(...LOGO_LINES.map((l) => Array.from(l).length));
 	const band = 7;
+	const revealMs = slow ? 190 : 90;
+	const step = slow ? 3 : 4;
+	const sweepMs = slow ? 34 : 18;
 	process.stdout.write("\x1B[?25l");
 	try {
 		let first = true;
@@ -6155,15 +6431,75 @@ async function showLogo() {
 			if (!first) process.stdout.write(`\x1b[${rows}A`);
 			process.stdout.write("\r" + renderLogoReveal(cut, width) + "\n");
 			first = false;
-			await sleep(90);
+			await sleep(revealMs);
 		}
-		for (let pos = -7; pos <= width; pos += 4) {
+		for (let pos = -7; pos <= width; pos += step) {
 			process.stdout.write(`\x1b[${rows}A`);
 			process.stdout.write("\r" + renderLogoFrame(pos, band) + "\n");
-			await sleep(18);
+			await sleep(sweepMs);
 		}
 		process.stdout.write(`\x1b[${rows}A\r`);
 		process.stdout.write(LOGO_LINES.map((line, i) => `${BLUES[i]}${line}${RESET}`).join("\n") + "\n");
+		if (slow) await sleep(500);
+	} finally {
+		process.stdout.write("\x1B[?25h");
+	}
+}
+const TAGLINE_BLOCKS = [[
+	"██████╗ ██╗   ██╗██╗██╗     ██████╗ ██╗███╗   ██╗ ██████╗ ",
+	"██╔══██╗██║   ██║██║██║     ██╔══██╗██║████╗  ██║██╔════╝ ",
+	"██████╔╝██║   ██║██║██║     ██║  ██║██║██╔██╗ ██║██║  ███╗",
+	"██╔══██╗██║   ██║██║██║     ██║  ██║██║██║╚██╗██║██║   ██║",
+	"██████╔╝╚██████╔╝██║███████╗██████╔╝██║██║ ╚████║╚██████╔╝",
+	"╚═════╝  ╚═════╝ ╚═╝╚══════╝╚═════╝ ╚═╝╚═╝  ╚═══╝ ╚═════╝ "
+], [
+	"███████╗██╗███╗   ██╗████████╗███████╗ ██████╗██╗  ██╗███████╗",
+	"██╔════╝██║████╗  ██║╚══██╔══╝██╔════╝██╔════╝██║  ██║██╔════╝",
+	"█████╗  ██║██╔██╗ ██║   ██║   █████╗  ██║     ███████║███████╗",
+	"██╔══╝  ██║██║╚██╗██║   ██║   ██╔══╝  ██║     ██╔══██║╚════██║",
+	"██║     ██║██║ ╚████║   ██║   ███████╗╚██████╗██║  ██║███████║",
+	"╚═╝     ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝"
+]];
+const TAGLINE_INDENT = "  ";
+function renderTaglineRow(line, row, pos, band) {
+	const chars = Array.from(line);
+	let out = TAGLINE_INDENT;
+	let mode = "";
+	for (let c = 0; c < chars.length; c++) {
+		const color = c >= pos && c < pos + band ? SWEEP : BLUES[row];
+		if (color !== mode) {
+			out += color;
+			mode = color;
+		}
+		out += chars[c];
+	}
+	return out + RESET;
+}
+function renderTaglineFrame(pos, band) {
+	return TAGLINE_BLOCKS.map((block) => block.map((line, row) => renderTaglineRow(line, row, pos, band)).join("\n")).join("\n");
+}
+async function showTagline(slow = false) {
+	console.log();
+	const rows = TAGLINE_BLOCKS.reduce((n, b) => n + b.length, 0);
+	const width = Math.max(...TAGLINE_BLOCKS.flat().map((l) => Array.from(l).length));
+	const band = 7;
+	const step = slow ? 3 : 4;
+	const sweepMs = slow ? 34 : 18;
+	if (!(!!process.stdout.isTTY && !process.env.CI && !process.env.NO_COLOR && !process.env.PRUFF_SKILLS_NO_ANIM)) {
+		console.log(renderTaglineFrame(-1, 0));
+		return;
+	}
+	process.stdout.write("\x1B[?25l");
+	try {
+		let first = true;
+		for (let pos = -7; pos <= width; pos += step) {
+			if (!first) process.stdout.write(`\x1b[${rows}A`);
+			process.stdout.write("\r" + renderTaglineFrame(pos, band) + "\n");
+			first = false;
+			await sleep(sweepMs);
+		}
+		process.stdout.write(`\x1b[${rows}A\r` + renderTaglineFrame(-1, 0) + "\n");
+		if (slow) await sleep(500);
 	} finally {
 		process.stdout.write("\x1B[?25h");
 	}
@@ -6212,6 +6548,10 @@ ${BOLD}Rules:${RESET}
   rules add --scope <client|server|common>
                        Install a whole repo's rule set (client/server also pull in common)
 
+${BOLD}Onboarding:${RESET}
+  onboarding           Set up a new machine (macOS): install Claude Code,
+                       install Obsidian, and clone the Pruff knowledge vault
+
 ${BOLD}Updates:${RESET}
   update [skills...]   Update skills to latest versions (alias: upgrade)
 
@@ -6417,6 +6757,14 @@ async function main() {
 			if (!inAgent) await showLogo();
 			await runRules(restArgs);
 			break;
+		case "onboarding":
+		case "onboard":
+			if (!inAgent) {
+				await showLogo(true);
+				await showTagline(true);
+			}
+			await runOnboarding(restArgs);
+			break;
 		case "remove":
 		case "rm":
 		case "r":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pruff-skills",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The official Pruff agent skills CLI",
   "type": "module",
   "bin": {