skopix 2.0.6 → 2.0.8

package/cli/commands/agent.js

@@ -60,6 +60,23 @@ async function promptAndAuth(serverUrl, secretKey) {
   } catch {}
 
   console.log(chalk.cyan('  Enter your Skopix dashboard login to identify this agent:'));
+
+  // Auto mode — skip interactive prompt, use SKOPIX_AGENT_EMAIL/PASSWORD env vars or connect anonymously
+  if (process.env.SKOPIX_AUTO_AGENT === '1') {
+    const email = process.env.SKOPIX_AGENT_EMAIL || '';
+    const password = process.env.SKOPIX_AGENT_PASSWORD || '';
+    if (email && password) {
+      const res = await fetch(serverUrl + '/api/agent/auth', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'x-skopix-key': secretKey },
+        body: JSON.stringify({ email, password }),
+      });
+      const data = await res.json();
+      if (res.ok) return data;
+    }
+    console.log(chalk.dim('  Auto-agent: connecting anonymously (set SKOPIX_AGENT_EMAIL and SKOPIX_AGENT_PASSWORD to identify)'));
+    return { userId: null, name: os.hostname() };
+  }
   const email = await prompt('  Email: ');
   const password = await prompt('  Password: ', true);
 

package/cli/commands/dashboard.js

@@ -2022,6 +2022,29 @@ export async function dashboardCommand(options) {
       const openPath = (teamMode && !teamMode.db.hasAnyAdmin()) ? '/setup' : '/app/';
       open(`http://${displayHost}:${port}${openPath}`).catch(() => {});
     }
+
+    // Auto-start agent if --agent flag passed
+    if (options.agent) {
+      const key = process.env.SKOPIX_SECRET_KEY;
+      if (key) {
+        // Wait 2s for server to be fully ready before spawning agent
+        setTimeout(() => {
+          console.log(chalk.cyan('  [agent]') + ' Auto-starting agent on this machine...');
+          import('child_process').then(({ spawn }) => {
+            const agentProc = spawn(process.execPath, [process.argv[1], 'agent', '--server', `http://localhost:${port}`, '--key', key, '--auto'], {
+              stdio: 'inherit',
+              env: { ...process.env, SKOPIX_AUTO_AGENT: '1' },
+            });
+            agentProc.on('exit', (code) => {
+              if (code !== 0) console.log(chalk.yellow('  [agent] Agent exited with code ' + code));
+            });
+            process.on('SIGINT', () => { agentProc.kill(); });
+          });
+        }, 2000);
+      } else {
+        console.log(chalk.yellow('  ⚠ --agent flag set but SKOPIX_SECRET_KEY not found, skipping auto-agent'));
+      }
+    }
   });
 
   process.on('SIGINT', () => { console.log(chalk.yellow('\n  Stopping...')); server.close(); process.exit(0); });

package/cli/index.js

@@ -32,7 +32,7 @@ program
   .requiredOption('-u, --url <url>', 'Target URL to test')
   .requiredOption('-g, --goal <goal>', 'Testing goal (e.g. "complete the checkout flow")')
   .option('-c, --credentials <file>', 'Path to credentials YAML file')
-  .option('-o, --output <dir>', 'Output directory for reports')
+  .option('-o, --output <dir>', 'Output directory for reports', './skopix-reports')
   .option('-m, --max-steps <number>', 'Maximum steps the agent will take', '20')
   .option('--headless', 'Run browser in headless mode', false)
   .option('--no-video', 'Disable video recording')
@@ -53,7 +53,7 @@ program
 program
   .command('report')
   .description('Open the latest report in your browser')
-  .option('-d, --dir <dir>', 'Reports directory')
+  .option('-d, --dir <dir>', 'Reports directory', './skopix-reports')
   .action(reportCommand);
 
 program
@@ -72,6 +72,7 @@ program
   .option('-h, --host <host>', 'Host to bind to (default 127.0.0.1; use 0.0.0.0 for team mode)')
   .option('--team', 'Enable multi-user team mode (requires SQLite)')
   .option('--no-open', 'Do not auto-open the browser')
+  .option('--agent', 'Also start an agent on this machine automatically')
   .action(dashboardCommand);
 
 program
@@ -82,4 +83,22 @@ program
   .option('-n, --name <name>', 'Agent display name (defaults to hostname)')
   .action(agentCommand);
 
