skopix 2.0.7 → 2.0.9

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

@@ -2027,17 +2027,20 @@ export async function dashboardCommand(options) {
     if (options.agent) {
       const key = process.env.SKOPIX_SECRET_KEY;
       if (key) {
-        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], {
-            stdio: 'inherit',
-            env: { ...process.env },
-          });
-          agentProc.on('exit', (code) => {
-            if (code !== 0) console.log(chalk.yellow('  [agent] Agent exited with code ' + code));
+        // 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], {
+              stdio: 'inherit',
+              env: { ...process.env, SKOPIX_AUTO_AGENT: '1', SKOPIX_NO_BANNER: '1' },
+            });
+            agentProc.on('exit', (code) => {
+              if (code !== 0) console.log(chalk.yellow('  [agent] Agent exited with code ' + code));
+            });
+            process.on('SIGINT', () => { agentProc.kill(); });
           });
-          process.on('SIGINT', () => { agentProc.kill(); });
-        });
+        }, 2000);
       } else {
         console.log(chalk.yellow('  ⚠ --agent flag set but SKOPIX_SECRET_KEY not found, skipping auto-agent'));
       }

package/cli/index.js

@@ -18,8 +18,10 @@ const banner = chalk.cyan(`
   ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝
 `);
 
-console.log(banner);
-console.log(chalk.dim('  AI-powered QA agent. Tests your app like a human would.\n'));
+if (!process.env.SKOPIX_NO_BANNER) {
+  console.log(banner);
+  console.log(chalk.dim('  AI-powered QA agent. Tests your app like a human would.\n'));
+}
 
 program
   .name('skopix')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skopix",
-  "version": "2.0.7",
+  "version": "2.0.9",
   "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>