@prave/cli 1.0.10 → 1.1.1

package/dist/commands/conflicts.js

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { requireAuth } from '../lib/credentials.js';
 import { log } from '../utils/logger.js';
@@ -18,6 +19,7 @@ function describe(c) {
     }
 }
 export async function conflictsCommand(opts = {}) {
+    track('cli_conflicts', { fix: !!opts.fix });
     const _session = await requireAuth("prave conflicts");
     if (!_session)
         return;

package/dist/commands/deploy.js

@@ -4,6 +4,7 @@ import { join } from 'node:path';
 import chalk from 'chalk';
 import ora from 'ora';
 import { AGENT_REGISTRY } from '@prave/shared';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { requireAuth } from '../lib/credentials.js';
 import { fetchMyPlan, formatUpgradeHint } from '../lib/plan.js';
@@ -71,6 +72,7 @@ function buildDestPath(agent, basePath, os, slug) {
     };
 }
 export async function deployCommand(skillName, opts = {}) {
+    track('cli_deploy', { slug: skillName, agent: opts.agent ?? 'all', dry_run: !!opts.dryRun });
     try {
         assertSlug(skillName);
     }

package/dist/commands/find.js

@@ -2,6 +2,7 @@ import { createInterface } from 'node:readline/promises';
 import chalk from 'chalk';
 import ora from 'ora';
 import { tokenTier } from '@prave/shared';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { log } from '../utils/logger.js';
 const TIER_EMOJI = {
@@ -28,6 +29,10 @@ function renderResult(r, idx) {
         log.dim(`   ${r.description}`);
 }
 export async function findCommand(query, opts = {}) {
+    track('cli_find', {
+        length: query.length,
+        mode: opts.smart ? 'smart' : opts.local ? 'local' : opts.marketplace ? 'marketplace' : 'both',
+    });
     const scope = opts.local
         ? 'local'
         : opts.marketplace

package/dist/commands/import.js

@@ -2,6 +2,7 @@ import { readdir, readFile, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import chalk from 'chalk';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { api } from '../lib/api.js';
 import { CONFIG } from '../lib/config.js';
 import { loadCredentials, requireAuth } from '../lib/credentials.js';
@@ -17,6 +18,10 @@ import { log } from '../utils/logger.js';
  * accidentally publishing private notes to the registry.
  */
 export async function importCommand(opts) {
+    track('cli_import', {
+        upload: !!opts.upload,
+        visibility: opts.public ? 'public' : opts.private ? 'private' : null,
+    });
     // `prave import` (without --upload) only inspects local files and posts
     // to /intelligence/analyze if logged in — uploads, however, must always
     // be tracked, so we gate on auth whenever --upload is set.

package/dist/commands/install.js

@@ -3,6 +3,7 @@ import { join } from 'node:path';
 import { createInterface } from 'node:readline/promises';
 import chalk from 'chalk';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { CONFIG } from '../lib/config.js';
 import { loadCredentials, requireAuth } from '../lib/credentials.js';
@@ -20,6 +21,7 @@ import { log } from '../utils/logger.js';
  *     instead of letting the API error bubble.
  */
 export async function installCommand(slug, opts = {}) {
+    track('cli_install', { slug, no_deps: !!opts.noDeps, force: !!opts.force });
     try {
         assertSlug(slug);
     }

package/dist/commands/list.js

@@ -2,6 +2,7 @@ import { readdir, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import chalk from 'chalk';
 import { tokenTier } from '@prave/shared';
+import { track } from '../lib/analytics.js';
 import { api } from '../lib/api.js';
 import { CONFIG } from '../lib/config.js';
 import { log } from '../utils/logger.js';
@@ -39,6 +40,12 @@ async function readLocalSlugs() {
     }
 }
 export async function listCommand(opts = {}) {
+    track('cli_list', {
+        remote: !!opts.remote,
+        verbose: !!opts.verbose,
+        conflicts: !!opts.conflicts,
+        heavy: !!opts.heavy,
+    });
     if (opts.remote) {
         const { data: skills } = await api.get('/api/v1/skills?limit=50', true);
         if (skills.length === 0) {

package/dist/commands/login.js

@@ -1,6 +1,7 @@
 import { setTimeout as sleep } from 'node:timers/promises';
 import open from 'open';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { CONFIG } from '../lib/config.js';
 import { saveCredentials } from '../lib/credentials.js';
@@ -9,6 +10,7 @@ import { log } from '../utils/logger.js';
  * `prave login` — device-code flow against the Prave API / Supabase session.
  */
 export async function loginCommand() {
+    track('cli_login_started');
     const { data: start } = await api.post('/api/v1/cli/login');
     const url = `${CONFIG.webUrl}${start.verification_url}`;
     log.info('Opening browser to authorize this device…');

package/dist/commands/logout.js

@@ -1,6 +1,8 @@
+import { track } from '../lib/analytics.js';
 import { clearCredentials } from '../lib/credentials.js';
 import { log } from '../utils/logger.js';
 export async function logoutCommand() {
+    track('cli_logout');
     await clearCredentials();
     log.success('Logged out.');
 }

package/dist/commands/optimize.js

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import ora from 'ora';
 import readline from 'node:readline/promises';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { requireAuth } from '../lib/credentials.js';
 import { isValidSlug } from '../lib/slug.js';
@@ -50,6 +51,11 @@ async function confirmYesNo(question) {
     }
 }
 export async function optimizeCommand(opts = {}) {
+    track('cli_optimize', {
+        apply: !!opts.apply,
+        remove_unused: !!opts.removeUnused,
+        yes: !!opts.yes,
+    });
     const _session = await requireAuth("prave optimize");
     if (!_session)
         return;

package/dist/commands/overview.js

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { requireAuth } from '../lib/credentials.js';
 import { log } from '../utils/logger.js';
@@ -14,6 +15,7 @@ function pad(s, width) {
     return s + ' '.repeat(width - s.length);
 }
 export async function overviewCommand(opts = {}) {
+    track('cli_overview', { agent: opts.agent ?? null, json: !!opts.json });
     const _session = await requireAuth("prave overview");
     if (!_session)
         return;

package/dist/commands/search.js

@@ -1,7 +1,9 @@
 import chalk from 'chalk';
+import { track } from '../lib/analytics.js';
 import { api } from '../lib/api.js';
 import { log } from '../utils/logger.js';
 export async function searchCommand(query) {
+    track('cli_search', { length: query.length });
     const { data: skills } = await api.get(`/api/v1/skills?q=${encodeURIComponent(query)}&limit=25`);
     if (skills.length === 0) {
         log.dim(`No skills match "${query}".`);

package/dist/commands/sync.js

@@ -3,6 +3,7 @@ import { join } from 'node:path';
 import { createInterface } from 'node:readline/promises';
 import chalk from 'chalk';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { CONFIG } from '../lib/config.js';
 import { requireAuth } from '../lib/credentials.js';
 import { fetchMyPlan, formatUpgradeHint } from '../lib/plan.js';
@@ -20,6 +21,7 @@ import { installCommand } from './install.js';
  * single batched deploy at the end.
  */
 export async function syncCommand() {
+    track('cli_sync');
     // Auth gate — sync mutates the install ledger and intelligence cache.
     const session = await requireAuth('prave sync');
     if (!session)

package/dist/commands/uninstall.js

@@ -1,6 +1,7 @@
 import { rm } from 'node:fs/promises';
 import { join, resolve, sep } from 'node:path';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { CONFIG } from '../lib/config.js';
 import { assertSlug, InvalidSlugError } from '../lib/slug.js';
 /**
@@ -12,6 +13,7 @@ import { assertSlug, InvalidSlugError } from '../lib/slug.js';
  * so a hostile arg like `../../etc` cannot escape the skills directory.
  */
 export async function uninstallCommand(slug) {
+    track('cli_uninstall', { slug });
     try {
         assertSlug(slug);
     }

package/dist/commands/update.js

@@ -3,6 +3,7 @@ import { join } from 'node:path';
 import { createInterface } from 'node:readline/promises';
 import chalk from 'chalk';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { api } from '../lib/api.js';
 import { CONFIG } from '../lib/config.js';
 import { requireAuth } from '../lib/credentials.js';
@@ -22,6 +23,7 @@ import { log } from '../utils/logger.js';
  * changed: `markdown-pro  v3 → v5  (last pulled 12 Apr · published 21 Apr)`.
  */
 export async function updateCommand(slug, opts = {}) {
+    track('cli_update', { slug: slug ?? null, dry_run: !!opts.dryRun, yes: !!opts.yes });
     const session = await requireAuth('prave update');
     if (!session)
         return;

package/dist/commands/usage.js

@@ -2,6 +2,7 @@ import { readdir, stat } from 'node:fs/promises';
 import { basename, join } from 'node:path';
 import chalk from 'chalk';
 import ora from 'ora';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { CONFIG } from '../lib/config.js';
 import { requireAuth } from '../lib/credentials.js';
@@ -20,6 +21,7 @@ import { log } from '../utils/logger.js';
  * used by `prave sync` to chain a scan without spamming the terminal.
  */
 export async function usageScanCommand(opts) {
+    track('cli_usage_scan', { since: opts.since ?? null, quiet: !!opts.quiet });
     const session = await requireAuth('prave usage scan');
     if (!session)
         return;
@@ -225,6 +227,7 @@ async function debugLog(line) {
     }
 }
 export async function usageHookInstallCommand() {
+    track('cli_usage_hook_install');
     const session = await requireAuth('prave usage hook install');
     if (!session)
         return;
@@ -237,6 +240,7 @@ export async function usageHookInstallCommand() {
     printAgentResults(results, 'install');
 }
 export async function usageHookUninstallCommand() {
+    track('cli_usage_hook_uninstall');
     const session = await requireAuth('prave usage hook uninstall');
     if (!session)
         return;
@@ -257,6 +261,7 @@ export async function usageHookUninstallCommand() {
  * "unused for 30+ days" still shows up after running a Skill.
  */
 export async function usageStatusCommand() {
+    track('cli_usage_status');
     const session = await requireAuth('prave usage status');
     if (!session)
         return;

package/dist/commands/whatdoes.js

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import ora from 'ora';
 import { tokenTier } from '@prave/shared';
+import { track } from '../lib/analytics.js';
 import { api, ApiError } from '../lib/api.js';
 import { log } from '../utils/logger.js';
 const TIER_BADGE = {
@@ -15,6 +16,7 @@ function formatTokens(n) {
     return `~${(n / 1000).toFixed(1)}k`;
 }
 export async function whatdoesCommand(skillName) {
+    track('cli_whatdoes', { slug: skillName });
     const spinner = ora(`Looking up ${skillName}…`).start();
     try {
         const { data } = await api.get(`/api/v1/intelligence/whatdoes/${encodeURIComponent(skillName)}`, true);

package/dist/commands/whoami.js

@@ -1,3 +1,4 @@
+import { track } from '../lib/analytics.js';
 import { ApiError, api } from '../lib/api.js';
 import { loadCredentials } from '../lib/credentials.js';
 import { log } from '../utils/logger.js';
@@ -11,6 +12,7 @@ import { log } from '../utils/logger.js';
  * locally cached email so the command stays useful in airplane mode.
  */
 export async function whoamiCommand() {
+    track('cli_whoami');
     const creds = await loadCredentials();
     if (!creds) {
         log.warn('Not logged in. Run `prave login`.');

package/dist/index.js

@@ -23,8 +23,10 @@ import { updateCommand } from './commands/update.js';
 import { usageHookInstallCommand, usageHookUninstallCommand, usageReportCommand, usageScanCommand, usageStatusCommand, } from './commands/usage.js';
 import { whatdoesCommand } from './commands/whatdoes.js';
 import { whoamiCommand } from './commands/whoami.js';
+import { initAnalytics } from './lib/analytics.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
+initAnalytics(pkg.version);
 const program = new Command()
     .name('prave')
     .description([
@@ -210,6 +212,9 @@ program
         'Settings',
         '  prave settings                     # configure agents + paths',
         '',
+        'Telemetry',
+        '  PRAVE_TELEMETRY=0                  # opt out of CLI usage analytics',
+        '',
         'Docs:   https://prave.app/docs',
     ].join('\n'));
 });

package/dist/lib/analytics.js

@@ -0,0 +1,116 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir, platform, release } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { request } from 'undici';
+import { loadCredentials } from './credentials.js';
+const DEFAULT_HOST = 'https://eu.i.posthog.com';
+const ANON_ID_PATH = join(homedir(), '.prave', 'anon-id');
+const isOptedOut = () => {
+    const v = process.env.PRAVE_TELEMETRY;
+    return v === '0' || v === 'false' || v === 'off' || v === 'no';
+};
+let cachedConfig = null;
+const loadInjectedConfig = async () => {
+    try {
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const configPath = resolve(__dirname, 'posthog-config.json');
+        if (!existsSync(configPath))
+            return {};
+        const raw = await readFile(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return { key: parsed.key ?? null, host: parsed.host ?? DEFAULT_HOST };
+    }
+    catch {
+        return {};
+    }
+};
+const resolveConfig = async () => {
+    if (cachedConfig)
+        return cachedConfig;
+    const envKey = process.env.PRAVE_POSTHOG_KEY ?? null;
+    const envHost = process.env.PRAVE_POSTHOG_HOST ?? null;
+    if (envKey) {
+        cachedConfig = { key: envKey, host: envHost ?? DEFAULT_HOST };
+        return cachedConfig;
+    }
+    const injected = await loadInjectedConfig();
+    cachedConfig = {
+        key: injected.key ?? null,
+        host: envHost ?? injected.host ?? DEFAULT_HOST,
+    };
+    return cachedConfig;
+};
+let cachedDistinctId = null;
+const loadAnonId = async () => {
+    try {
+        const raw = await readFile(ANON_ID_PATH, 'utf8');
+        const trimmed = raw.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    catch {
+        /* fall through to generation */
+    }
+    const fresh = randomUUID();
+    try {
+        await mkdir(join(homedir(), '.prave'), { recursive: true });
+        await writeFile(ANON_ID_PATH, fresh, 'utf8');
+    }
+    catch {
+        /* anonymous storage best-effort */
+    }
+    return fresh;
+};
+const resolveDistinctId = async () => {
+    if (cachedDistinctId)
+        return cachedDistinctId;
+    const creds = await loadCredentials();
+    cachedDistinctId = creds?.user_id ?? (await loadAnonId());
+    return cachedDistinctId;
+};
+let cliVersion = null;
+const setCliVersion = (v) => {
+    cliVersion = v;
+};
+const baseProps = () => ({
+    $lib: 'prave-cli',
+    cli_version: cliVersion,
+    os: platform(),
+    os_release: release(),
+    node_version: process.version,
+});
+export const initAnalytics = (version) => {
+    setCliVersion(version);
+};
+export const track = (event, properties) => {
+    if (isOptedOut())
+        return;
+    // Fire and forget — never await, never throw.
+    void (async () => {
+        try {
+            const { key, host } = await resolveConfig();
+            if (!key)
+                return;
+            const distinctId = await resolveDistinctId();
+            await request(`${host}/capture/`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    api_key: key,
+                    event,
+                    distinct_id: distinctId,
+                    properties: { ...baseProps(), ...properties },
+                    timestamp: new Date().toISOString(),
+                }),
+                bodyTimeout: 3_000,
+                headersTimeout: 3_000,
+            });
+        }
+        catch {
+            /* swallow */
+        }
+    })();
+};

package/package.json

@@ -1,8 +1,43 @@
 {
   "name": "@prave/cli",
-  "version": "1.0.10",
-  "description": "Prave CLI — import, export, install, sync Claude Skills.",
+  "version": "1.1.1",
+  "description": "Prave CLI — discover, install, version, test, and ship Claude Skills. The developer platform for the complete Skill lifecycle.",
   "type": "module",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "claude-skills",
+    "skills",
+    "anthropic",
+    "ai",
+    "llm",
+    "agent",
+    "agents",
+    "ai-agent",
+    "agentic",
+    "cli",
+    "developer-tools",
+    "prompt-engineering",
+    "code-generation",
+    "skill-marketplace",
+    "skill-registry",
+    "prave"
+  ],
+  "homepage": "https://prave.app",
+  "bugs": {
+    "url": "https://github.com/eppstudio/prave/issues",
+    "email": "info@epplab-studio.de"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eppstudio/prave.git",
+    "directory": "apps/cli"
+  },
+  "author": "EppLab Studio <info@epplab-studio.de> (https://epplab-studio.de)",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
   "bin": {
     "prave": "dist/index.js"
   },
@@ -16,7 +51,7 @@
     "open": "^10.1.0",
     "ora": "^8.0.1",
     "undici": "^6.18.0",
-    "@prave/shared": "1.0.10"
+    "@prave/shared": "1.1.1"
   },
   "devDependencies": {
     "@types/node": "^20.12.7",
@@ -29,7 +64,7 @@
   "scripts": {
     "dev": "tsx src/index.ts --help",
     "cli": "tsx src/index.ts",
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node scripts/inject-config.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "tsc -p tsconfig.json --noEmit"
   }