@superdesign/cli 0.1.4 → 0.1.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Super Design
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/config/constants.d.ts

@@ -12,7 +12,7 @@ export declare const POLL_TIMEOUT_MS: number;
 export declare const AUTH_POLL_INTERVAL_MS = 2000;
 export declare const AUTH_POLL_TIMEOUT_MS: number;
 /** CLI version - should match package.json */
-export declare const CLI_VERSION = "0.1.4";
+export declare const CLI_VERSION = "0.1.6";
 /** Config directory name */
 export declare const CONFIG_DIR_NAME = ".superdesign";
 /** Config file name */
@@ -31,3 +31,6 @@ export declare const EXIT_CODES: {
 export declare const SKILLS_DIR = ".claude/skills/superdesign";
 /** SKILL.md file name */
 export declare const SKILL_FILE_NAME = "SKILL.md";
+/** PostHog analytics configuration */
+export declare const POSTHOG_KEY: string;
+export declare const POSTHOG_HOST: string;

package/dist/index.cjs

@@ -91,8 +91,6 @@ var __webpack_exports__ = {};
     const external_url_namespaceObject = require("url");
     const external_path_namespaceObject = require("path");
     const external_commander_namespaceObject = require("commander");
-    const external_fs_namespaceObject = require("fs");
-    const external_os_namespaceObject = require("os");
     const CONFIG_DIR_NAME = '.superdesign';
     const CONFIG_FILE_NAME = 'config.json';
     const EXIT_CODES = {
@@ -106,6 +104,11 @@ var __webpack_exports__ = {};
     };
     const SKILLS_DIR = '.claude/skills/superdesign';
     const SKILL_FILE_NAME = 'SKILL.md';
+    const POSTHOG_KEY = process.env.POSTHOG_KEY || 'phc_oUcDklFBX3wy8eksSyEC0pataKCgSadur1sio5hBHg4';
+    const POSTHOG_HOST = process.env.POSTHOG_HOST || 'https://eu.i.posthog.com';
+    const external_fs_namespaceObject = require("fs");
+    const external_os_namespaceObject = require("os");
+    var external_os_default = /*#__PURE__*/ __webpack_require__.n(external_os_namespaceObject);
     function getConfigDir() {
         return external_path_namespaceObject.join(external_os_namespaceObject.homedir(), CONFIG_DIR_NAME);
     }
@@ -313,7 +316,7 @@ var __webpack_exports__ = {};
         try {
             startSpinner('Creating auth session...');
             const session = await createSession({
-                cliVersion: "0.1.4",
+                cliVersion: "0.1.6",
                 os: `${external_os_namespaceObject.platform()} ${external_os_namespaceObject.release()}`,
                 hostname: external_os_namespaceObject.hostname()
             });
@@ -512,269 +515,35 @@ var __webpack_exports__ = {};
         return `---
 name: superdesign
 description: Superdesign is a design agent, where it specialised in frontend UI/UX design; Use this skill before you implement any UI that require some design thinking
+metadata:
+  author: superdesign
+  version: "0.0.1"
 ---
 
-SuperDesign helps you (1) find design inspirations/styles and (2) optionally generate/iterate design drafts on an infinite canvas.
-
-Each SuperDesign canvas run creates a new node and returns a \`previewUrl\`.
+SuperDesign helps you (1) find design inspirations/styles and (2) generate/iterate design drafts on an infinite canvas.
 
 ---
 
-## Core scenarios (what this skill handles)
+# Core scenarios (what this skill handles)
 
 1. **Help me design X** (feature/page/flow)
 2. **Set design system**
 3. **Help me improve design of X**
 
----
-
-## Tooling overview
-
-### A) Inspiration & Style Tools (generic, always available)
-Use these to discover style direction, references, and brand context:
-
-- **Search prompt library** (style/components/pages)
-  \`\`\`bash
-  superdesign search-prompts --keyword "<keyword>" --json
-  superdesign search-prompts --tags "style" --json
-  superdesign search-prompts --tags "style" --keyword "<style keyword>" --json
-  \`\`\`
-
-- **Get full prompt details**
-  \`\`\`bash
-  superdesign get-prompts --slugs "<slug1,slug2,...>" --json
-  \`\`\`
-
-- **Extract brand guide from a URL**
-  \`\`\`bash
-  superdesign extract-brand-guide --url https://example.com --json
-  \`\`\`
-
-### B) Canvas Design Tools (specialised, optional)
-
-Use these when you want to explore multiple directions and show previews:
-
-- Create project (supports prompt / prompt file / HTML)
-- Create design draft
-- Iterate design draft (replace / branch)
-- Plan flow pages → execute flow pages
-- Fetch nodes, export HTML
-
-> Pixel-perfect HTML playground is ONLY required for Canvas workflows.
-
----
-
-## Always-on rules
-
-- Design system should live at: \`.superdesign/design-system.md\`
-- If \`.superdesign/design-system.md\` is missing, run **Design System Setup** first.
-- Use \`askQuestion\` to ask high-signal questions (constraints, taste, tradeoffs).
-- For Canvas workflows: build a simplified/pixel-perfect prototype HTML in:
-  - \`.superdesign/playgrounds/<name>.html\`
-- Always use \`--json\` for machine parsing.
-
----
-
-## Playground rules (Canvas only)
-
-**Playground = BEFORE state (what exists now).** It provides context for SuperDesign agent.
-**Prompt = DESIRED CHANGE (what to add/modify).**
-
-The playground HTML must contain **ONLY UI that currently exists in the codebase**. For NEW features/sections, describe them entirely in the \`--prompt\` flag — do NOT add wireframes, placeholders, or sketches to the playground HTML.
-
-- **DO NOT** design or improve anything in the playground
-- **DO NOT** add placeholder sections like \`<!-- NEW FEATURE - DESIGN THIS -->\`
-- **DO** create pixel-perfect replica of current UI state
-- Valid formats:
-  - **Component-only**: isolated component with enough markup to show core UX/states
-  - **Full page**: replica of page where component operates (shows surrounding context)
-- Save to: \`.superdesign/playgrounds/<name>.html\`
-
-### Example: Adding a "Book Demo" section to home page
-
-**BAD approach:**
-\`\`\`html
-<!-- playground includes a sketched Book Demo section -->
-<section class="book-demo">
-  <!-- DESIGN THIS - Add CTA here -->
-  <h3>Book a Demo</h3>
-  <button>Schedule</button>
-</section>
-\`\`\`
-
-**GOOD approach:**
-\`\`\`html
-<!-- playground is pure replica of existing home page (hero + projects) -->
-<!-- NO book demo section in HTML -->
-\`\`\`
-Then in the iterate command:
-\`\`\`bash
---prompt "Add a Book Demo section between the hero and projects sections. Requirements: minimal card style, horizontal layout..."
-\`\`\`
-
----
-
-# 1) Design System Setup
-
-### Step 0 — Ask user (one question)
-
-"Do you want to **create a new design system** or **extract from the current codebase**?"
-
-### A) Extract from codebase
-
-1. Investigate codebase:
-   - design tokens, typography, colors, spacing, radius, shadows
-   - motion/animation patterns
-   - example components usage + implementation patterns
-   - core product functions + key pages
-2. Write standalone design system to:
-   - \`.superdesign/design-system.md\`
-   - Must be implementable without the codebase
-
-### B) Create a new design system (to improve current UI)
-
-1. Investigate codebase to understand product + needed pages/components
-2. Gather inspirations (generic tools):
-   - \`superdesign search-prompts --tags "style" --json\`
-   - \`superdesign get-prompts --slugs ... --json\`
-   - optional: \`superdesign extract-brand-guide --url ... --json\`
-3. Interview user (\`askQuestion\`) to choose direction
-4. Write:
-   - \`.superdesign/design-system.md\` (adapted to product + references)
-
----
-
-# 2) Designing X (feature/page/flow)
-
-## A) If user wants references / direction only (no canvas)
-
-1. Ensure \`.superdesign/design-system.md\` exists (setup if missing)
-2. Use inspiration tools to collect references:
-   - search prompts (style + component/page)
-   - get prompts (full details)
-   - extract brand guide if relevant
-3. Provide a concrete design spec:
-   - layout + hierarchy
-   - component set + states
-   - token guidance (typography/color/spacing/radius/motion)
-   - interaction notes + edge cases
-
-## B) If user wants visual exploration (canvas optional)
-
-Use canvas when direction is uncertain or multiple options are needed.
-
-### Canvas workflow — Add feature to existing page
-
-1. Ensure \`.superdesign/design-system.md\` exists (setup if missing)
-2. Build prototype HTML playground (simplified + pixel-perfect enough):
-   - \`.superdesign/playgrounds/<page>-<feature>.html\`
-3. Ask targeted questions (\`askQuestion\`) about requirements + taste
-4. Create project with playground HTML (returns \`draftId\`):
-   \`\`\`bash
-   superdesign create-project \\
-     --title "<feature>" \\
-     --html-file .superdesign/playgrounds/<file>.html \\
-     --prompt-file .superdesign/design-system.md \\
-     --json
-   \`\`\`
-   → Note: \`draftId\` in response is the baseline draft
-5. Branch designs from baseline (use \`draftId\` from step 4):
-   \`\`\`bash
-   superdesign iterate-design-draft \\
-     --draft-id <draftId> \\
-     --prompt "<design requirements>" \\
-     --mode branch \\
-     --count 3 \\
-     --json
-   \`\`\`
-6. Share \`previewUrl\` → collect feedback → iterate
-
-### Canvas workflow — Add new page
-
-Same as above, but playground should include shared UI shell:
-- nav, layout container, spacing rhythm, shared components
-
-### Canvas workflow — Improve current UI
-
-1. Investigate product + current UI states
-2. Ensure design system exists
-3. Propose improvement options:
-   - big restructure
-   - style uplift
-   - low-hanging polish
-4. Pick one → build playground → create project (prompt-file design system) → branch drafts
-5. Share \`previewUrl\` → iterate
-
-### When to use create-design-draft
-
-Only use \`create-design-draft\` when creating from scratch (no HTML baseline).
-
-**Required in prompt:**
-- Full page structure (header, sidebar, main content areas)
-- Component environment/surroundings
-- Layout context (what's above/below/beside)
-
-\`\`\`bash
-superdesign create-design-draft \\
-  --project-id <id> \\
-  --title "Feature X" \\
-  --prompt "Page has: fixed header 64px, left sidebar 240px, main content area. Design a settings panel in the main content area with..." \\
-  --device desktop \\
-  --json
+# How it works
+Fetch fresh guidelines below:
 \`\`\`
-
----
-
-# Advanced usage
-
-### Plan + generate a full user journey
-
-Plan:
-\`\`\`bash
-superdesign plan-flow-pages \\
-  --draft-id <draftId> \\
-  --source-node-id <nodeId> \\
-  --context "<flow context>" \\
-  --json
+https://raw.githubusercontent.com/superdesigndev/superdesign-skill/main/skills/superdesign/SUPERDESIGN.md
 \`\`\`
 
-Execute:
-\`\`\`bash
-superdesign execute-flow-pages \\
-  --draft-id <draftId> \\
-  --source-node-id <nodeId> \\
-  --pages '[{"title":"Signup","prompt":"..."},{"title":"Payment","prompt":"..."}]' \\
-  --json
-\`\`\`
+Action accordingly based on instruction in the guidelines
 
-### Get HTML reference from a draft
+# Superdesign CLI
 
-\`\`\`bash
-superdesign get-design --draft-id <draftId> --output ./design.html
 \`\`\`
-
----
-
-## Quick reference (key commands)
-
-\`\`\`bash
-# Inspirations
-superdesign search-prompts --keyword "<keyword>" --json
-superdesign search-prompts --tags "style" --json
-superdesign get-prompts --slugs "<slug1,slug2>" --json
-superdesign extract-brand-guide --url https://example.com --json
-
-# Canvas
-superdesign create-project --title "X" --prompt "..." --json
-superdesign create-project --title "X" --prompt-file .superdesign/design-system.md --json
-superdesign create-project --title "X" --html-file ./index.html --prompt-file .superdesign/design-system.md --json
-
-superdesign create-design-draft --project-id <id> --title "X" --prompt "..." --device desktop --json
-superdesign iterate-design-draft --draft-id <id> --prompt "..." --mode replace --json
-superdesign iterate-design-draft --draft-id <id> --prompt "..." --mode branch --count 3 --json
-
-superdesign fetch-design-nodes --project-id <id> --json
-superdesign get-design --draft-id <id> --json
+npm install -g @superdesign/cli@latest
+superdesign init
+superdesign --help
 \`\`\`
 `;
     }
@@ -866,102 +635,6 @@ superdesign get-design --draft-id <id> --json
         const response = await client.post(`/external/projects/${projectId}/drafts/add`, data);
         return response.data;
     }
