greenrun-cli 0.2.4 → 0.2.6

package/dist/commands/init.js

@@ -3,6 +3,7 @@ import { execSync } from 'child_process';
 import { existsSync, readFileSync, writeFileSync, mkdirSync, appendFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { homedir } from 'os';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const TEMPLATES_DIR = join(__dirname, '..', '..', 'templates');
@@ -64,22 +65,65 @@ async function validateToken(token) {
         return { valid: false };
     }
 }
+function getClaudeConfigPath() {
+    return join(homedir(), '.claude.json');
+}
+function readClaudeConfig() {
+    const configPath = getClaudeConfigPath();
+    if (!existsSync(configPath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeClaudeConfig(config) {
+    writeFileSync(getClaudeConfigPath(), JSON.stringify(config, null, 2) + '\n');
+}
+function setLocalMcpServer(name, server) {
+    const config = readClaudeConfig();
+    const projectPath = process.cwd();
+    config.projects = config.projects || {};
+    config.projects[projectPath] = config.projects[projectPath] || {};
+    config.projects[projectPath].mcpServers = config.projects[projectPath].mcpServers || {};
+    config.projects[projectPath].mcpServers[name] = server;
+    writeClaudeConfig(config);
+}
 function configureMcpLocal(token) {
     try {
-        execSync(`claude mcp add greenrun --transport stdio -e GREENRUN_API_TOKEN=${token} -- npx -y greenrun-cli@latest`, { stdio: 'inherit' });
+        setLocalMcpServer('greenrun', {
+            type: 'stdio',
+            command: 'npx',
+            args: ['-y', 'greenrun-cli@latest'],
+            env: { GREENRUN_API_TOKEN: token },
+        });
+        console.log('  Configured greenrun MCP server');
     }
     catch {
-        console.error('\nFailed to run "claude mcp add". Make sure Claude Code is installed and in your PATH.');
+        console.error('\nFailed to write greenrun MCP config to ~/.claude.json');
         console.error('You can add the MCP server manually by running:\n');
         console.error(`  claude mcp add greenrun --transport stdio -e GREENRUN_API_TOKEN=${token} -- npx -y greenrun-cli@latest\n`);
     }
 }
 function configurePlaywrightMcp() {
     try {
-        execSync('claude mcp add playwright -- npx @playwright/mcp@latest --browser chrome --user-data-dir ~/.greenrun/browser-profile', { stdio: 'inherit' });
+        setLocalMcpServer('playwright', {
+            type: 'stdio',
+            command: 'npx',
+            args: [
+                '@playwright/mcp@latest',
+                '--browser', 'chrome',
+                '--user-data-dir', join(homedir(), '.greenrun', 'browser-profile'),
+            ],
+            env: {},
+        });
+        console.log('  Configured playwright MCP server');
     }
     catch {
-        console.error('\nFailed to add Playwright MCP. You can add it manually:\n');
+        console.error('\nFailed to write Playwright MCP config to ~/.claude.json');
+        console.error('You can add it manually:\n');
         console.error('  claude mcp add playwright -- npx @playwright/mcp@latest --browser chrome --user-data-dir ~/.greenrun/browser-profile\n');
     }
 }
@@ -117,7 +161,9 @@ function configureMcpProject(token) {
             console.log('  Added GREENRUN_API_TOKEN to .env');
         }
         else {
-            console.log('  GREENRUN_API_TOKEN already in .env (not modified)');
+            const updated = envContent.replace(/GREENRUN_API_TOKEN=.*/g, envLine);
+            writeFileSync(envPath, updated);
+            console.log('  Updated GREENRUN_API_TOKEN in .env');
         }
     }
     else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "greenrun-cli",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "CLI and MCP server for Greenrun - browser test management for Claude Code",
   "type": "module",
   "main": "dist/server.js",

package/templates/claude-md.md

@@ -37,6 +37,25 @@ Projects can be configured with authentication settings so tests auto-login befo
 
 Projects can also store named **credentials** (name/email/password sets). Each test can reference a credential by `credential_name` to use specific login details during execution.
 
+### Project Setup
+
+When asked to create tests, first call `list_projects` to check for an existing project. Then:
+
+- **No project exists**: Create one via `create_project` with the name, base URL, and description.
+- **Project exists but missing credentials or auth config**: Update it via `update_project` to add what's missing.
+
+In either case, follow these steps:
+
+1. **Derive the base URL** from the project's configuration (e.g. `APP_URL` in `.env`, framework config, or `docker-compose.yml`). Don't ask the user for this.
+2. **Set up authentication** -- most apps need auth for testing. Be proactive:
+   - Look for a registration or login page in the app's routes/config.
+   - Create test credentials and store them on the project using the `credentials` parameter. Use clear names like `"default"` or `"admin"`. Example: `{ name: "default", email: "greenrun-test@example.com", password: "TestPass123!" }`.
+   - Set `auth_mode: "existing_user"` with the app's `login_url` and step-by-step `login_instructions`.
+   - Then register the test account through the app's registration flow using Playwright so the credentials are valid.
+3. **Discover pages** by reading the app's route definitions, then register key pages via `create_page`.
+
+Don't ask the user for information you can derive from the codebase (base URL, login URL, route structure). Only ask when there's genuine ambiguity.
+
 ### Creating Tests
 
 1. Navigate to the page you want to test using Playwright