whisker-ux 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eric Li
+
+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/README.md

@@ -0,0 +1,234 @@
+# Whisker
+
+AI-powered usability testing CLI. Whisker uses Claude's computer use capability to navigate your website like a real user, identifying UX issues, bugs, and accessibility problems.
+
+```
+╭────────────────────────────────────────────────────────────────────╮
+│                                                                    │
+│  WHISKER v0.1.0                                                    │
+│  AI-Powered Usability Testing                                      │
+│                                                                    │
+│   _._     _,-'""`-._                                               │
+│  (,-.`._,'(       |`-/|                                            │
+│      `-.-' \ )-`( , o o)                                           │
+│            `-    \`_`"'-                                           │
+│                                                                    │
+╰────────────────────────────────────────────────────────────────────╯
+```
+
+## Features
+
+- **AI-Powered Navigation**: Claude navigates your site like a real user, completing tasks and noting issues
+- **Think-Aloud Testing**: Get insights into user confusion and friction points
+- **Comprehensive Reports**: Detailed findings with severity levels, reproduction steps, and suggested fixes
+- **Screenshot Documentation**: Every step is captured for easy reference
+- **Bug Detection**: Catches console errors, network failures, and visual issues
+- **Developer-Friendly Output**: Includes grep patterns to find relevant code
+
+## Installation
+
+```bash
+npm install -g whisker-ux
+```
+
+Or run directly with npx:
+
+```bash
+npx whisker-ux "Sign up for an account" --url https://your-site.com
+```
+
+## Quick Start
+
+1. **Set up your Anthropic API key**:
+
+```bash
+whisker setup
+```
+
+Or set the environment variable:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+2. **Run a usability test**:
+
+```bash
+whisker "Add a product to the shopping cart" --url http://localhost:3000
+```
+
+3. **View the results** in `.whisker/report.md`
+
+## Usage
+
+```bash
+whisker <task> --url <url> [options]
+```
+
+### Arguments
+
+- `<task>` - The task to complete (e.g., "Sign up for an account", "Find the pricing page")
+
+### Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-u, --url <url>` | URL of the site to test (required) | - |
+| `-p, --persona <persona>` | Persona description for the tester | - |
+| `-m, --max-steps <number>` | Maximum navigation steps | 50 |
+| `-v, --viewport <WxH>` | Viewport size | 1280x800 |
+| `-o, --output <dir>` | Output directory | .whisker |
+
+### Examples
+
+**Basic test:**
+```bash
+whisker "Find the contact page" --url https://example.com
+```
+
+**With persona:**
+```bash
+whisker "Complete the checkout flow" \
+  --url http://localhost:3000 \
+  --persona "First-time user, not tech-savvy, age 65"
+```
+
+**Custom viewport (mobile):**
+```bash
+whisker "Navigate to settings" \
+  --url https://myapp.com \
+  --viewport 375x667
+```
+
+**Limit steps:**
+```bash
+whisker "Find pricing information" \
+  --url https://startup.com \
+  --max-steps 10
+```
+
+## Output
+
+Whisker generates three outputs in the `.whisker` directory:
+
+```
+.whisker/
+├── report.md           # Human-readable findings report
+├── report.json         # Structured JSON for automation
+└── screenshots/
+    ├── step-001.png
+    ├── step-002.png
+    └── ...
+```
+
+### Report Structure
+
+The report includes:
+
+- **Task completion status** - Whether the AI successfully completed the task
+- **Summary** - Overview of the testing session
+- **Findings** - Detailed issues organized by priority:
+  - 🔴 P0 - Critical, blocking issues
+  - 🟠 P1 - Major problems
+  - 🟡 P2 - Minor issues
+  - 💡 P3 - Suggestions
+- **Console errors** - JavaScript errors detected
+- **Network failures** - Failed API calls and requests
+
+### Finding Details
+
+Each finding includes:
+
+- Severity and category (bug, ux-friction, accessibility, performance, visual, copy)
+- Description with expected vs actual behavior
+- Steps to reproduce
+- Screenshot reference
+- Suggested fix
+- Grep patterns to find relevant code
+
+## Commands
+
+### `whisker setup`
+
+Configure your Anthropic API key interactively.
+
+### `whisker logout`
+
+Remove your stored API key.
+
+### `whisker run <task>` (default)
+
+Run a usability test. This is the default command.
+
+## Configuration
+
+### API Key
+
+Whisker looks for your Anthropic API key in this order:
+
+1. `ANTHROPIC_API_KEY` environment variable
+2. `~/.whisker/config.json` (set via `whisker setup`)
+
+### Requirements
+
+- Node.js 18+
+- Anthropic API key with access to Claude's computer use capability
+
+## Programmatic Usage
+
+```typescript
+import { runSession, writeReport, WhiskerConfig } from 'whisker-ux';
+
+const config: WhiskerConfig = {
+  task: "Sign up for an account",
+  url: "https://example.com",
+  maxSteps: 50,
+  viewport: { width: 1280, height: 800 },
+  outputDir: ".whisker"
+};
+
+const { report, sessionLog } = await runSession(config);
+await writeReport(report, sessionLog, config.outputDir);
+
+console.log(`Task completed: ${report.taskCompleted}`);
+console.log(`Found ${report.findings.length} issues`);
+```
+
+## Troubleshooting
+
+### "No Anthropic API key configured"
+
+Run `whisker setup` or set the `ANTHROPIC_API_KEY` environment variable.
+
+### Playwright browser issues
+
+Whisker uses Playwright's Chromium. If you encounter browser issues:
+
+```bash
+npx playwright install chromium
+```
+
+### Rate limiting
+
+If you hit API rate limits, reduce `--max-steps` or wait before retrying.
+
+### Browser not visible
+
+The browser window should appear during testing. If it doesn't, ensure you're not running in a headless environment.
+
+## How It Works
+
+1. **Launch**: Opens a visible Chromium browser at your URL
+2. **Navigate**: Claude sees the screen and decides what actions to take (click, type, scroll)
+3. **Think Aloud**: Claude narrates its thought process, noting confusion or issues
+4. **Capture**: Screenshots are taken after each action
+5. **Analyze**: Claude reviews the session observations and screenshots to identify issues that may not be obvious during navigation
+6. **Report**: Results are saved as markdown and JSON
+
+## License
+
+MIT
+
+## Contributing
+
+Issues and pull requests welcome at [github.com/ericli/whisker-ux](https://github.com/ericli/whisker-ux).

package/dist/agent.d.ts

@@ -0,0 +1,5 @@
+import { WhiskerConfig, SessionLog, WhiskerReport } from "./types.js";
+export declare function runSession(config: WhiskerConfig): Promise<{
+    report: WhiskerReport;
+    sessionLog: SessionLog;
+}>;

package/dist/agent.js

@@ -0,0 +1,324 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { BrowserManager } from "./browser.js";
+import { getNavigationSystemPrompt, getReportSystemPrompt, } from "./prompts.js";
+import { printTestStart, startSpinner, stopSpinner, startWaitingSpinner, clearSpinner, printStepComplete } from "./ui.js";
+const MODEL = "claude-sonnet-4-5-20250929";
+const MAX_SCREENSHOTS_FOR_ANALYSIS = 10; // Limit screenshots sent to analysis phase
+const BETA_FLAG = "computer-use-2025-01-24";
+export async function runSession(config) {
+    const client = new Anthropic();
+    const browser = new BrowserManager(config);
+    printTestStart();
+    try {
+        startSpinner("Launching browser...");
+        await browser.launch();
+        stopSpinner(`Browser ready at ${config.url}`);
+        const sessionLog = await navigationPhase(client, browser, config);
+        printStepComplete(`Navigation complete (${sessionLog.steps.length} steps)`);
+        startSpinner("Generating report...");
+        const report = await reportPhase(client, sessionLog);
+        stopSpinner("Report generated");
+        return { report, sessionLog };
+    }
+    finally {
+        await browser.close();
+    }
+}
+async function navigationPhase(client, browser, config) {
+    const startTime = Date.now();
+    const steps = [];
+    const observations = [];
+    const computerTool = {
+        type: "computer_20250124",
+        name: "computer",
+        display_width_px: config.viewport.width,
+        display_height_px: config.viewport.height,
+        display_number: 1,
+    };
+    const systemPrompt = getNavigationSystemPrompt(config);
+    const messages = [
+        {
+            role: "user",
+            content: `Please begin the usability test. The browser is already open to ${config.url}. Complete this task: ${config.task}`,
+        },
+    ];
+    let stepCount = 0;
+    while (stepCount < config.maxSteps) {
+        // Show waiting spinner while waiting for API response
+        startWaitingSpinner();
+        let response;
+        try {
+            response = await client.beta.messages.create({
+                model: MODEL,
+                max_tokens: 4096,
+                system: systemPrompt,
+                tools: [computerTool],
+                messages,
+                betas: [BETA_FLAG],
+            });
+        }
+        catch (err) {
+            clearSpinner();
+            stopSpinner(`API error: ${err}`);
+            throw err;
+        }
+        // Clear waiting spinner when we get a response
+        clearSpinner();
+        // Append assistant response to messages
+        messages.push({
+            role: "assistant",
+            content: response.content,
+        });
+        // Process content blocks
+        const toolResults = [];
+        let hasToolUse = false;
+        let currentThinking = "";
+        // First pass: collect thinking text
+        for (const block of response.content) {
+            if (block.type === "text") {
+                observations.push(block.text);
+                currentThinking += block.text + " ";
+            }
+        }
+        // Second pass: process tool uses with the collected thinking
+        for (const block of response.content) {
+            if (block.type === "tool_use") {
+                hasToolUse = true;
+                stepCount++;
+                const action = block.input;
+                const actionDesc = formatAction(action);
+                // Show spinner while executing
+                startSpinner(`Step ${stepCount}: ${actionDesc}`);
+                // Execute the action
+                if (action.action !== "screenshot") {
+                    try {
+                        await browser.executeAction(action);
+                    }
+                    catch (err) {
+                        // Print failed step
+                        stopSpinner(`Step ${stepCount}: ${actionDesc} (failed)`);
+                        toolResults.push({
+                            type: "tool_result",
+                            tool_use_id: block.id,
+                            content: `Error executing action: ${err instanceof Error ? err.message : String(err)}`,
+                            is_error: true,
+                        });
+                        continue;
+                    }
+                }
+                // Take screenshot after action
+                const screenshotBase64 = await browser.takeScreenshot();
+                // Print completed step
+                stopSpinner(`Step ${stepCount}: ${actionDesc}`);
+                steps.push({
+                    stepNumber: stepCount,
+                    action,
+                    screenshotBase64,
+                    timestamp: Date.now(),
+                });
+                toolResults.push({
+                    type: "tool_result",
+                    tool_use_id: block.id,
+                    content: [
+                        {
+                            type: "image",
+                            source: {
+                                type: "base64",
+                                media_type: "image/png",
+                                data: screenshotBase64,
+                            },
+                        },
+                    ],
+                });
+            }
+        }
+        // If no tool use, Claude is done
+        if (!hasToolUse) {
+            break;
+        }
+        // Send tool results back
+        messages.push({
+            role: "user",
+            content: toolResults,
+        });
+    }
+    if (stepCount >= config.maxSteps) {
+        printStepComplete(`Reached max step limit (${config.maxSteps})`);
+    }
+    return {
+        config,
+        steps,
+        observations,
+        consoleErrors: browser.getConsoleErrors(),
+        networkFailures: browser.getNetworkFailures(),
+        startTime,
+        endTime: Date.now(),
+    };
+}
+function formatAction(action) {
+    switch (action.action) {
+        case "screenshot":
+            return "screenshot";
+        case "left_click":
+            return `click at (${action.coordinate?.[0]}, ${action.coordinate?.[1]})`;
+        case "right_click":
+            return `right-click at (${action.coordinate?.[0]}, ${action.coordinate?.[1]})`;
+        case "double_click":
+            return `double-click at (${action.coordinate?.[0]}, ${action.coordinate?.[1]})`;
+        case "type":
+            return `type "${action.text?.slice(0, 30)}${(action.text?.length ?? 0) > 30 ? "..." : ""}"`;
+        case "key":
+            return `key "${action.text}"`;
+        case "scroll":
+            return `scroll ${action.scroll_direction} at (${action.coordinate?.[0]}, ${action.coordinate?.[1]})`;
+        case "mouse_move":
+            return `move to (${action.coordinate?.[0]}, ${action.coordinate?.[1]})`;
+        default:
+            return action.action;
+    }
+}
+async function reportPhase(client, sessionLog) {
+    const systemPrompt = getReportSystemPrompt();
+    const sessionSummary = buildSessionSummary(sessionLog);
+    // Build content with text summary and screenshots
+    const content = [];
+    // Add text summary first
+    content.push({
+        type: "text",
+        text: sessionSummary,
+    });
+    // Add screenshots (sample if too many)
+    const steps = sessionLog.steps;
+    let screenshotsToInclude;
+    if (steps.length <= MAX_SCREENSHOTS_FOR_ANALYSIS) {
+        screenshotsToInclude = steps;
+    }
+    else {
+        // Sample evenly: always include first and last, plus evenly spaced middle ones
+        screenshotsToInclude = [steps[0]];
+        const middleCount = MAX_SCREENSHOTS_FOR_ANALYSIS - 2;
+        const interval = (steps.length - 2) / (middleCount + 1);
+        for (let i = 1; i <= middleCount; i++) {
+            const idx = Math.round(i * interval);
+            if (idx > 0 && idx < steps.length - 1) {
+                screenshotsToInclude.push(steps[idx]);
+            }
+        }
+        screenshotsToInclude.push(steps[steps.length - 1]);
+    }
+    // Add each screenshot with label
+    for (const step of screenshotsToInclude) {
+        content.push({
+            type: "text",
+            text: `\n[Screenshot from Step ${step.stepNumber}: ${formatAction(step.action)}]`,
+        });
+        content.push({
+            type: "image",
+            source: {
+                type: "base64",
+                media_type: "image/png",
+                data: step.screenshotBase64,
+            },
+        });
+    }
+    content.push({
+        type: "text",
+        text: "\n\nPlease analyze the session log and screenshots above, then produce a structured JSON report of findings.",
+    });
+    const response = await client.messages.create({
+        model: MODEL,
+        max_tokens: 4096,
+        system: systemPrompt,
+        messages: [
+            {
+                role: "user",
+                content,
+            },
+        ],
+    });
+    const textBlock = response.content.find((b) => b.type === "text");
+    if (!textBlock || textBlock.type !== "text") {
+        throw new Error("No text response from Claude in report phase");
+    }
+    // Parse JSON - strip markdown fences if present
+    let jsonStr = textBlock.text.trim();
+    if (jsonStr.startsWith("```json")) {
+        jsonStr = jsonStr.slice(7);
+    }
+    else if (jsonStr.startsWith("```")) {
+        jsonStr = jsonStr.slice(3);
+    }
+    if (jsonStr.endsWith("```")) {
+        jsonStr = jsonStr.slice(0, -3);
+    }
+    jsonStr = jsonStr.trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse report JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return {
+        metadata: {
+            task: sessionLog.config.task,
+            url: sessionLog.config.url,
+            persona: sessionLog.config.persona,
+            timestamp: new Date(sessionLog.startTime).toISOString(),
+            duration: sessionLog.endTime - sessionLog.startTime,
+            totalSteps: sessionLog.steps.length,
+            modelUsed: MODEL,
+        },
+        summary: parsed.summary,
+        findings: parsed.findings || [],
+        consoleErrors: sessionLog.consoleErrors,
+        networkFailures: sessionLog.networkFailures,
+        taskCompleted: parsed.taskCompleted,
+        taskCompletionNotes: parsed.taskCompletionNotes,
+    };
+}
+function buildSessionSummary(sessionLog) {
+    const parts = [];
+    parts.push("# Usability Test Session Log");
+    parts.push("");
+    parts.push("## Test Configuration");
+    parts.push(`- **Task:** ${sessionLog.config.task}`);
+    parts.push(`- **URL:** ${sessionLog.config.url}`);
+    if (sessionLog.config.persona) {
+        parts.push(`- **Persona:** ${sessionLog.config.persona}`);
+    }
+    parts.push(`- **Duration:** ${((sessionLog.endTime - sessionLog.startTime) / 1000).toFixed(1)}s`);
+    parts.push(`- **Total Steps:** ${sessionLog.steps.length}`);
+    parts.push("");
+    parts.push("## Tester Observations");
+    parts.push("(These are the tester's think-aloud comments during navigation)");
+    parts.push("");
+    for (const obs of sessionLog.observations) {
+        parts.push(obs);
+        parts.push("");
+    }
+    parts.push("## Actions Taken");
+    for (const step of sessionLog.steps) {
+        const actionDesc = formatAction(step.action);
+        parts.push(`${step.stepNumber}. ${actionDesc}`);
+    }
+    parts.push("");
+    if (sessionLog.consoleErrors.length > 0) {
+        parts.push("## Console Errors Detected");
+        for (const err of sessionLog.consoleErrors) {
+            parts.push(`- ${err}`);
+        }
+        parts.push("");
+    }
+    if (sessionLog.networkFailures.length > 0) {
+        parts.push("## Network Failures Detected");
+        for (const fail of sessionLog.networkFailures) {
+            parts.push(`- ${fail.method} ${fail.url} → ${fail.status} ${fail.statusText}`);
+        }
+        parts.push("");
+    }
+    parts.push("---");
+    parts.push("Please analyze this session and produce a structured JSON report of findings.");
+    return parts.join("\n");
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/browser.d.ts

@@ -0,0 +1,16 @@
+import { ComputerAction, NetworkFailure, WhiskerConfig } from "./types.js";
+export declare class BrowserManager {
+    private config;
+    private browser;
+    private context;
+    private page;
+    private consoleErrors;
+    private networkFailures;
+    constructor(config: WhiskerConfig);
+    launch(): Promise<void>;
+    takeScreenshot(): Promise<string>;
+    executeAction(action: ComputerAction): Promise<void>;
+    close(): Promise<void>;
+    getConsoleErrors(): string[];
+    getNetworkFailures(): NetworkFailure[];
+}