-    function createCreateProjectCommand() {
-        const command = new external_commander_namespaceObject.Command('create-project').description('Create a new SuperDesign project').requiredOption('--title <title>', 'Project title').option('--html <html>', 'Initial HTML content for first draft').option('--html-file <path>', 'Path to HTML file for first draft').option('--prompt <prompt>', 'System prompt for the AI agent').option('--prompt-file <path>', 'Path to markdown file containing system prompt').option('--device <mode>', 'Device mode for draft (mobile, tablet, desktop)', 'desktop').option('--json', 'Output in JSON format').option('--no-open', 'Do not open project in browser after creation').action(async (options)=>{
-            if (options.json) setJsonMode(true);
-            try {
-                if (!manager_isAuthenticated()) {
-                    output_error('Not authenticated. Run `superdesign login` first.');
-                    process.exit(EXIT_CODES.AUTH_REQUIRED);
-                }
-                if (options.device && ![
-                    'mobile',
-                    'tablet',
-                    'desktop'
-                ].includes(options.device)) {
-                    output_error('Invalid device mode. Must be: mobile, tablet, or desktop');
-                    process.exit(EXIT_CODES.VALIDATION_ERROR);
-                }
-                let htmlContent;
-                if (options.htmlFile) {
-                    if (!external_fs_namespaceObject.existsSync(options.htmlFile)) {
-                        output_error(`HTML file not found: ${options.htmlFile}`);
-                        process.exit(EXIT_CODES.VALIDATION_ERROR);
-                    }
-                    htmlContent = external_fs_namespaceObject.readFileSync(options.htmlFile, 'utf-8');
-                } else if (options.html) htmlContent = options.html;
-                let promptContent;
-                if (options.promptFile) {
-                    if (!external_fs_namespaceObject.existsSync(options.promptFile)) {
-                        output_error(`Prompt file not found: ${options.promptFile}`);
-                        process.exit(EXIT_CODES.VALIDATION_ERROR);
-                    }
-                    promptContent = external_fs_namespaceObject.readFileSync(options.promptFile, 'utf-8');
-                } else if (options.prompt) promptContent = options.prompt;
-                startSpinner('Creating project...');
-                const project = await createProject({
-                    title: options.title,
-                    html: htmlContent,
-                    prompt: promptContent,
-                    deviceMode: options.device
-                });
-                succeedSpinner('Project created successfully!');
-                if (options.open) {
-                    const urlWithLive = `${project.projectUrl}?live=1`;
-                    await openBrowser(urlWithLive);
-                }
-                if (isJsonMode()) output({
-                    projectId: project.projectId,
-                    title: project.title,
-                    projectUrl: project.projectUrl,
-                    shareToken: project.shareToken,
-                    ...project.draftId && {
-                        draftId: project.draftId,
-                        previewUrl: project.previewUrl
-                    }
-                });
-                else {
-                    success(`Project "${project.title}" created!`);
-                    info(`\nProject ID: ${project.projectId}`);
-                    info(`Project URL: ${project.projectUrl}`);
-                    if (project.draftId) {
-                        info(`\nDraft ID: ${project.draftId}`);
-                        info(`Preview URL: ${project.previewUrl}`);
-                    }
-                }
-            } catch (err) {
-                failSpinner('Failed to create project');
-                if (err instanceof ApiClientError) {
-                    output_error(`API Error: ${err.message}`);
-                    process.exit(EXIT_CODES.API_ERROR);
-                }
-                const message = err instanceof Error ? err.message : 'Unknown error';
-                output_error(message);
-                process.exit(EXIT_CODES.GENERAL_ERROR);
-            }
-        });
-        return command;
-    }
-    async function createDraft(projectId, data) {
-        const client = getApiClient();
-        const response = await client.post(`/external/projects/${projectId}/drafts/create`, data);
-        return response.data;
-    }
-    async function iterateDraft(draftId, data) {
-        const client = getApiClient();
-        const response = await client.post(`/external/drafts/${draftId}/iterate`, data);
-        return response.data;
-    }
-    async function planFlowPages(draftId, data) {
-        const client = getApiClient();
-        const response = await client.post(`/external/drafts/${draftId}/flow/plan`, data);
-        return response.data;
-    }
-    async function executeFlowPages(draftId, data) {
-        const client = getApiClient();
-        const response = await client.post(`/external/drafts/${draftId}/flow/execute`, data);
-        return response.data;
-    }
     async function getJobStatus(jobId) {
         const client = getApiClient();
         const response = await client.get(`/external/jobs/${jobId}`);
@@ -1051,18 +724,98 @@ superdesign get-design --draft-id <id> --json
         else output_error(`${failureMessage}: ${message}`);
         process.exit(EXIT_CODES.GENERAL_ERROR);
     }