+// Short alias: "skopix start" — starts dashboard + agent in one command
+program
+  .command('start')
+  .description('Start dashboard and agent together (shortcut for team mode)')
+  .option('-p, --port <port>', 'Port', '9000')
+  .option('--host <host>', 'Host to bind to', '0.0.0.0')
+  .option('--no-open', 'Do not auto-open the browser')
+  .action(async (options) => {
+    const key = process.env.SKOPIX_SECRET_KEY;
+    if (!key) {
+      console.log(chalk.red('  ✖ SKOPIX_SECRET_KEY is not set.'));
+      console.log(chalk.dim('  Set it with: export SKOPIX_SECRET_KEY="your-secret"'));
+      process.exit(1);
+    }
+    // Start dashboard with agent flag
+    await dashboardCommand({ ...options, team: true, agent: true });
+  });
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skopix",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "Browser-based QA tool — record tests by using your app, replay them deterministically, generate Playwright code automatically",
   "main": "cli/index.js",
   "bin": {

package/web/index.html

@@ -469,7 +469,7 @@ footer { border-top: 1px solid var(--border); padding: 48px; display: flex; alig
     <div class="code-block observe">
       <div><span class="code-cmd">$</span> npm install -g skopix</div>
       <div><span class="code-cmd">$</span> npx playwright install chromium</div>
-      <div class="code-out">→ Installs Skopix CLI and the Chromium browser for recording and replay</div>
+      <div class="code-out">→ Installs the Skopix CLI and Chromium browser on your machine</div>
     </div>
 
     <div class="code-label observe">2. CONFIGURE YOUR AI PROVIDER</div>
@@ -487,32 +487,83 @@ footer { border-top: 1px solid var(--border); padding: 48px; display: flex; alig
       <div class="code-out">→ Click "Record test" to start your first recording</div>
     </div>
 
-    <div class="code-label observe">3B. TEAM MODE — SHARE WITH YOUR TEAM</div>
+    <div class="code-label observe">3B. TEAM MODE — ONE COMMAND STARTS EVERYTHING</div>
     <div class="code-block observe">
-      <div><span class="code-cmd">$</span> <span class="code-val">SKOPIX_SECRET_KEY</span>="your-long-secret" skopix dashboard --team --host 0.0.0.0</div>
-      <div class="code-out">→ Visit http://localhost:9000/setup to create the first admin account</div>
-      <div class="code-out">→ Invite teammates from the Users tab</div>
-      <div class="code-out">→ Share your IP or use "portix 9000" for remote access</div>
+      <div class="code-comment"># Set your secret key once (saves permanently):</div>
+      <div><span class="code-cmd">$</span> echo 'SKOPIX_SECRET_KEY=your-secret' >> ~/.skopix.env</div>
+      <div class="code-comment"># Then just run:</div>
+      <div><span class="code-cmd">$</span> skopix start</div>
+      <div class="code-out">→ Starts the dashboard in team mode</div>
+      <div class="code-out">→ Starts the agent on your machine automatically</div>
+      <div class="code-out">→ Teammates connect via http://YOUR-IP:9000</div>
+    </div>
+
+    <div class="code-label observe">3C. TEAMMATES — CONNECT AS AN AGENT</div>
+    <div class="code-block observe">
+      <div class="code-comment"># Each teammate runs this on their own machine:</div>
+      <div><span class="code-cmd">$</span> npm install -g skopix</div>
+      <div><span class="code-cmd">$</span> npx playwright install chromium</div>
+      <div><span class="code-cmd">$</span> skopix agent --server http://HOST-IP:9000 --key "your-secret"</div>
+      <div class="code-out">→ Prompts for Skopix dashboard login to identify your machine</div>
+      <div class="code-out">→ Chrome opens on YOUR machine when you trigger tests</div>
+      <div class="code-out">→ Leave it running in a terminal while you work</div>
     </div>
 
     <div class="code-label observe">USING OLLAMA (LOCAL AI — NO API KEY NEEDED)</div>
     <div class="code-block observe">
       <div class="code-comment"># Install Ollama from https://ollama.ai, then:</div>
       <div><span class="code-cmd">$</span> ollama pull llama3.1</div>
-      <div class="code-comment"># In .skopix.env:</div>
+      <div class="code-comment"># In ~/.skopix.env or via My Settings in the dashboard:</div>
       <div><span class="code-val">SKOPIX_PROVIDER</span>=ollama</div>
       <div><span class="code-val">OLLAMA_MODEL</span>=llama3.1</div>
       <div class="code-out">→ AI runs entirely on your machine. No data leaves. No cost.</div>
     </div>
 
-    <div class="code-label observe">RECOMMENDED: RUN ON YOUR OWN MACHINE</div>
+    <div style="margin-top:40px;background:var(--surface);border:1px solid var(--border-bright);border-radius:12px;padding:28px 32px" class="observe">
+      <div style="font-family:var(--mono);font-size:10px;color:var(--cyan);letter-spacing:0.15em;margin-bottom:16px">HOW IT ALL FITS TOGETHER</div>
+      <div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:24px;font-family:var(--mono);font-size:12px;line-height:1.8">
+        <div>
+          <div style="color:var(--white);margin-bottom:6px">1 person hosts</div>
+          <div style="color:var(--muted)">Runs <code style="color:var(--cyan)">skopix dashboard --team</code> and keeps it running. Everyone connects to their machine.</div>
+        </div>
+        <div>
+          <div style="color:var(--white);margin-bottom:6px">Everyone runs an agent</div>
+          <div style="color:var(--muted)">Runs <code style="color:var(--cyan)">skopix agent</code> in a terminal. Their browser opens locally when they trigger a recording or replay.</div>
+        </div>
+        <div>
+          <div style="color:var(--white);margin-bottom:6px">Tests run on your machine</div>
+          <div style="color:var(--muted)">When you click Record or Replay, Skopix dispatches to your agent. Chrome opens on your screen. Results stream back to the shared dashboard.</div>
+        </div>
+      </div>
+    </div>
+
+    <div style="margin-top:16px;background:rgba(255,193,7,0.06);border:1px solid rgba(255,193,7,0.2);border-radius:12px;padding:20px 32px" class="observe">
+      <div style="font-family:var(--mono);font-size:10px;color:#f59e0b;letter-spacing:0.15em;margin-bottom:10px">⚠ AGENT IS REQUIRED TO RECORD AND REPLAY</div>
+      <div style="font-family:var(--mono);font-size:12px;color:var(--muted);line-height:1.8">In team mode, the agent must be running on your machine before you can record or replay tests. The dashboard alone cannot open a browser — the agent is what does the browser work locally. Always start your agent before using the dashboard.</div>
+    </div>
+
+    <div class="code-label observe" style="margin-top:32px">BACKUP YOUR TESTS</div>
     <div class="code-block observe">
-      <div class="code-comment"># Recording and replay open a real Chrome window — run on a Mac or Windows machine</div>
-      <div class="code-comment"># Teammates connect via browser — they don't need anything installed</div>
-      <div><span class="code-cmd">$</span> <span class="code-val">SKOPIX_SECRET_KEY</span>="long-random-string" skopix dashboard --team --host 0.0.0.0</div>
-      <div class="code-out">→ Share your IP or use "portix 9000" for remote access</div>
-      <div class="code-out">→ All recording, replay and debug runs on your machine with a real browser</div>
+      <div class="code-comment"># All your tests, suites, sessions and credentials live in one place:</div>
+      <div class="code-out">→ ~/.skopix/</div>
+      <div class="code-comment"># Back up everything to a zip on your Desktop:</div>
+      <div><span class="code-cmd">$</span> node skopix-backup.js</div>
+      <div class="code-out">→ Creates skopix-backup-2026-05-26.zip on your Desktop</div>
+      <div class="code-comment"># Restore on any machine (auto-finds the zip on Desktop/Downloads):</div>
+      <div><span class="code-cmd">$</span> node skopix-restore.js</div>
+      <div class="code-out">→ Restores all tests, suites, sessions and credentials</div>
+      <div class="code-out">→ Restart Skopix after restoring</div>
     </div>
+
+    <div style="margin-top:16px;background:var(--surface);border:1px solid var(--border);border-radius:12px;padding:20px 32px" class="observe">
+      <div style="font-family:var(--mono);font-size:10px;color:var(--cyan);letter-spacing:0.15em;margin-bottom:10px">DOWNLOAD BACKUP SCRIPTS</div>
+      <div style="font-family:var(--mono);font-size:12px;color:var(--muted);line-height:1.8">
+        Get <code style="color:var(--cyan)">skopix-backup.js</code> and <code style="color:var(--cyan)">skopix-restore.js</code> from the
+        <a href="https://github.com/x444dyx/skopix" target="_blank" style="color:var(--cyan)">GitHub repo</a>.
+        On Mac, double-click <code style="color:var(--cyan)">.command</code> wrappers to run without opening a terminal.
+      </div>
+    </div>
+
   </div>
 </section>