@instawp/cli 0.0.1-beta.2 → 0.0.1-beta.20

package/dist/commands/versions.js

@@ -0,0 +1,324 @@
+import chalk from 'chalk';
+import { requireAuth, getClient } from '../lib/api.js';
+import { resolveSite } from '../lib/site-resolver.js';
+import { success, error, table, spinner, info, isJsonMode } from '../lib/output.js';
+/**
+ * Site versions: restorable point-in-time copies of a site's files + database.
+ * Unlike backups, a version can be rolled back to in-place. The intended
+ * workflow (and the reason this exists for the AI era): create a version
+ * BEFORE letting an agent run a batch of changes, then roll back the one
+ * change that broke it — in one command.
+ *
+ * Named `versions` (not "snapshot") to avoid confusion with InstaWP's separate
+ * "Snapshots" product.
+ */
+const POLL_INTERVAL = 3000; // 3s
+const MAX_WAIT = 10 * 60 * 1000; // 10 min — create/restore scale with site size
+/** Poll a CloudTask until it completes, errors, or times out. */
+async function pollTask(client, taskId, label) {
+    const spin = spinner(`${label}...`);
+    spin.start();
+    const start = Date.now();
+    while (Date.now() - start < MAX_WAIT) {
+        try {
+            const res = await client.get(`/tasks/${taskId}/status`);
+            const task = res.data?.data;
+            const pct = parseFloat(task?.percentage_complete) || 0;
+            const status = task?.status;
+            if (status === 'completed') {
+                spin.stop();
+                return 'completed';
+            }
+            if (status === 'error' || status === 'failed') {
+                spin.fail(`${label} failed`);
+                if (task?.comment)
+                    error(task.comment);
+                return 'error';
+            }
+            spin.text = pct > 0 ? `${label}... ${chalk.dim(`(${Math.round(pct)}%)`)}` : `${label}...`;
+        }
+        catch {
+            // Task status endpoint may not be ready yet — keep polling.
+        }
+        await new Promise((r) => setTimeout(r, POLL_INTERVAL));
+    }
+    spin.fail(`${label} timed out`);
+    return 'timeout';
+}
+function formatDate(value) {
+    if (!value)
+        return '';
+    const d = new Date(value);
+    if (Number.isNaN(d.getTime()))
+        return value;
+    return d.toISOString().slice(0, 16).replace('T', ' ');
+}
+export function registerVersionsCommand(program) {
+    const versionsCmd = program
+        .command('versions')
+        .aliases(['version'])
+        .description('Manage site versions (restorable point-in-time copies) — create one before risky changes, roll back in one command');
+    // versions create <site>
+    versionsCmd
+        .command('create <site>')
+        .description('Create a version of a site (a restorable point-in-time copy)')
+        .option('--name <name>', 'Label for the version (max 25 chars), e.g. "before plugin update"')
+        .option('--no-wait', 'Return immediately instead of waiting for the version to finish')
+        .action(async (siteIdentifier, opts) => {
+        requireAuth();
+        const client = getClient();
+        const rspin = spinner('Resolving site...');
+        rspin.start();
+        let site;
+        try {
+            site = await resolveSite(siteIdentifier);
+            rspin.stop();
+        }
+        catch {
+            rspin.fail('Site resolution failed');
+            process.exit(1);
+        }
+        const label = site.name || site.sub_domain || String(site.id);
+        const spin = spinner(`Creating version of ${label}...`);
+        spin.start();
+        let versionId;
+        let taskId;
+        try {
+            const res = await client.post('/site-versions', { site_id: site.id });
+            versionId = res.data?.data?.id;
+            taskId = res.data?.data?.task_id;
+            spin.stop();
+            if (!versionId) {
+                error('Version creation failed', res.data?.message || res.data);
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            spin.fail('Failed to create version');
+            error('Could not create version', err.response?.data?.message || err.message);
+            process.exit(1);
+        }
+        // Optional name — the create endpoint doesn't accept one, so set it via
+        // update. The server caps names at 25 chars (longer → 422), so truncate.
+        const versionName = opts.name ? String(opts.name).slice(0, 25) : undefined;
+        if (versionName) {
+            try {
+                await client.put(`/site-versions/${versionId}`, { name: versionName });
+            }
+            catch {
+                info('Version created, but naming it failed (you can rename it later).');
+            }
+        }
+        if (!opts.wait) {
+            if (isJsonMode()) {
+                console.log(JSON.stringify({ success: true, data: { id: versionId, status: 'progress', task_id: taskId ?? null } }));
+            }
+            else {
+                success('Version started', { id: versionId, status: 'progress' });
+                info('It will be restorable once complete. Check with: instawp versions list ' + label);
+            }
+            return;
+        }
+        if (taskId) {
+            const result = await pollTask(client, taskId, 'Creating version');
+            if (result !== 'completed') {
+                info(`Version (ID ${versionId}) is still processing. Check with: instawp versions list ${label}`);
+                process.exit(result === 'error' ? 1 : 0);
+            }
+        }
+        if (isJsonMode()) {
+            console.log(JSON.stringify({ success: true, data: { id: versionId, status: 'completed', name: versionName || null } }));
+        }
+        else {
+            success('Version ready', { id: versionId, ...(versionName ? { name: versionName } : {}) });
+            info(`Roll back any time with: instawp versions restore ${label} ${versionId}`);
+        }
+    });
+    // versions list <site>
+    versionsCmd
+        .command('list <site>')
+        .description('List a site\'s versions (most recent first)')
+        .action(async (siteIdentifier) => {
+        requireAuth();
+        const client = getClient();
+        const rspin = spinner('Resolving site...');
+        rspin.start();
+        let site;
+        try {
+            site = await resolveSite(siteIdentifier);
+            rspin.stop();
+        }
+        catch {
+            rspin.fail('Site resolution failed');
+            process.exit(1);
+        }
+        const spin = spinner('Fetching versions...');
+        spin.start();
+        try {
+            const res = await client.get('/site-versions', { params: { site_id: site.id, per_page: 100 } });
+            const versions = res.data?.data || [];
+            spin.stop();
+            if (versions.length === 0) {
+                if (isJsonMode()) {
+                    console.log(JSON.stringify([]));
+                }
+                else {
+                    info('No versions yet. Create one with: instawp versions create ' + (site.name || site.id));
+                }
+                return;
+            }
+            const rows = versions.map((v) => ({
+                id: v.id,
+                name: v.name || chalk.dim('(unnamed)'),
+                size: v.size_mb != null ? `${v.size_mb} MB` : '',
+                status: v.status === 'completed' ? chalk.green('completed') : v.status === 'progress' ? chalk.yellow('in progress') : (v.status || ''),
+                created: formatDate(v.created_at),
+            }));
+            table(['ID', 'Name', 'Size', 'Status', 'Created'], rows);
+        }
+        catch (err) {
+            spin.fail('Failed to fetch versions');
+            error('Could not list versions', err.response?.data?.message || err.message);
+            process.exit(1);
+        }
+    });
+    // versions restore <site> <version-id>
+    versionsCmd
+        .command('restore <site> <version-id>')
+        .description('Roll a site back to a version — OVERWRITES current files and database')
+        .option('--force', 'Skip confirmation')
+        .option('--no-wait', 'Return immediately instead of waiting for the restore to finish')
+        .action(async (siteIdentifier, versionId, opts) => {
+        requireAuth();
+        const client = getClient();
+        const rspin = spinner('Resolving site...');
+        rspin.start();
+        let site;
+        try {
+            site = await resolveSite(siteIdentifier);
+            rspin.stop();
+        }
+        catch {
+            rspin.fail('Site resolution failed');
+            process.exit(1);
+        }
+        const label = site.name || site.sub_domain || String(site.id);
+        if (!opts.force) {
+            if (isJsonMode()) {
+                error('Use --force to restore in JSON mode (this overwrites the live site)');
+                process.exit(1);
+            }
+            const readline = await import('node:readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise((resolve) => {
+                rl.question(`Restore "${label}" to version ${versionId}? This OVERWRITES the current files and database and cannot be undone. (y/N) `, resolve);
+            });
+            rl.close();
+            if (answer.toLowerCase() !== 'y') {
+                info('Cancelled.');
+                return;
+            }
+        }
+        const spin = spinner(`Starting restore of ${label}...`);
+        spin.start();
+        let taskId;
+        try {
+            const res = await client.put(`/sites/${site.id}/restore-versions/${versionId}`);
+            taskId = res.data?.data?.task_id;
+            spin.stop();
+        }
+        catch (err) {
+            spin.fail('Failed to start restore');
+            error('Could not restore version', err.response?.data?.message || err.message);
+            process.exit(1);
+        }
+        if (!opts.wait) {
+            if (isJsonMode()) {
+                console.log(JSON.stringify({ success: true, data: { site_id: site.id, version_id: Number(versionId), status: 'restoring', task_id: taskId ?? null } }));
+            }
+            else {
+                success('Restore started', { site: label, version: versionId });
+                info('The site will be back shortly. Check with: instawp sites list');
+            }
+            return;
+        }
+        if (taskId) {
+            const result = await pollTask(client, taskId, 'Restoring version');
+            if (result !== 'completed') {
+                info('Restore is still processing. The site will update once it finishes.');
+                process.exit(result === 'error' ? 1 : 0);
+            }
+        }
+        if (isJsonMode()) {
+            console.log(JSON.stringify({ success: true, data: { site_id: site.id, version_id: Number(versionId), status: 'completed' } }));
+        }
+        else {
+            success(`"${label}" restored to version ${versionId}`);
+        }
+    });
+    // versions delete <site> <version-id...>
+    versionsCmd
+        .command('delete <site> <version-ids...>')
+        .description('Delete one or more versions')
+        .option('--force', 'Skip confirmation')
+        .action(async (siteIdentifier, versionIds, opts) => {
+        requireAuth();
+        const client = getClient();
+        const rspin = spinner('Resolving site...');
+        rspin.start();
+        let site;
+        try {
+            site = await resolveSite(siteIdentifier);
+            rspin.stop();
+        }
+        catch {
+            rspin.fail('Site resolution failed');
+            process.exit(1);
+        }
+        const label = site.name || site.sub_domain || String(site.id);
+        const ids = versionIds.map((v) => parseInt(v, 10)).filter((n) => !Number.isNaN(n));
+        if (ids.length === 0) {
+            error('No valid version IDs provided');
+            process.exit(1);
+        }
+        if (!opts.force) {
+            if (isJsonMode()) {
+                error('Use --force to delete in JSON mode');
+                process.exit(1);
+            }
+            const readline = await import('node:readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise((resolve) => {
+                rl.question(`Delete ${ids.length} version(s) [${ids.join(', ')}] of "${label}"? (y/N) `, resolve);
+            });
+            rl.close();
+            if (answer.toLowerCase() !== 'y') {
+                info('Cancelled.');
+                return;
+            }
+        }
+        const spin = spinner('Deleting version(s)...');
+        spin.start();
+        try {
+            const res = await client.delete('/site-versions', { data: { ids } });
+            const data = res.data?.data || {};
+            const successIds = data.success_ids || [];
+            const failedIds = data.failed_ids || [];
+            spin.stop();
+            if (isJsonMode()) {
+                console.log(JSON.stringify({ success: true, data: { success_ids: successIds, failed_ids: failedIds } }));
+                return;
+            }
+            if (successIds.length)
+                success(`Deleted version(s): ${successIds.join(', ')}`);
+            if (failedIds.length)
+                error(`Failed to delete: ${failedIds.join(', ')}`);
+        }
+        catch (err) {
+            spin.fail('Failed to delete version(s)');
+            error('Could not delete versions', err.response?.data?.message || err.message);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=versions.js.map

package/dist/commands/versions.js.map

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

package/dist/index.js

@@ -6,11 +6,15 @@ import { setJsonMode } from './lib/output.js';
 import { registerLoginCommand } from './commands/login.js';
 import { registerWhoamiCommand } from './commands/whoami.js';
 import { registerSitesCommand, registerCreateAlias } from './commands/sites.js';
+import { registerVersionsCommand } from './commands/versions.js';
 import { registerSyncCommand } from './commands/sync.js';
 import { registerSshCommand } from './commands/ssh.js';
 import { registerExecCommand, registerWpCommand } from './commands/exec.js';
 import { registerTeamsCommand } from './commands/teams.js';
 import { registerLocalCommand } from './commands/local.js';
+import { registerDbCommand } from './commands/db.js';
+import { registerOpenCommand } from './commands/open.js';
+import { registerLogsCommand } from './commands/logs.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 // Early --json detection so it works in any argv position
@@ -32,15 +36,37 @@ registerWhoamiCommand(program);
 // -- Sites --
 registerSitesCommand(program);
 registerCreateAlias(program);
+registerVersionsCommand(program);
 // -- Remote access --
-registerExecCommand(program);
 registerWpCommand(program);
+registerExecCommand(program);
 registerSshCommand(program);
 registerSyncCommand(program);
+registerDbCommand(program);
+registerLogsCommand(program);
+registerOpenCommand(program);
 // -- Teams --
 registerTeamsCommand(program);
 // -- Local dev --
 registerLocalCommand(program);
+// -- Changelog --
+program
+    .command('changelog')
+    .description('Show recent changes')
+    .action(() => {
+    const changelogPath = new URL('../CHANGELOG.md', import.meta.url);
+    try {
+        const fs = require('fs');
+        const content = fs.readFileSync(changelogPath, 'utf-8');
+        // Show only the latest version
+        const sections = content.split(/\n## /);
+        const latest = sections[1] ? `## ${sections[1]}` : content;
+        console.log(latest.trim());
+    }
+    catch {
+        console.log(`Changelog: https://github.com/InstaWP/cli/blob/main/CHANGELOG.md`);
+    }
+});
 // Custom help layout
 program.configureHelp({
     sortSubcommands: false,
@@ -57,13 +83,24 @@ ${d('Auth')}
 ${d('Sites')}
   ${c('create')}             Create a new WordPress site
   ${c('sites list')}         List all sites
+  ${c('sites creds')}        Show WP admin credentials + Magic Login URL
+  ${c('sites php')}          View or update PHP version/settings
   ${c('sites delete')}       Delete a site
+  ${c('open')}   ${d('<site>')}         Open site (or --admin / --magic) in browser
+
+${d('Versions')} ${d('(restorable point-in-time site copies)')}
+  ${c('versions create')}    Create a version before risky changes
+  ${c('versions list')}      List a site's versions
+  ${c('versions restore')}   Roll a site back to a version
+  ${c('versions delete')}    Delete versions
 
 ${d('Remote Access')}
-  ${c('exec')}  ${d('<site>')} ${d('<cmd>')}  Run any command on a site (SSH default, --api)
-  ${c('wp')}    ${d('<site>')} ${d('<args>')} WP-CLI shorthand (exec <site> wp <args>)
-  ${c('ssh')}   ${d('<site>')}          Interactive SSH session
-  ${c('sync')}  ${d('push|pull')}       Sync wp-content via rsync
+  ${c('wp')}     ${d('<site>')} ${d('<args>')} WP-CLI on a remote site (primary)
+  ${c('ssh')}    ${d('<site>')}         Interactive SSH session
+  ${c('sync')}   ${d('push|pull')}      Sync wp-content via rsync
+  ${c('db')}     ${d('push|pull')}      Push/pull MySQL database (auto-backup)
+  ${c('logs')}   ${d('<site>')}         Tail WP / PHP / nginx logs
+  ${c('exec')}   ${d('<site>')} ${d('<cmd>')}  Run arbitrary shell (escape hatch for non-WP)
 
 ${d('Local Development')}
   ${c('local create')}       Create and start a local WordPress site
@@ -85,9 +122,13 @@ ${d('Examples')}
   $ instawp create --name my-site
   $ instawp local create --name blog
   $ instawp wp my-site plugin list
-  $ instawp exec my-site php -v --api
-  $ instawp ssh my-site
-  $ instawp sites list --json
+  $ instawp wp my-site -- post list --post_type=page
+  $ instawp versions create my-site --name "before plugin update"
+  $ instawp versions restore my-site 1234
+  $ instawp open my-site --admin
+  $ instawp db pull my-site
+  $ instawp logs my-site --follow
+  $ instawp sites creds my-site
 `;
 });
 // Override default help to only show options (commands are in custom section)

package/dist/index.js.map

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

package/dist/lib/local-env.d.ts

@@ -1,4 +1,16 @@
 import type { LocalInstance } from '../types.js';
+/**
+ * Returns [command, prefixArgs, usingNpx] for running wp-playground-cli.
+ * Prefers the global binary (faster) over npx (slower, downloads on first run).
+ */
+export declare function getPlaygroundCommand(): [string, string[], boolean];
+/** Test-only: reset the once-per-process hint guard. */
+export declare function _resetNpxHint(): void;
+/**
+ * One-time, dim hint shown when falling back to npx (no global binary). Explains
+ * the first-run download and how to skip it. Suppressed in --json mode.
+ */
+export declare function maybeShowNpxHint(usingNpx: boolean): void;
 export declare function getLocalBaseDir(): string;
 export declare function getInstanceDir(name: string): string;
 /**
@@ -13,6 +25,25 @@ export declare function createInstanceDir(name: string): string;
  */
 export declare function ensureAutoLogin(instance: LocalInstance): void;
 export declare function deleteInstanceDir(name: string): void;
+/**
+ * Build the wp-playground-cli argument(s) to mount a host path at a VFS path.
+ *
+ * `--mount` / `--mount-before-install` take a single `host:vfs` value, which
+ * wp-playground-cli splits on `:`. On Windows the host path contains a
+ * drive-letter colon (e.g. `C:\Users\...\wp-content`), so the split yields 3+
+ * parts and Playground rejects it with "Invalid mount format". On Windows we
+ * instead use `--mount-dir` / `--mount-dir-before-install`, which take the host
+ * and vfs paths as two separate args (`nargs: 2`) and avoid the colon entirely.
+ * Both forms resolve to the same `{ hostPath, vfsPath }` mount in Playground
+ * (no file-vs-directory distinction), so this works for files and directories.
+ *
+ * macOS/Linux keep the long-standing colon form unchanged (their absolute paths
+ * have no drive-letter colon). `platform` is injectable for testing.
+ */
+export declare function buildMountArgs(hostPath: string, vfsPath: string, opts?: {
+    beforeInstall?: boolean;
+    platform?: NodeJS.Platform;
+}): string[];
 /**
  * Starts the Playground server in the foreground.
  * Watches stdout for the ready URL and calls onReady when detected.

package/dist/lib/local-env.js

@@ -1,21 +1,42 @@
-import { spawn, spawnSync } from 'node:child_process';
+import { spawnSync } from 'node:child_process';
+// cross-spawn handles Windows quirks: `npx`/`wp-playground-cli` are `.cmd`
+// shims, and Node won't spawn .cmd without shell:true (CVE-2024-27980). It also
+// quotes args (e.g. mount paths) safely, which shell:true does not.
+import spawn from 'cross-spawn';
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import net from 'node:net';
+import chalk from 'chalk';
+import { isJsonMode } from './output.js';
 const LOCAL_BASE_DIR = join(homedir(), '.instawp', 'local');
 const DEFAULT_PORT_START = 9400;
 /**
- * Returns [command, prefixArgs] for running wp-playground-cli.
- * Prefers the global binary (faster) over npx (slower).
+ * Returns [command, prefixArgs, usingNpx] for running wp-playground-cli.
+ * Prefers the global binary (faster) over npx (slower, downloads on first run).
  */
-function getPlaygroundCommand() {
+export function getPlaygroundCommand() {
     // Check for globally installed binary first (0.7s vs 1.4s npx overhead)
-    const result = spawnSync('which', ['wp-playground-cli'], { stdio: 'pipe' });
+    const cmd = process.platform === 'win32' ? 'where' : 'which';
+    const result = spawnSync(cmd, ['wp-playground-cli'], { stdio: 'pipe' });
     if (result.status === 0) {
-        return ['wp-playground-cli', []];
+        return ['wp-playground-cli', [], false];
     }
-    return ['npx', ['--yes', '@wp-playground/cli']];
+    return ['npx', ['--yes', '@wp-playground/cli'], true];
+}
+let npxHintShown = false;
+/** Test-only: reset the once-per-process hint guard. */
+export function _resetNpxHint() { npxHintShown = false; }
+/**
+ * One-time, dim hint shown when falling back to npx (no global binary). Explains
+ * the first-run download and how to skip it. Suppressed in --json mode.
+ */
+export function maybeShowNpxHint(usingNpx) {
+    if (!usingNpx || npxHintShown || isJsonMode())
+        return;
+    npxHintShown = true;
+    process.stderr.write(chalk.dim('# WordPress Playground not found globally — using npx (downloads once, may take ~30s).\n') +
+        chalk.dim('# Tip: npm i -g @wp-playground/cli  to skip this on future runs.\n'));
 }
 export function getLocalBaseDir() {
     return LOCAL_BASE_DIR;
@@ -122,6 +143,28 @@ export function deleteInstanceDir(name) {
         rmSync(dir, { recursive: true, force: true });
     }
 }
+/**
+ * Build the wp-playground-cli argument(s) to mount a host path at a VFS path.
+ *
+ * `--mount` / `--mount-before-install` take a single `host:vfs` value, which
+ * wp-playground-cli splits on `:`. On Windows the host path contains a
+ * drive-letter colon (e.g. `C:\Users\...\wp-content`), so the split yields 3+
+ * parts and Playground rejects it with "Invalid mount format". On Windows we
+ * instead use `--mount-dir` / `--mount-dir-before-install`, which take the host
+ * and vfs paths as two separate args (`nargs: 2`) and avoid the colon entirely.
+ * Both forms resolve to the same `{ hostPath, vfsPath }` mount in Playground
+ * (no file-vs-directory distinction), so this works for files and directories.
+ *
+ * macOS/Linux keep the long-standing colon form unchanged (their absolute paths
+ * have no drive-letter colon). `platform` is injectable for testing.
+ */
+export function buildMountArgs(hostPath, vfsPath, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    if (platform === 'win32') {
+        return [opts.beforeInstall ? '--mount-dir-before-install' : '--mount-dir', hostPath, vfsPath];
+    }
+    return [`${opts.beforeInstall ? '--mount-before-install' : '--mount'}=${hostPath}:${vfsPath}`];
+}
 function buildServerArgs(instance, blueprint) {
     const wpContentDir = join(instance.path, 'wp-content');
     const isClone = existsSync(join(instance.path, 'sqlite-import.sql')) ||
@@ -140,7 +183,7 @@ function buildServerArgs(instance, blueprint) {
         for (const subdir of subdirs) {
             const hostDir = join(wpContentDir, subdir);
             if (existsSync(hostDir)) {
-                args.push(`--mount=${hostDir}:/wordpress/wp-content/${subdir}`);
+                args.push(...buildMountArgs(hostDir, `/wordpress/wp-content/${subdir}`));
             }
         }
         // Mount non-core root files (CLAUDE.md, .htaccess, etc.)
@@ -151,7 +194,7 @@ function buildServerArgs(instance, blueprint) {
             const filePath = join(instance.path, file);
             const stat = statSync(filePath);
             if (stat.isFile()) {
-                args.push(`--mount=${filePath}:/wordpress/${file}`);
+                args.push(...buildMountArgs(filePath, `/wordpress/${file}`));
             }
         }
         // Use clone blueprint if it exists (has AST driver + login step)
@@ -164,7 +207,7 @@ function buildServerArgs(instance, blueprint) {
     }
     else {
         // For fresh sites: mount entire wp-content before install for persistence
-        args.push(`--mount-before-install=${wpContentDir}:/wordpress/wp-content`);
+        args.push(...buildMountArgs(wpContentDir, '/wordpress/wp-content', { beforeInstall: true }));
     }
     if (blueprint) {
         args.push(`--blueprint=${blueprint}`);
@@ -178,7 +221,8 @@ function buildServerArgs(instance, blueprint) {
  */
 export function startServer(instance, opts) {
     const args = buildServerArgs(instance, opts?.blueprint);
-    const [cmd, prefixArgs] = getPlaygroundCommand();
+    const [cmd, prefixArgs, usingNpx] = getPlaygroundCommand();
+    maybeShowNpxHint(usingNpx);
     return new Promise((resolve, reject) => {
         const child = spawn(cmd, [...prefixArgs, ...args], {
             stdio: ['inherit', 'pipe', 'pipe'],
@@ -209,7 +253,9 @@ export function startServer(instance, opts) {
             if (process.stdin.isTTY) {
                 process.stdin.setRawMode?.(false);
             }
-            spawnSync('stty', ['sane'], { stdio: 'inherit' });
+            if (process.platform !== 'win32') {
+                spawnSync('stty', ['sane'], { stdio: 'inherit' });
+            }
             resolve(code ?? 0);
         });
     });
@@ -221,7 +267,8 @@ export function startServer(instance, opts) {
  */
 export async function startServerBackground(instance, blueprint) {
     const args = buildServerArgs(instance, blueprint);
-    const [cmd, prefixArgs] = getPlaygroundCommand();
+    const [cmd, prefixArgs, usingNpx] = getPlaygroundCommand();
+    maybeShowNpxHint(usingNpx);
     const logFile = join(instance.path, 'server.log');
     const pidFile = join(instance.path, 'server.pid');
     // Spawn fully detached with output to log file