-    function createCreateDesignDraftCommand() {
-        const command = new external_commander_namespaceObject.Command('create-design-draft').description('Create a design draft using AI generation').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('--prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--json', 'Output in JSON format').action(async (options)=>{
+    const VALID_DEVICES = [
+        'mobile',
+        'tablet',
+        'desktop'
+    ];
+    function validateDeviceMode(device) {
+        if (device && !VALID_DEVICES.includes(device)) {
+            output_error('Invalid device mode. Must be: mobile, tablet, or desktop');
+            process.exit(EXIT_CODES.VALIDATION_ERROR);
+        }
+    }
+    function readFileContent(filePath, inlineContent, fileType) {
+        if (filePath) {
+            if (!(0, external_fs_namespaceObject.existsSync)(filePath)) {
+                output_error(`${fileType} file not found: ${filePath}`);
+                process.exit(EXIT_CODES.VALIDATION_ERROR);
+            }
+            return (0, external_fs_namespaceObject.readFileSync)(filePath, 'utf-8');
+        }
+        return inlineContent;
+    }
+    function createCreateProjectCommand() {
+        const command = new external_commander_namespaceObject.Command('create-project').description('Create a new SuperDesign project').requiredOption('--title <title>', 'Project title').option('--html <html>', 'Initial HTML content for first draft').option('--html-file <path>', 'Path to HTML file for first draft').option('-s, --set-project-prompt <prompt>', 'System prompt for the AI agent').option('--set-project-prompt-file <path>', 'Path to markdown file containing system prompt').option('--device <mode>', 'Device mode for draft (mobile, tablet, desktop)', 'desktop').option('--json', 'Output in JSON format').option('--no-open', 'Do not open project in browser after creation').action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
-            if (options.device && ![
-                'mobile',
-                'tablet',
-                'desktop'
-            ].includes(options.device)) {
-                output_error('Invalid device mode. Must be: mobile, tablet, or desktop');
-                process.exit(EXIT_CODES.VALIDATION_ERROR);
+            validateDeviceMode(options.device);
+            const htmlContent = readFileContent(options.htmlFile, options.html, 'HTML');
+            const promptContent = readFileContent(options.setProjectPromptFile, options.setProjectPrompt, 'Prompt');
+            startSpinner('Creating project...');
+            try {
+                const project = await createProject({
+                    title: options.title,
+                    html: htmlContent,
+                    prompt: promptContent,
+                    deviceMode: options.device
+                });
+                succeedSpinner('Project created successfully!');
+                if (options.open) {
+                    const urlWithLive = `${project.projectUrl}?live=1`;
+                    await openBrowser(urlWithLive);
+                }
+                if (isJsonMode()) output({
+                    projectId: project.projectId,
+                    title: project.title,
+                    projectUrl: project.projectUrl,
+                    shareToken: project.shareToken,
+                    ...project.draftId && {
+                        draftId: project.draftId,
+                        previewUrl: project.previewUrl
+                    }
+                });
+                else {
+                    success(`Project "${project.title}" created!`);
+                    info(`\nProject ID: ${project.projectId}`);
+                    info(`Project URL: ${project.projectUrl}`);
+                    if (project.draftId) {
+                        info(`\nDraft ID: ${project.draftId}`);
+                        info(`Preview URL: ${project.previewUrl}`);
+                    }
+                }
+            } catch (err) {
+                failSpinner('Failed to create project');
+                handleApiError(err, 'Failed to create project');
             }
+        });
+        return command;
+    }
+    async function createDraft(projectId, data) {
+        const client = getApiClient();
+        const response = await client.post(`/external/projects/${projectId}/drafts/create`, data);
+        return response.data;
+    }
+    async function iterateDraft(draftId, data) {
+        const client = getApiClient();
+        const response = await client.post(`/external/drafts/${draftId}/iterate`, data);
+        return response.data;
+    }
+    async function planFlowPages(draftId, data) {
+        const client = getApiClient();
+        const response = await client.post(`/external/drafts/${draftId}/flow/plan`, data);
+        return response.data;
+    }
+    async function executeFlowPages(draftId, data) {
+        const client = getApiClient();
+        const response = await client.post(`/external/drafts/${draftId}/flow/execute`, data);
+        return response.data;
+    }
+    function createCreateDesignDraftCommand() {
+        const command = new external_commander_namespaceObject.Command('create-design-draft').description('Create a design draft using AI generation').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--json', 'Output in JSON format').action(async (options)=>{
+            if (options.json) setJsonMode(true);
+            job_runner_requireAuth(manager_isAuthenticated);
+            validateDeviceMode(options.device);
             await runJob({
                 startLabel: 'Creating design draft...',
                 pollingLabel: 'Generating design with AI...',
@@ -1525,15 +1278,104 @@ superdesign get-design --draft-id <id> --json
         });
         return command;
     }
+    const external_posthog_node_namespaceObject = require("posthog-node");
+    let posthogClient = null;
+    function getPostHog() {
+        if (!posthogClient && POSTHOG_KEY) posthogClient = new external_posthog_node_namespaceObject.PostHog(POSTHOG_KEY, {
+            host: POSTHOG_HOST
+        });
+        return posthogClient;
+    }
+    function sanitizeOptions(options) {
+        const sensitiveKeys = [
+            'token',
+            'key',
+            'secret',
+            'password',
+            'apiKey',
+            'api_key',
+            'apikey',
+            'auth',
+            'authorization',
+            'credential'
+        ];
+        const sanitized = {};
+        for (const [key, value] of Object.entries(options)){
+            const lowerKey = key.toLowerCase();
+            if (!sensitiveKeys.some((sensitive)=>lowerKey.includes(sensitive))) {
+                if ('string' != typeof value || !(value.length > 100)) sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    async function trackCommand(opts) {
+        const config = loadConfig();
+        const teamId = config.teamId;
+        const metadata = {
+            command: opts.command,
+            success: opts.success,
+            durationMs: opts.durationMs,
+            errorCode: opts.errorCode,
+            options: opts.options ? sanitizeOptions(opts.options) : void 0,
+            cliVersion: "0.1.6",
+            os: `${external_os_default().platform()} ${external_os_default().release()}`
+        };
+        const posthog = getPostHog();
+        if (posthog) {
+            const distinctId = teamId || `anon_${external_os_default().hostname()}`;
+            posthog.capture({
+                distinctId,
+                event: 'cli_command',
+                properties: {
+                    team_id: teamId,
+                    ...metadata
+                }
+            });
+        }
+        if (manager_isAuthenticated() && teamId) try {
+            const client = getApiClient();
+            await client.post('/external/track', {
+                activityType: 'cli_command',
+                metadata
+            });
+        } catch  {}
+    }
+    async function shutdownAnalytics() {
+        if (posthogClient) {
+            await posthogClient.shutdown();
+            posthogClient = null;
+        }
+    }
     const src_filename = (0, external_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__);
     const src_dirname = (0, external_path_namespaceObject.dirname)(src_filename);
     (0, external_dotenv_namespaceObject.config)({
         path: (0, external_path_namespaceObject.resolve)(src_dirname, '../.env')
     });
     (0, external_dotenv_namespaceObject.config)();
+    let commandStartTime = 0;
+    let currentCommand = '';
+    function sanitizeCommandOptions(opts) {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(opts))if (!('function' == typeof value || key.startsWith('_'))) sanitized[key] = value;
+        return sanitized;
+    }
     function createProgram() {
         const program = new external_commander_namespaceObject.Command();
-        program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.1.4");
+        program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.1.6");
+        program.hook('preAction', ()=>{
+            commandStartTime = Date.now();
+            currentCommand = process.argv[2] || 'unknown';
+        });
+        program.hook('postAction', async (_thisCommand, actionCommand)=>{
+            const durationMs = Date.now() - commandStartTime;
+            await trackCommand({
+                command: currentCommand,
+                success: true,
+                durationMs,
+                options: sanitizeCommandOptions(actionCommand.opts())
+            });
+            await shutdownAnalytics();
+        });
         program.addCommand(createLoginCommand());
         program.addCommand(createLogoutCommand());
         program.addCommand(createInitCommand());