pruff-skills 0.10.0 → 0.11.0

package/README.md

@@ -181,7 +181,15 @@ Scaffold one with `npx pruff-skills init my-skill`, then publish it by pushing t
 
 ## Telemetry
 
-**None.** pruff-skills ships with all usage telemetry removed — no events leave your machine.
+**The CLI sends nothing.** pruff-skills ships with the upstream usage telemetry removed — running
+`add`, `update`, `find` or any other command emits no events.
+
+Separately, `pruff-skills analytics` can turn on **Claude Code's own** OpenTelemetry exporter and
+point it at Pruff's analytics backend, so an organisation can see which skills and tools its token
+spend goes to. It is opt-in and Pruff-internal: `analytics enable` is the only command that writes
+anything (never `add`, `update` or `onboarding`), the endpoint credentials live in the private
+catalog repo rather than in this package, and it exports no prompts, responses or file contents.
+`analytics status` shows what is on; `analytics disable` removes it.
 
 ## Attribution
 

package/dist/cli.mjs

@@ -434,7 +434,7 @@ const CLONE_TIMEOUT_MS = (() => {
 	const parsed = Number.parseInt(raw, 10);
 	return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_CLONE_TIMEOUT_MS;
 })();
-const execFileAsync$4 = promisify(execFile);
+const execFileAsync$5 = promisify(execFile);
 var GitCloneError = class extends Error {
 	url;
 	isTimeout;
@@ -513,7 +513,7 @@ async function resetTempDir(dir) {
 async function tryGhClone(repo, tempDir, ref) {
 	let cloneTarget = repo.slug;
 	try {
-		const { stdout, stderr } = await execFileAsync$4("gh", [
+		const { stdout, stderr } = await execFileAsync$5("gh", [
 			"auth",
 			"status",
 			"-h",
@@ -530,7 +530,7 @@ async function tryGhClone(repo, tempDir, ref) {
 	} catch {
 		return false;
 	}
-	await execFileAsync$4("gh", [
+	await execFileAsync$5("gh", [
 		"repo",
 		"clone",
 		cloneTarget,
@@ -926,16 +926,16 @@ function filterSkills(skills, inputNames) {
 		return normalizedInputs.some((input) => input === name || input === displayName);
 	});
 }
-const home = homedir();
-const configHome = xdgConfig ?? join(home, ".config");
-const codexHome = process.env.CODEX_HOME?.trim() || join(home, ".codex");
-const claudeHome = process.env.CLAUDE_CONFIG_DIR?.trim() || join(home, ".claude");
-const vibeHome = process.env.VIBE_HOME?.trim() || join(home, ".vibe");
-const hermesHome = process.env.HERMES_HOME?.trim() || join(home, ".hermes");
-const autohandHome = process.env.AUTOHAND_HOME?.trim() || join(home, ".autohand");
+const home$1 = homedir();
+const configHome = xdgConfig ?? join(home$1, ".config");
+const codexHome = process.env.CODEX_HOME?.trim() || join(home$1, ".codex");
+const claudeHome$1 = process.env.CLAUDE_CONFIG_DIR?.trim() || join(home$1, ".claude");
+const vibeHome = process.env.VIBE_HOME?.trim() || join(home$1, ".vibe");
+const hermesHome = process.env.HERMES_HOME?.trim() || join(home$1, ".hermes");
+const autohandHome = process.env.AUTOHAND_HOME?.trim() || join(home$1, ".autohand");
 const zedAppDataHome = process.env.APPDATA?.trim();
 const zedFlatpakConfigHome = process.env.FLATPAK_XDG_CONFIG_HOME?.trim();
-function getOpenClawGlobalSkillsDir(homeDir = home, pathExists = existsSync) {
+function getOpenClawGlobalSkillsDir(homeDir = home$1, pathExists = existsSync) {
 	if (pathExists(join(homeDir, ".openclaw"))) return join(homeDir, ".openclaw/skills");
 	if (pathExists(join(homeDir, ".clawdbot"))) return join(homeDir, ".clawdbot/skills");
 	if (pathExists(join(homeDir, ".moltbot"))) return join(homeDir, ".moltbot/skills");
@@ -946,9 +946,9 @@ const agents = {
 		name: "aider-desk",
 		displayName: "AiderDesk",
 		skillsDir: ".aider-desk/skills",
-		globalSkillsDir: join(home, ".aider-desk/skills"),
+		globalSkillsDir: join(home$1, ".aider-desk/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".aider-desk"));
+			return existsSync(join(home$1, ".aider-desk"));
 		}
 	},
 	amp: {
@@ -964,27 +964,27 @@ const agents = {
 		name: "antigravity",
 		displayName: "Antigravity",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".gemini/antigravity/skills"),
+		globalSkillsDir: join(home$1, ".gemini/antigravity/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".gemini/antigravity"));
+			return existsSync(join(home$1, ".gemini/antigravity"));
 		}
 	},
 	"antigravity-cli": {
 		name: "antigravity-cli",
 		displayName: "Antigravity CLI",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".gemini/antigravity-cli/skills"),
+		globalSkillsDir: join(home$1, ".gemini/antigravity-cli/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".gemini/antigravity-cli"));
+			return existsSync(join(home$1, ".gemini/antigravity-cli"));
 		}
 	},
 	astrbot: {
 		name: "astrbot",
 		displayName: "AstrBot",
 		skillsDir: "data/skills",
-		globalSkillsDir: join(home, ".astrbot/data/skills"),
+		globalSkillsDir: join(home$1, ".astrbot/data/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(process.cwd(), "data/skills")) || existsSync(join(home, ".astrbot"));
+			return existsSync(join(process.cwd(), "data/skills")) || existsSync(join(home$1, ".astrbot"));
 		}
 	},
 	"autohand-code": {
@@ -1000,27 +1000,27 @@ const agents = {
 		name: "augment",
 		displayName: "Augment",
 		skillsDir: ".augment/skills",
-		globalSkillsDir: join(home, ".augment/skills"),
+		globalSkillsDir: join(home$1, ".augment/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".augment"));
+			return existsSync(join(home$1, ".augment"));
 		}
 	},
 	bob: {
 		name: "bob",
 		displayName: "IBM Bob",
 		skillsDir: ".bob/skills",
-		globalSkillsDir: join(home, ".bob/skills"),
+		globalSkillsDir: join(home$1, ".bob/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".bob"));
+			return existsSync(join(home$1, ".bob"));
 		}
 	},
 	"claude-code": {
 		name: "claude-code",
 		displayName: "Claude Code",
 		skillsDir: ".claude/skills",
-		globalSkillsDir: join(claudeHome, "skills"),
+		globalSkillsDir: join(claudeHome$1, "skills"),
 		detectInstalled: async () => {
-			return existsSync(claudeHome);
+			return existsSync(claudeHome$1);
 		}
 	},
 	openclaw: {
@@ -1029,52 +1029,52 @@ const agents = {
 		skillsDir: "skills",
 		globalSkillsDir: getOpenClawGlobalSkillsDir(),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".openclaw")) || existsSync(join(home, ".clawdbot")) || existsSync(join(home, ".moltbot"));
+			return existsSync(join(home$1, ".openclaw")) || existsSync(join(home$1, ".clawdbot")) || existsSync(join(home$1, ".moltbot"));
 		}
 	},
 	cline: {
 		name: "cline",
 		displayName: "Cline",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".agents", "skills"),
+		globalSkillsDir: join(home$1, ".agents", "skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".cline"));
+			return existsSync(join(home$1, ".cline"));
 		}
 	},
 	"codearts-agent": {
 		name: "codearts-agent",
 		displayName: "CodeArts Agent",
 		skillsDir: ".codeartsdoer/skills",
-		globalSkillsDir: join(home, ".codeartsdoer/skills"),
+		globalSkillsDir: join(home$1, ".codeartsdoer/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".codeartsdoer"));
+			return existsSync(join(home$1, ".codeartsdoer"));
 		}
 	},
 	codebuddy: {
 		name: "codebuddy",
 		displayName: "CodeBuddy",
 		skillsDir: ".codebuddy/skills",
-		globalSkillsDir: join(home, ".codebuddy/skills"),
+		globalSkillsDir: join(home$1, ".codebuddy/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(process.cwd(), ".codebuddy")) || existsSync(join(home, ".codebuddy"));
+			return existsSync(join(process.cwd(), ".codebuddy")) || existsSync(join(home$1, ".codebuddy"));
 		}
 	},
 	codemaker: {
 		name: "codemaker",
 		displayName: "Codemaker",
 		skillsDir: ".codemaker/skills",
-		globalSkillsDir: join(home, ".codemaker/skills"),
+		globalSkillsDir: join(home$1, ".codemaker/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".codemaker"));
+			return existsSync(join(home$1, ".codemaker"));
 		}
 	},
 	codestudio: {
 		name: "codestudio",
 		displayName: "Code Studio",
 		skillsDir: ".codestudio/skills",
-		globalSkillsDir: join(home, ".codestudio/skills"),
+		globalSkillsDir: join(home$1, ".codestudio/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".codestudio"));
+			return existsSync(join(home$1, ".codestudio"));
 		}
 	},
 	codex: {
@@ -1090,54 +1090,54 @@ const agents = {
 		name: "command-code",
 		displayName: "Command Code",
 		skillsDir: ".commandcode/skills",
-		globalSkillsDir: join(home, ".commandcode/skills"),
+		globalSkillsDir: join(home$1, ".commandcode/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".commandcode"));
+			return existsSync(join(home$1, ".commandcode"));
 		}
 	},
 	continue: {
 		name: "continue",
 		displayName: "Continue",
 		skillsDir: ".continue/skills",
-		globalSkillsDir: join(home, ".continue/skills"),
+		globalSkillsDir: join(home$1, ".continue/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(process.cwd(), ".continue")) || existsSync(join(home, ".continue"));
+			return existsSync(join(process.cwd(), ".continue")) || existsSync(join(home$1, ".continue"));
 		}
 	},
 	cortex: {
 		name: "cortex",
 		displayName: "Cortex Code",
 		skillsDir: ".cortex/skills",
-		globalSkillsDir: join(home, ".snowflake/cortex/skills"),
+		globalSkillsDir: join(home$1, ".snowflake/cortex/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".snowflake/cortex"));
+			return existsSync(join(home$1, ".snowflake/cortex"));
 		}
 	},
 	crush: {
 		name: "crush",
 		displayName: "Crush",
 		skillsDir: ".crush/skills",
-		globalSkillsDir: join(home, ".config/crush/skills"),
+		globalSkillsDir: join(home$1, ".config/crush/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".config/crush"));
+			return existsSync(join(home$1, ".config/crush"));
 		}
 	},
 	cursor: {
 		name: "cursor",
 		displayName: "Cursor",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".cursor/skills"),
+		globalSkillsDir: join(home$1, ".cursor/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".cursor"));
+			return existsSync(join(home$1, ".cursor"));
 		}
 	},
 	deepagents: {
 		name: "deepagents",
 		displayName: "Deep Agents",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".deepagents/agent/skills"),
+		globalSkillsDir: join(home$1, ".deepagents/agent/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".deepagents"));
+			return existsSync(join(home$1, ".deepagents"));
 		}
 	},
 	devin: {
@@ -1153,56 +1153,56 @@ const agents = {
 		name: "dexto",
 		displayName: "Dexto",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".agents/skills"),
+		globalSkillsDir: join(home$1, ".agents/skills"),
 		showInUniversalPrompt: false,
 		detectInstalled: async () => {
-			return existsSync(join(home, ".dexto"));
+			return existsSync(join(home$1, ".dexto"));
 		}
 	},
 	droid: {
 		name: "droid",
 		displayName: "Droid",
 		skillsDir: ".factory/skills",
-		globalSkillsDir: join(home, ".factory/skills"),
+		globalSkillsDir: join(home$1, ".factory/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".factory"));
+			return existsSync(join(home$1, ".factory"));
 		}
 	},
 	firebender: {
 		name: "firebender",
 		displayName: "Firebender",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".firebender/skills"),
+		globalSkillsDir: join(home$1, ".firebender/skills"),
 		showInUniversalPrompt: false,
 		detectInstalled: async () => {
-			return existsSync(join(home, ".firebender"));
+			return existsSync(join(home$1, ".firebender"));
 		}
 	},
 	forgecode: {
 		name: "forgecode",
 		displayName: "ForgeCode",
 		skillsDir: ".forge/skills",
-		globalSkillsDir: join(home, ".forge/skills"),
+		globalSkillsDir: join(home$1, ".forge/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".forge"));
+			return existsSync(join(home$1, ".forge"));
 		}
 	},
 	"gemini-cli": {
 		name: "gemini-cli",
 		displayName: "Gemini CLI",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".gemini/skills"),
+		globalSkillsDir: join(home$1, ".gemini/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".gemini"));
+			return existsSync(join(home$1, ".gemini"));
 		}
 	},
 	"github-copilot": {
 		name: "github-copilot",
 		displayName: "GitHub Copilot",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".copilot/skills"),
+		globalSkillsDir: join(home$1, ".copilot/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".copilot"));
+			return existsSync(join(home$1, ".copilot"));
 		}
 	},
 	goose: {
@@ -1227,100 +1227,100 @@ const agents = {
 		name: "inference-sh",
 		displayName: "inference.sh",
 		skillsDir: ".inferencesh/skills",
-		globalSkillsDir: join(home, ".inferencesh/skills"),
+		globalSkillsDir: join(home$1, ".inferencesh/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".inferencesh"));
+			return existsSync(join(home$1, ".inferencesh"));
 		}
 	},
 	jazz: {
 		name: "jazz",
 		displayName: "Jazz",
 		skillsDir: ".jazz/skills",
-		globalSkillsDir: join(home, ".jazz/skills"),
+		globalSkillsDir: join(home$1, ".jazz/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".jazz")) || existsSync(join(process.cwd(), ".jazz"));
+			return existsSync(join(home$1, ".jazz")) || existsSync(join(process.cwd(), ".jazz"));
 		}
 	},
 	junie: {
 		name: "junie",
 		displayName: "Junie",
 		skillsDir: ".junie/skills",
-		globalSkillsDir: join(home, ".junie/skills"),
+		globalSkillsDir: join(home$1, ".junie/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".junie"));
+			return existsSync(join(home$1, ".junie"));
 		}
 	},
 	"iflow-cli": {
 		name: "iflow-cli",
 		displayName: "iFlow CLI",
 		skillsDir: ".iflow/skills",
-		globalSkillsDir: join(home, ".iflow/skills"),
+		globalSkillsDir: join(home$1, ".iflow/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".iflow"));
+			return existsSync(join(home$1, ".iflow"));
 		}
 	},
 	kilo: {
 		name: "kilo",
 		displayName: "Kilo Code",
 		skillsDir: ".kilocode/skills",
-		globalSkillsDir: join(home, ".kilocode/skills"),
+		globalSkillsDir: join(home$1, ".kilocode/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".kilocode"));
+			return existsSync(join(home$1, ".kilocode"));
 		}
 	},
 	"kimi-code-cli": {
 		name: "kimi-code-cli",
 		displayName: "Kimi Code CLI",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".agents/skills"),
+		globalSkillsDir: join(home$1, ".agents/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".kimi-code")) || existsSync(join(home, ".kimi"));
+			return existsSync(join(home$1, ".kimi-code")) || existsSync(join(home$1, ".kimi"));
 		}
 	},
 	"kiro-cli": {
 		name: "kiro-cli",
 		displayName: "Kiro CLI",
 		skillsDir: ".kiro/skills",
-		globalSkillsDir: join(home, ".kiro/skills"),
+		globalSkillsDir: join(home$1, ".kiro/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".kiro"));
+			return existsSync(join(home$1, ".kiro"));
 		}
 	},
 	kode: {
 		name: "kode",
 		displayName: "Kode",
 		skillsDir: ".kode/skills",
-		globalSkillsDir: join(home, ".kode/skills"),
+		globalSkillsDir: join(home$1, ".kode/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".kode"));
+			return existsSync(join(home$1, ".kode"));
 		}
 	},
 	lingma: {
 		name: "lingma",
 		displayName: "Lingma",
 		skillsDir: ".lingma/skills",
-		globalSkillsDir: join(home, ".lingma/skills"),
+		globalSkillsDir: join(home$1, ".lingma/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".lingma"));
+			return existsSync(join(home$1, ".lingma"));
 		}
 	},
 	loaf: {
 		name: "loaf",
 		displayName: "Loaf",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".agents/skills"),
+		globalSkillsDir: join(home$1, ".agents/skills"),
 		showInUniversalPrompt: false,
 		detectInstalled: async () => {
-			return existsSync(join(home, ".loaf"));
+			return existsSync(join(home$1, ".loaf"));
 		}
 	},
 	mcpjam: {
 		name: "mcpjam",
 		displayName: "MCPJam",
 		skillsDir: ".mcpjam/skills",
-		globalSkillsDir: join(home, ".mcpjam/skills"),
+		globalSkillsDir: join(home$1, ".mcpjam/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".mcpjam"));
+			return existsSync(join(home$1, ".mcpjam"));
 		}
 	},
 	"mistral-vibe": {
@@ -1336,18 +1336,18 @@ const agents = {
 		name: "moxby",
 		displayName: "Moxby",
 		skillsDir: ".moxby/skills",
-		globalSkillsDir: join(home, ".moxby/skills"),
+		globalSkillsDir: join(home$1, ".moxby/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".moxby"));
+			return existsSync(join(home$1, ".moxby"));
 		}
 	},
 	mux: {
 		name: "mux",
 		displayName: "Mux",
 		skillsDir: ".mux/skills",
-		globalSkillsDir: join(home, ".mux/skills"),
+		globalSkillsDir: join(home$1, ".mux/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".mux"));
+			return existsSync(join(home$1, ".mux"));
 		}
 	},
 	opencode: {
@@ -1363,54 +1363,54 @@ const agents = {
 		name: "openhands",
 		displayName: "OpenHands",
 		skillsDir: ".openhands/skills",
-		globalSkillsDir: join(home, ".openhands/skills"),
+		globalSkillsDir: join(home$1, ".openhands/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".openhands"));
+			return existsSync(join(home$1, ".openhands"));
 		}
 	},
 	ona: {
 		name: "ona",
 		displayName: "Ona",
 		skillsDir: ".ona/skills",
-		globalSkillsDir: join(home, ".ona/skills"),
+		globalSkillsDir: join(home$1, ".ona/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".ona"));
+			return existsSync(join(home$1, ".ona"));
 		}
 	},
 	pi: {
 		name: "pi",
 		displayName: "Pi",
 		skillsDir: ".pi/skills",
-		globalSkillsDir: join(home, ".pi/agent/skills"),
+		globalSkillsDir: join(home$1, ".pi/agent/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".pi/agent"));
+			return existsSync(join(home$1, ".pi/agent"));
 		}
 	},
 	qoder: {
 		name: "qoder",
 		displayName: "Qoder",
 		skillsDir: ".qoder/skills",
-		globalSkillsDir: join(home, ".qoder/skills"),
+		globalSkillsDir: join(home$1, ".qoder/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".qoder"));
+			return existsSync(join(home$1, ".qoder"));
 		}
 	},
 	"qoder-cn": {
 		name: "qoder-cn",
 		displayName: "Qoder CN",
 		skillsDir: ".qoder/skills",
-		globalSkillsDir: join(home, ".qoder-cn/skills"),
+		globalSkillsDir: join(home$1, ".qoder-cn/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".qoder-cn"));
+			return existsSync(join(home$1, ".qoder-cn"));
 		}
 	},
 	"qwen-code": {
 		name: "qwen-code",
 		displayName: "Qwen Code",
 		skillsDir: ".qwen/skills",
-		globalSkillsDir: join(home, ".qwen/skills"),
+		globalSkillsDir: join(home$1, ".qwen/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".qwen"));
+			return existsSync(join(home$1, ".qwen"));
 		}
 	},
 	replit: {
@@ -1427,97 +1427,97 @@ const agents = {
 		name: "reasonix",
 		displayName: "Reasonix",
 		skillsDir: ".reasonix/skills",
-		globalSkillsDir: join(home, ".reasonix/skills"),
+		globalSkillsDir: join(home$1, ".reasonix/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".reasonix"));
+			return existsSync(join(home$1, ".reasonix"));
 		}
 	},
 	rovodev: {
 		name: "rovodev",
 		displayName: "Rovo Dev",
 		skillsDir: ".rovodev/skills",
-		globalSkillsDir: join(home, ".rovodev/skills"),
+		globalSkillsDir: join(home$1, ".rovodev/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".rovodev"));
+			return existsSync(join(home$1, ".rovodev"));
 		}
 	},
 	roo: {
 		name: "roo",
 		displayName: "Roo Code",
 		skillsDir: ".roo/skills",
-		globalSkillsDir: join(home, ".roo/skills"),
+		globalSkillsDir: join(home$1, ".roo/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".roo"));
+			return existsSync(join(home$1, ".roo"));
 		}
 	},
 	"tabnine-cli": {
 		name: "tabnine-cli",
 		displayName: "Tabnine CLI",
 		skillsDir: ".tabnine/agent/skills",
-		globalSkillsDir: join(home, ".tabnine/agent/skills"),
+		globalSkillsDir: join(home$1, ".tabnine/agent/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".tabnine"));
+			return existsSync(join(home$1, ".tabnine"));
 		}
 	},
 	terramind: {
 		name: "terramind",
 		displayName: "Terramind",
 		skillsDir: ".terramind/skills",
-		globalSkillsDir: join(home, ".terramind/skills"),
+		globalSkillsDir: join(home$1, ".terramind/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".terramind"));
+			return existsSync(join(home$1, ".terramind"));
 		}
 	},
 	tinycloud: {
 		name: "tinycloud",
 		displayName: "Tinycloud",
 		skillsDir: ".tinycloud/skills",
-		globalSkillsDir: join(home, ".tinycloud/skills"),
+		globalSkillsDir: join(home$1, ".tinycloud/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".tinycloud"));
+			return existsSync(join(home$1, ".tinycloud"));
 		}
 	},
 	trae: {
 		name: "trae",
 		displayName: "Trae",
 		skillsDir: ".trae/skills",
-		globalSkillsDir: join(home, ".trae/skills"),
+		globalSkillsDir: join(home$1, ".trae/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".trae"));
+			return existsSync(join(home$1, ".trae"));
 		}
 	},
 	"trae-cn": {
 		name: "trae-cn",
 		displayName: "Trae CN",
 		skillsDir: ".trae/skills",
-		globalSkillsDir: join(home, ".trae-cn/skills"),
+		globalSkillsDir: join(home$1, ".trae-cn/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".trae-cn"));
+			return existsSync(join(home$1, ".trae-cn"));
 		}
 	},
 	warp: {
 		name: "warp",
 		displayName: "Warp",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".agents/skills"),
+		globalSkillsDir: join(home$1, ".agents/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".warp"));
+			return existsSync(join(home$1, ".warp"));
 		}
 	},
 	windsurf: {
 		name: "windsurf",
 		displayName: "Windsurf",
 		skillsDir: ".windsurf/skills",
-		globalSkillsDir: join(home, ".codeium/windsurf/skills"),
+		globalSkillsDir: join(home$1, ".codeium/windsurf/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".codeium/windsurf"));
+			return existsSync(join(home$1, ".codeium/windsurf"));
 		}
 	},
 	zed: {
 		name: "zed",
 		displayName: "Zed",
 		skillsDir: ".agents/skills",
-		globalSkillsDir: join(home, ".agents/skills"),
+		globalSkillsDir: join(home$1, ".agents/skills"),
 		detectInstalled: async () => {
 			return existsSync(join(configHome, "zed")) || !!zedAppDataHome && existsSync(join(zedAppDataHome, "Zed")) || !!zedFlatpakConfigHome && existsSync(join(zedFlatpakConfigHome, "zed"));
 		}
@@ -1526,36 +1526,36 @@ const agents = {
 		name: "zencoder",
 		displayName: "Zencoder",
 		skillsDir: ".zencoder/skills",
-		globalSkillsDir: join(home, ".zencoder/skills"),
+		globalSkillsDir: join(home$1, ".zencoder/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".zencoder"));
+			return existsSync(join(home$1, ".zencoder"));
 		}
 	},
 	zenflow: {
 		name: "zenflow",
 		displayName: "Zenflow",
 		skillsDir: ".zencoder/skills",
-		globalSkillsDir: join(home, ".zencoder/skills"),
+		globalSkillsDir: join(home$1, ".zencoder/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".zencoder"));
+			return existsSync(join(home$1, ".zencoder"));
 		}
 	},
 	neovate: {
 		name: "neovate",
 		displayName: "Neovate",
 		skillsDir: ".neovate/skills",
-		globalSkillsDir: join(home, ".neovate/skills"),
+		globalSkillsDir: join(home$1, ".neovate/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".neovate"));
+			return existsSync(join(home$1, ".neovate"));
 		}
 	},
 	pochi: {
 		name: "pochi",
 		displayName: "Pochi",
 		skillsDir: ".pochi/skills",
-		globalSkillsDir: join(home, ".pochi/skills"),
+		globalSkillsDir: join(home$1, ".pochi/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".pochi"));
+			return existsSync(join(home$1, ".pochi"));
 		}
 	},
 	promptscript: {
@@ -1572,9 +1572,9 @@ const agents = {
 		name: "adal",
 		displayName: "AdaL",
 		skillsDir: ".adal/skills",
-		globalSkillsDir: join(home, ".adal/skills"),
+		globalSkillsDir: join(home$1, ".adal/skills"),
 		detectInstalled: async () => {
-			return existsSync(join(home, ".adal"));
+			return existsSync(join(home$1, ".adal"));
 		}
 	},
 	universal: {
@@ -3997,7 +3997,7 @@ function parseAddOptions(args) {
 		options
 	};
 }
-const execFileAsync$3 = promisify(execFile);
+const execFileAsync$4 = promisify(execFile);
 const claudeAgentsDir = (global) => global ? join(process.env.CLAUDE_CONFIG_DIR?.trim() || join(homedir(), ".claude"), "agents") : join(process.cwd(), ".claude", "agents");
 async function fetchAgentFile(source, name) {
 	const rel = `agents/${name}.md`;
@@ -4006,7 +4006,7 @@ async function fetchAgentFile(source, name) {
 		return existsSync(file) ? readFile(file, "utf8") : null;
 	}
 	if (/^[^/]+\/[^/]+$/.test(source)) try {
-		const { stdout } = await execFileAsync$3("gh", [
+		const { stdout } = await execFileAsync$4("gh", [
 			"api",
 			`repos/${source}/contents/${rel}`,
 			"--jq",
@@ -4103,7 +4103,7 @@ async function runAgents(args) {
 	console.log(`Unknown agents command: ${sub}`);
 	console.log(AGENTS_HELP);
 }
-const execFileAsync$2 = promisify(execFile);
+const execFileAsync$3 = promisify(execFile);
 const RULE_SCOPES = [
 	"client",
 	"server",
@@ -4120,7 +4120,7 @@ async function fetchFromCatalog(source, rel) {
 		return existsSync(file) ? readFile(file, "utf8") : null;
 	}
 	if (/^[^/]+\/[^/]+$/.test(source)) try {
-		const { stdout } = await execFileAsync$2("gh", [
+		const { stdout } = await execFileAsync$3("gh", [
 			"api",
 			`repos/${source}/contents/${rel}`,
 			"--jq",
@@ -4249,7 +4249,7 @@ async function runRules(args) {
 	const { names, options } = parseRulesOptions(sub === "add" || sub === "a" || sub === "install" || sub === "i" ? args.slice(1) : args);
 	await addRules(names, options);
 }
-const execFileAsync$1 = promisify(execFile);
+const execFileAsync$2 = promisify(execFile);
 const RESET$3 = "\x1B[0m";
 const BOLD$3 = "\x1B[1m";
 const DIM$3 = "\x1B[38;5;102m";
@@ -4268,7 +4268,7 @@ async function fetchCatalogIndex(source) {
 		return JSON.parse(raw);
 	}
 	if (source.match(/^[^/]+\/[^/]+$/)) {
-		const { stdout } = await execFileAsync$1("gh", [
+		const { stdout } = await execFileAsync$2("gh", [
 			"api",
 			`repos/${source}/contents/${rel}`,
 			"--jq",
@@ -7830,7 +7830,7 @@ function registerVault(vaultPath) {
 	writeFileSync(configPath, JSON.stringify(config), "utf-8");
 	M.success("Registered vault in Obsidian");
 }
-const execFileAsync = promisify(execFile);
+const execFileAsync$1 = promisify(execFile);
 const BUZZ_LOGO_LINES = [
 	"██████╗ ██╗   ██╗███████╗███████╗",
 	"██╔══██╗██║   ██║╚══███╔╝╚══███╔╝",
@@ -7946,7 +7946,7 @@ const TEAM_AGENTS = {
 const TEAMS = Object.keys(TEAM_SKILLS);
 async function isBuzzRunning() {
 	try {
-		const { stdout } = await execFileAsync("pgrep", ["-f", "Buzz.app|buzz-desktop|buzz-acp"]);
+		const { stdout } = await execFileAsync$1("pgrep", ["-f", "Buzz.app|buzz-desktop|buzz-acp"]);
 		return stdout.trim().length > 0;
 	} catch {
 		return false;
@@ -7954,7 +7954,7 @@ async function isBuzzRunning() {
 }
 async function claudeAuthStatus() {
 	try {
-		const { stdout } = await execFileAsync("claude", ["auth", "status"]);
+		const { stdout } = await execFileAsync$1("claude", ["auth", "status"]);
 		const parsed = JSON.parse(stdout);
 		const ok = parsed.apiProvider === "firstParty";
 		return {
@@ -7997,14 +7997,14 @@ async function syncVault() {
 	M.step("Pruff knowledge vault");
 	const dest = join(nestDir(), "REPOS", "pruff-knowledge");
 	if (existsSync(join(dest, ".git"))) try {
-		await execFileAsync("git", [
+		await execFileAsync$1("git", [
 			"-C",
 			dest,
 			"pull",
 			"--ff-only",
 			"--quiet"
 		]);
-		const { stdout } = await execFileAsync("git", [
+		const { stdout } = await execFileAsync$1("git", [
 			"-C",
 			dest,
 			"log",
@@ -8020,13 +8020,13 @@ async function syncVault() {
 	else {
 		mkdirSync(dirname(dest), { recursive: true });
 		try {
-			await execFileAsync("git", [
+			await execFileAsync$1("git", [
 				"clone",
 				"--quiet",
 				VAULT_REPO,
 				dest
 			]);
-			const { stdout } = await execFileAsync("git", [
+			const { stdout } = await execFileAsync$1("git", [
 				"-C",
 				dest,
 				"log",
@@ -8319,6 +8319,310 @@ async function runBuzz(args) {
 			console.log(BUZZ_HELP);
 	}
 }
+const execFileAsync = promisify(execFile);
+const __analyticsDirname = dirname(fileURLToPath(import.meta.url));
+const POSTHOG_HOST = "https://us.i.posthog.com";
+const ANALYTICS_TOKEN_CATALOG_PATH = "analytics/posthog.json";
+let cachedToken = null;
+async function getAnalyticsToken() {
+	const fromEnv = process.env.PRUFF_ANALYTICS_POSTHOG_TOKEN?.trim();
+	if (fromEnv) return fromEnv;
+	if (cachedToken !== null) return cachedToken;
+	const raw = readLocalCheckoutToken() ?? await fetchTokenFile(PRUFF_CATALOG, ANALYTICS_TOKEN_CATALOG_PATH);
+	cachedToken = raw ? JSON.parse(raw).token ?? "" : "";
+	return cachedToken;
+}
+function readLocalCheckoutToken() {
+	let dir = __analyticsDirname;
+	for (let depth = 0; depth < 4; depth++) {
+		const candidate = join(dir, ANALYTICS_TOKEN_CATALOG_PATH);
+		if (existsSync(candidate)) return readFileSync(candidate, "utf-8");
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+async function fetchTokenFile(source, rel) {
+	if (source.startsWith(".") || isAbsolute(source)) {
+		const file = join(source, rel);
+		return existsSync(file) ? readFileSync(file, "utf-8") : null;
+	}
+	if (/^[^/]+\/[^/]+$/.test(source)) try {
+		const { stdout } = await execFileAsync("gh", [
+			"api",
+			`repos/${source}/contents/${rel}`,
+			"--jq",
+			".content"
+		], { env: {
+			...process.env,
+			GIT_TERMINAL_PROMPT: "0"
+		} });
+		return Buffer.from(stdout.trim(), "base64").toString("utf8");
+	} catch {
+		return null;
+	}
+	return null;
+}
+const home = homedir();
+const claudeHome = () => process.env.CLAUDE_CONFIG_DIR?.trim() || join(home, ".claude");
+const claudeSettingsPath = () => join(claudeHome(), "settings.json");
+function buildAnalyticsEnv(token, options = {}) {
+	return {
+		...options.withToolDetails ? { OTEL_LOG_TOOL_DETAILS: "1" } : {},
+		CLAUDE_CODE_ENABLE_TELEMETRY: "1",
+		OTEL_LOGS_EXPORTER: "otlp",
+		OTEL_METRICS_EXPORTER: "otlp",
+		OTEL_EXPORTER_OTLP_PROTOCOL: "http/protobuf",
+		OTEL_EXPORTER_OTLP_LOGS_ENDPOINT: `${POSTHOG_HOST}/i/v1/logs`,
+		OTEL_EXPORTER_OTLP_METRICS_ENDPOINT: `${POSTHOG_HOST}/i/v1/metrics`,
+		OTEL_EXPORTER_OTLP_LOGS_HEADERS: `Authorization=Bearer ${token}`,
+		OTEL_EXPORTER_OTLP_METRICS_HEADERS: `Authorization=Bearer ${token}`,
+		OTEL_SERVICE_NAME: "claude-code",
+		OTEL_RESOURCE_ATTRIBUTES: "pruff.rollout=team",
+		OTEL_METRICS_INCLUDE_SESSION_ID: "false",
+		OTEL_LOG_USER_PROMPTS: "0",
+		OTEL_LOG_ASSISTANT_RESPONSES: "0"
+	};
+}
+const ANALYTICS_ENV_KEYS = Object.keys(buildAnalyticsEnv("x", { withToolDetails: true }));
+function readClaudeSettings() {
+	const path = claudeSettingsPath();
+	if (!existsSync(path)) return {};
+	try {
+		const parsed = JSON.parse(readFileSync(path, "utf-8"));
+		return parsed && typeof parsed === "object" ? parsed : {};
+	} catch {
+		throw new Error(`${path} is not valid JSON. Fix it (or move it aside) before running this command.`);
+	}
+}
+function writeClaudeSettings(settings) {
+	mkdirSync(claudeHome(), { recursive: true });
+	writeFileSync(claudeSettingsPath(), `${JSON.stringify(settings, null, 2)}\n`, "utf-8");
+}
+function applyAnalyticsEnv(settings, token, options = {}) {
+	const base = stripAnalyticsEnv(settings);
+	return {
+		...base,
+		env: {
+			...base.env ?? {},
+			...buildAnalyticsEnv(token, options)
+		}
+	};
+}
+function stripAnalyticsEnv(settings) {
+	if (!settings.env) return settings;
+	const env = { ...settings.env };
+	for (const key of ANALYTICS_ENV_KEYS) delete env[key];
+	const next = { ...settings };
+	if (Object.keys(env).length === 0) delete next.env;
+	else next.env = env;
+	return next;
+}
+function isAnalyticsEnabled(settings = readClaudeSettings()) {
+	return settings.env?.CLAUDE_CODE_ENABLE_TELEMETRY === "1";
+}
+async function requireToken() {
+	const token = await getAnalyticsToken();
+	if (token.startsWith("phc_")) return token;
+	console.log();
+	console.log(import_picocolors.default.red("  Could not resolve the PostHog project token."));
+	console.log(import_picocolors.default.dim(`  Looked in three places, in order:
+    1. \$PRUFF_ANALYTICS_POSTHOG_TOKEN (unset)
+    2. ${ANALYTICS_TOKEN_CATALOG_PATH} in this checkout (not found)\n    3. ${ANALYTICS_TOKEN_CATALOG_PATH} in ${PRUFF_CATALOG} via gh (not found)\n  Expected a file containing {"token":"phc_..."}.\n  Check \`gh auth status\` — the catalog is private and read with your own
+  GitHub auth. To test without the catalog, export PRUFF_ANALYTICS_POSTHOG_TOKEN.`));
+	console.log();
+	return null;
+}
+async function runStatus() {
+	const settings = readClaudeSettings();
+	const enabled = isAnalyticsEnabled(settings);
+	const token = await getAnalyticsToken();
+	console.log();
+	console.log(`  ${import_picocolors.default.bold("Usage analytics")}  ${enabled ? import_picocolors.default.green("on") : import_picocolors.default.dim("off")}`);
+	console.log(`  ${import_picocolors.default.dim("settings")}  ${claudeSettingsPath()}`);
+	if (enabled) {
+		console.log(`  ${import_picocolors.default.dim("logs")}      ${settings.env?.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT}`);
+		console.log(`  ${import_picocolors.default.dim("metrics")}   ${settings.env?.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT}`);
+		console.log(`  ${import_picocolors.default.dim("token")}     ${token ? `${token.slice(0, 12)}…` : import_picocolors.default.red("missing")}`);
+		console.log(`  ${import_picocolors.default.dim("prompts")}   not exported (OTEL_LOG_USER_PROMPTS=0)`);
+		const toolDetails = settings.env?.OTEL_LOG_TOOL_DETAILS === "1";
+		console.log(`  ${import_picocolors.default.dim("cmds")}      ${toolDetails ? import_picocolors.default.yellow("EXPORTED verbatim (--with-tool-details on)") : "not exported — skills report as \"custom_skill\""}`);
+	}
+	console.log();
+	console.log(import_picocolors.default.dim(enabled ? "  Turn it off with: npx pruff-skills analytics disable" : "  Turn it on with:  npx pruff-skills analytics enable"));
+	console.log();
+}
+async function runEnable(args) {
+	const withToolDetails = args.includes("--with-tool-details");
+	const token = await requireToken();
+	if (!token) return;
+	const settings = readClaudeSettings();
+	const already = isAnalyticsEnabled(settings);
+	writeClaudeSettings(applyAnalyticsEnv(settings, token, { withToolDetails }));
+	console.log();
+	console.log(`  ${import_picocolors.default.green("✓")} Usage analytics ${already ? "refreshed" : "enabled"} in ${import_picocolors.default.dim(claudeSettingsPath())}`);
+	console.log();
+	console.log(`  ${import_picocolors.default.dim("Exports")}  token + cost usage, tool names, results and timings,`);
+	console.log(`  ${import_picocolors.default.dim("        ")}  MCP tool calls, model, subagent vs main, your email.`);
+	console.log(`  ${import_picocolors.default.dim("Never")}    prompts, responses, file contents, raw API bodies.`);
+	console.log();
+	if (withToolDetails) {
+		console.log(`  ${import_picocolors.default.yellow("!")} ${import_picocolors.default.bold("--with-tool-details is ON.")}`);
+		console.log(import_picocolors.default.dim("    Real skill and slash-command names will be exported — and so will"));
+		console.log(import_picocolors.default.dim("    every shell command and tool input, verbatim. Anything you type into"));
+		console.log(import_picocolors.default.dim("    a command (RUTs, connection strings, tokens) reaches PostHog."));
+		console.log(import_picocolors.default.dim("    Turn it back off by re-running `analytics enable` without the flag."));
+	} else {
+		console.log(import_picocolors.default.dim("  Pruff-authored skills report as \"custom_skill\", not their real names."));
+		console.log(import_picocolors.default.dim("  `analytics enable --with-tool-details` unlocks the names — read what that"));
+		console.log(import_picocolors.default.dim("  also exports first: npx pruff-skills analytics --help"));
+	}
+	console.log();
+	console.log(`  ${import_picocolors.default.bold("Restart Claude Code")} — the OTEL exporter is read once at session start.`);
+	console.log(import_picocolors.default.dim("  Then confirm the pipeline works: npx pruff-skills analytics verify"));
+	console.log();
+}
+function runDisable() {
+	writeClaudeSettings(stripAnalyticsEnv(readClaudeSettings()));
+	console.log();
+	console.log(`  ${import_picocolors.default.green("✓")} Usage analytics disabled — the env block is gone from`);
+	console.log(import_picocolors.default.dim(`  ${claudeSettingsPath()}, your own keys untouched.`));
+	console.log(import_picocolors.default.dim("  Nothing turns it back on: only `analytics enable` ever writes it."));
+	console.log(import_picocolors.default.dim("  Restart Claude Code to stop the current session exporting."));
+	console.log();
+}
+async function verifyToken(token) {
+	try {
+		const res = await fetch(`${POSTHOG_HOST}/flags?v=2`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				api_key: token,
+				distinct_id: "pruff-analytics-verify"
+			})
+		});
+		if (res.ok) {
+			console.log(`  ${import_picocolors.default.green("✓")} Token accepted by PostHog (HTTP ${res.status}).`);
+			return true;
+		}
+		console.log(`  ${import_picocolors.default.red("✗")} Token rejected (HTTP ${res.status}).`);
+		console.log(import_picocolors.default.dim(`  ${ANALYTICS_TOKEN_CATALOG_PATH} in ${PRUFF_CATALOG} does not hold a valid`));
+		console.log(import_picocolors.default.dim("  project token for the Pruff PostHog project."));
+		return false;
+	} catch (error) {
+		console.log(`  ${import_picocolors.default.red("✗")} Could not reach PostHog: ${error instanceof Error ? error.message : error}`);
+		return false;
+	}
+}
+async function runVerify() {
+	const token = await requireToken();
+	if (!token) return;
+	console.log();
+	console.log(import_picocolors.default.dim(`  POST ${POSTHOG_HOST}/flags?v=2   ${import_picocolors.default.dim("(does this token exist?)")}`));
+	if (!await verifyToken(token)) {
+		console.log();
+		return;
+	}
+	const endpoint = `${POSTHOG_HOST}/i/v1/logs`;
+	const body = { resourceLogs: [{
+		resource: { attributes: [{
+			key: "service.name",
+			value: { stringValue: "claude-code" }
+		}, {
+			key: "pruff.rollout",
+			value: { stringValue: "team" }
+		}] },
+		scopeLogs: [{ logRecords: [{
+			timeUnixNano: `${Date.now() * 1e6}`,
+			severityText: "INFO",
+			body: { stringValue: "pruff_analytics_verify" },
+			attributes: [{
+				key: "pruff.verify",
+				value: { boolValue: true }
+			}]
+		}] }]
+	}] };
+	console.log(import_picocolors.default.dim(`  POST ${endpoint}   ${import_picocolors.default.dim("(does the OTLP path accept our payload?)")}`));
+	try {
+		const res = await fetch(endpoint, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${token}`
+			},
+			body: JSON.stringify(body)
+		});
+		if (res.ok) console.log(`  ${import_picocolors.default.green("✓")} Payload accepted (HTTP ${res.status}).`);
+		else {
+			console.log(`  ${import_picocolors.default.red("✗")} Rejected (HTTP ${res.status}).`);
+			console.log(import_picocolors.default.dim(`  ${(await res.text()).slice(0, 300)}`));
+			console.log();
+			return;
+		}
+	} catch (error) {
+		console.log(`  ${import_picocolors.default.red("✗")} Request failed: ${error instanceof Error ? error.message : error}`);
+		console.log();
+		return;
+	}
+	console.log();
+	console.log(`  ${import_picocolors.default.bold("Last step — confirm it landed:")}`);
+	console.log(import_picocolors.default.dim(`  PostHog → Logs, filter service = "claude-code", search "pruff_analytics_verify".`));
+	console.log(import_picocolors.default.dim("  If the token check passed but nothing appears within a minute or two,"));
+	console.log(import_picocolors.default.dim("  the project has log ingestion disabled or is over quota."));
+	console.log();
+}
+function showAnalyticsHelp() {
+	console.log(`
+${import_picocolors.default.bold("Usage:")} pruff-skills analytics <command>
+
+  status                     Show whether Claude Code is exporting to PostHog (default)
+  enable [--with-tool-details]  Turn the exporter on in ~/.claude/settings.json
+  disable                    Turn the exporter off again
+  verify                     Prove the PostHog ingest path works
+
+${import_picocolors.default.bold("What is exported by default")}
+  Token and cost usage, model, subagent vs main agent, tool names with their
+  success and duration, MCP tool calls, session and prompt counts, your email.
+
+${import_picocolors.default.bold("What is never exported")}
+  Your prompts, Claude's responses, file contents and raw API bodies.
+
+${import_picocolors.default.bold("--with-tool-details")}
+  Unlocks real skill and slash-command names, which are otherwise anonymized to
+  "custom_skill" / "custom". It ALSO exports every shell command and tool input
+  verbatim — measured, not theoretical. Off by default: Pruff's own rule is that
+  RUTs, SII credentials and API keys are never logged. MCP attribution does not
+  need this flag; mcp_server.name and mcp_tool.name are exported either way.
+`);
+}
+async function runAnalytics(args = []) {
+	const sub = args[0];
+	switch (sub) {
+		case void 0:
+		case "status":
+			await runStatus();
+			break;
+		case "enable":
+		case "on":
+			await runEnable(args.slice(1));
+			break;
+		case "disable":
+		case "off":
+			runDisable();
+			break;
+		case "verify":
+			await runVerify();
+			break;
+		case "--help":
+		case "-h":
+			showAnalyticsHelp();
+			break;
+		default:
+			console.log(`Unknown analytics command: ${sub}`);
+			showAnalyticsHelp();
+	}
+}
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function getVersion() {
 	try {
@@ -8461,6 +8765,14 @@ ${BOLD}Rules:${RESET}
   rules add --scope <client|server|common>
                        Install a whole repo's rule set (client/server also pull in common)
 
+${BOLD}Usage analytics:${RESET}
+  analytics status     Is Claude Code reporting usage to Pruff's PostHog? (alias: telemetry)
+  analytics enable     Turn it on in ~/.claude/settings.json
+  analytics disable    Turn it off again, leaving your own env keys untouched
+  analytics verify     Prove the PostHog ingest path works before trusting it
+                       ${DIM}Reports token/cost by skill, MCP tool, subagent and model.${RESET}
+                       ${DIM}Never exports prompts, responses or file contents.${RESET}
+
 ${BOLD}Onboarding:${RESET}
   onboarding [dir]     Set up a new machine (macOS), end to end: prerequisites +
                        GitHub auth, Claude Code, Obsidian, Bun, clone the
@@ -8684,6 +8996,10 @@ async function main() {
 			if (!inAgent) await showBuzzLogo();
 			await runBuzz(restArgs);
 			break;
+		case "analytics":
+		case "telemetry":
+			await runAnalytics(restArgs);
+			break;
 		case "onboarding":
 		case "onboard":
 			if (!inAgent) {

package/package.json

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