screenci 0.0.83 → 0.0.85

package/dist/cli.d.ts

@@ -2,7 +2,9 @@ import type { RecordingCustomVoiceRef, RecordingData } from './src/events.js';
 import type { VoiceKey } from './src/voices.js';
 import type { RecordUploadPolicy, ScreenCIConfig } from './src/types.js';
 import { getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl } from './src/linkSession.js';
+import { type CliCredential } from './src/anonSession.js';
 export { getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl };
+export { secretCredential, anonCredential } from './src/anonSession.js';
 type PlaywrightListReportSuite = {
     title?: string;
     specs?: Array<{
@@ -26,7 +28,7 @@ export declare function detectInteractiveSession(env?: NodeJS.ProcessEnv, stdout
 }): boolean;
 export declare function collectPlaywrightListTitles(suites: readonly PlaywrightListReportSuite[]): string[];
 /** What an uploaded file actually is, used to label it in the upload log. */
-type UploadAssetKind = 'overlay' | 'audio' | 'clip' | 'voice';
+type UploadAssetKind = 'overlay' | 'audio' | 'clip' | 'voice' | 'cursor';
 type PreparedUploadAsset = {
     kind: UploadAssetKind;
     fileHash: string;
@@ -101,7 +103,7 @@ export type ResolveAssetsResponse = {
  * Returns the assets that could not be resolved (no previous version), so the
  * caller can fail the recording with actionable guidance.
  */
-export declare function resolveMissingUploadAssets(assets: PreparedUploadAsset[], projectName: string, videoName: string, apiUrl: string, secret: string, signal: AbortSignal, progressReporter?: {
+export declare function resolveMissingUploadAssets(assets: PreparedUploadAsset[], projectName: string, videoName: string, apiUrl: string, credential: CliCredential, signal: AbortSignal, progressReporter?: {
     info: (message: string) => void;
 }): Promise<PreparedUploadAsset[]>;
 /**
@@ -109,7 +111,7 @@ export declare function resolveMissingUploadAssets(assets: PreparedUploadAsset[]
  * previously uploaded version to reuse.
  */
 export declare function formatUnresolvedAssetMessage(videoName: string, unresolved: PreparedUploadAsset[]): string;
-export declare function uploadRecordings(screenciDir: string, projectName: string, apiUrl: string, secret: string, specificEntry?: string, verbose?: boolean): Promise<{
+export declare function uploadRecordings(screenciDir: string, projectName: string, apiUrl: string, credential: CliCredential, specificEntry?: string, verbose?: boolean): Promise<{
     projectId: string | null;
     recordId: string | null;
     hadFailures: boolean;
@@ -135,6 +137,17 @@ export declare function requireScreenCISecret(configPath?: string): Promise<{
     apiUrl: string;
 }>;
 export declare function extractGrep(args: string[]): string | undefined;
+/**
+ * Resolves the credential `record`'s upload should authenticate with. A real
+ * SCREENCI_SECRET wins outright. Otherwise, checks the locally stored anon
+ * trial token: `claimed` self-upgrades by writing the real secret into `.env`
+ * and deleting the local anon state (no manual step required); `not_found`/
+ * `expired` nags and starts a fresh trial; `pending` proceeds anonymously.
+ */
+export declare function resolveUploadCredential(screenciDir: string, apiUrl: string, envFilePath: string, secretFromEnv: string | undefined): Promise<{
+    credential: CliCredential;
+    usedAnonCredential: boolean;
+}>;
 export declare function main(): Promise<void>;
 export declare function parseRecordCliArgs(args: string[]): {
     configPath: string | undefined;

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -10,16 +10,22 @@ import { Command, CommanderError } from 'commander';
 import { confirm } from '@inquirer/prompts';
 import pc from 'picocolors';
 import { logger } from './src/logger.js';
-import { determinePackageManager, parsePackageManager, runInit, } from './src/init.js';
+import { determinePackageManager, initToggleOptionsFromCommander, parsePackageManager, registerInitToggleOptions, runInit, } from './src/init.js';
 import { SCREENCI_DISABLE_RECORDING_TIMINGS_ENV, SCREENCI_MOCK_RECORD_ENV, SCREENCI_LANGUAGES_ENV, SCREENCI_VALUES_OVERRIDES_ENV, SCREENCI_RECORD_OPTIONS_ENV, isUploadExistingEnabled, } from './src/runtimeMode.js';
 import { DEFAULT_RECORD_UPLOAD_POLICY } from './src/defaults.js';
 import { findDuplicateTitles, formatDuplicateTitlesMessage, } from './src/titleValidation.js';
-import { getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl, getScreenCISecretsUrl, } from './src/linkSession.js';
+import { getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl, getScreenCISecretsUrl, persistScreenCISecret, } from './src/linkSession.js';
 import { OVERLAY_CACHE_DIR_NAME } from './src/htmlRasterizer.js';
 import { maybeExtractVoiceSampleAudio } from './src/voiceSampleAudio.js';
+import { anonCredential, checkAnonSessionStatus, deleteAnonSessionFile, getOrCreateAnonToken, secretCredential, } from './src/anonSession.js';
 // Re-export the environment-aware URL helpers so existing importers (and tests)
 // can keep importing them from the CLI entrypoint.
 export { getCliLinkSessionApiUrl, getDevBackendUrl, getDevFrontendUrl };
+// Re-exported so test files that mock fs/fs/promises can obtain these via the
+// same dynamic `await import('./cli')` they already use, rather than a static
+// top-level import — a static import of `./src/anonSession.js` (which imports
+// fs) would resolve before the test file's own mock variables initialize.
+export { secretCredential, anonCredential } from './src/anonSession.js';
 const SCREENCI_MOCK_RECORD_DOCS_URL = 'https://screenci.com/docs/reference/cli/#--mock-record';
 const SCREENCI_RECORD_DOCS_URL = 'https://screenci.com/docs/reference/cli/#screenci-record';
 // Records the recordId of the most recent `screenci record` upload so
@@ -218,6 +224,8 @@ const UPLOAD_ASSET_LABEL = {
     // (e.g. via `narration({ en: { intro: { media } } })`).
     clip: 'Narration',
     voice: 'Voice',
+    // A custom cursor image set via `renderOptions.mouse.image`.
+    cursor: 'Cursor',
 };
 export function formatStudioUrl(appUrl, projectId, videoId) {
     // The video hub resolves `?studio` to the right language page and scrolls it
@@ -346,7 +354,7 @@ async function loadUploadCandidate(screenciDir, entry, verbose) {
         preparedUploadAssets,
     };
 }
-async function uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, secret, verbose, uploadAbort, progressReporter, progressIndex, recordId, expectedScreenshotCount) {
+async function uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, credential, verbose, uploadAbort, progressReporter, progressIndex, recordId, expectedScreenshotCount) {
     const { entry, videoName, data: rawData, preparedUploadAssets } = candidate;
     let projectId = null;
     let videoId = null;
@@ -377,7 +385,7 @@ async function uploadRecordingCandidate(candidate, screenciDir, projectName, api
         // for overlays, no hash. Recover their identity from a previous upload of
         // this video before starting, so the recording data references them by hash
         // and the backend existence check confirms they are still stored.
-        const unresolved = await resolveMissingUploadAssets(preparedUploadAssets, projectName, videoName, apiUrl, secret, uploadAbort.signal, progressReporter);
+        const unresolved = await resolveMissingUploadAssets(preparedUploadAssets, projectName, videoName, apiUrl, credential, uploadAbort.signal, progressReporter);
         if (unresolved.length > 0) {
             progressReporter.complete(progressIndex, 'failure');
             return {
@@ -395,7 +403,7 @@ async function uploadRecordingCandidate(candidate, screenciDir, projectName, api
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
-                'X-ScreenCI-Secret': secret,
+                [credential.header]: credential.value,
             },
             body: JSON.stringify({
                 projectName,
@@ -438,7 +446,7 @@ async function uploadRecordingCandidate(candidate, screenciDir, projectName, api
                 videoId: null,
                 hadFailure: true,
                 videoName,
-                failureMessage: formatUploadStartFailureMessage(videoName, startResponse.status, text, secret),
+                failureMessage: formatUploadStartFailureMessage(videoName, startResponse.status, text, credential.value),
                 recordId,
             };
         }
@@ -463,7 +471,7 @@ async function uploadRecordingCandidate(candidate, screenciDir, projectName, api
             logger.info(`recordingId=${recordingId} projectId=${projectId}`);
             logger.info(`assets=${preparedUploadAssets.length} recordingHash=${recordingHash ?? 'none'}`);
         }
-        await uploadAssets(preparedUploadAssets, apiUrl, secret, recordingId, uploadAbort.signal, uploadAbort.throwIfAborted, progressReporter);
+        await uploadAssets(preparedUploadAssets, apiUrl, credential, recordingId, uploadAbort.signal, uploadAbort.throwIfAborted, progressReporter);
         uploadAbort.throwIfAborted();
         const fileStat = await stat(recordingPath);
         if (verbose) {
@@ -481,7 +489,7 @@ async function uploadRecordingCandidate(candidate, screenciDir, projectName, api
                     headers: {
                         'Content-Type': recordingContentType,
                         'Content-Length': String(fileStat.size),
-                        'X-ScreenCI-Secret': secret,
+                        [credential.header]: credential.value,
                     },
                     body: stream,
                     signal: uploadAbort.signal,
@@ -501,7 +509,7 @@ async function uploadRecordingCandidate(candidate, screenciDir, projectName, api
                 videoId,
                 hadFailure: true,
                 videoName,
-                failureMessage: `Failed to upload recording for "${videoName}": ${recordingResponse.status} ${extractBackendError(text)}${hint401(recordingResponse.status, secret)}`,
+                failureMessage: `Failed to upload recording for "${videoName}": ${recordingResponse.status} ${extractBackendError(text)}${hint401(recordingResponse.status, credential.value)}`,
                 recordId,
                 ...(plan !== null && { plan }),
             };
@@ -1095,6 +1103,37 @@ export async function collectUploadAssets(data, configDir) {
     for (const asset of await prepareCustomVoiceAssets(data, configDir)) {
         assets.set(`path:${asset.path}`, asset);
     }
+    // Custom cursor image (`renderOptions.mouse.image`). Unlike overlays it is not
+    // referenced by a timeline event, so it is collected here. It is a local path
+    // only before upload; a `{ assetPath, fileHash }` value has already been
+    // uploaded (e.g. re-running the CLI on annotated data) and needs no work.
+    const cursorImage = data.renderOptions?.mouse?.image;
+    if (typeof cursorImage === 'string' && !assets.has(`path:${cursorImage}`)) {
+        const resolvedFile = await readRecordingFile(cursorImage, configDir, sourceFilePath);
+        if (resolvedFile === null) {
+            // The local file is gone (e.g. gitignored on CI). Reference it by path so
+            // its identity can be recovered from a previous upload of this video.
+            assets.set(`path:${cursorImage}`, {
+                kind: 'cursor',
+                fileHash: '',
+                path: cursorImage,
+                size: 0,
+                needsResolve: true,
+            });
+        }
+        else {
+            assets.set(`path:${cursorImage}`, {
+                kind: 'cursor',
+                fileHash: createHash('sha256')
+                    .update(resolvedFile.buffer)
+                    .digest('hex'),
+                path: cursorImage,
+                size: resolvedFile.buffer.byteLength,
+                fileBuffer: resolvedFile.buffer,
+                contentType: contentTypeForPath(resolvedFile.resolvedPath),
+            });
+        }
+    }
     return [...assets.values()];
 }
 export function stripVoicePath(voice, byPath) {
@@ -1122,8 +1161,26 @@ export function annotateRecordingDataWithAssetHashes(data, assets) {
             byName.set(asset.name, asset.fileHash);
         byPath.set(asset.path, asset.fileHash);
     }
+    // Rewrite a custom cursor image (`renderOptions.mouse.image`) from its local
+    // path to `{ assetPath, fileHash }` so the renderer can resolve it by content
+    // hash. Leave it untouched when it is already an object or has no known hash.
+    const renderOptions = (() => {
+        const ro = data.renderOptions;
+        const mouse = ro?.mouse;
+        const image = mouse?.image;
+        if (mouse === undefined || typeof image !== 'string')
+            return ro;
+        const fileHash = byPath.get(image);
+        if (fileHash === undefined)
+            return ro;
+        return {
+            ...ro,
+            mouse: { ...mouse, image: { assetPath: image, fileHash } },
+        };
+    })();
     return {
         ...data,
+        renderOptions,
         events: data.events.map((event) => {
             if (event.type === 'assetStart') {
                 if ('studio' in event || 'dependency' in event)
@@ -1296,7 +1353,7 @@ export function displayAssetPath(assetPath) {
  * Returns the assets that could not be resolved (no previous version), so the
  * caller can fail the recording with actionable guidance.
  */
-export async function resolveMissingUploadAssets(assets, projectName, videoName, apiUrl, secret, signal, progressReporter) {
+export async function resolveMissingUploadAssets(assets, projectName, videoName, apiUrl, credential, signal, progressReporter) {
     const pending = assets.filter((asset) => asset.needsResolve === true);
     if (pending.length === 0)
         return [];
@@ -1309,14 +1366,14 @@ export async function resolveMissingUploadAssets(assets, projectName, videoName,
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
-            'X-ScreenCI-Secret': secret,
+            [credential.header]: credential.value,
         },
         body: JSON.stringify({ projectName, videoName, assets: refs }),
         signal,
     }), signal);
     if (!res.ok) {
         const text = await res.text();
-        throw new UploadAssetError(`Failed to resolve previously uploaded assets for "${videoName}": ${res.status} ${extractBackendError(text)}${hint401(res.status, secret)}`);
+        throw new UploadAssetError(`Failed to resolve previously uploaded assets for "${videoName}": ${res.status} ${extractBackendError(text)}${hint401(res.status, credential.value)}`);
     }
     const body = (await res.json());
     const resolved = Array.isArray(body.resolved) ? body.resolved : [];
@@ -1359,7 +1416,7 @@ export function formatUnresolvedAssetMessage(videoName, unresolved) {
         'Record once with these files present so they are uploaded, or commit them so they are available here.',
     ].join('\n');
 }
-async function uploadAssets(assets, apiUrl, secret, recordingId, signal, throwIfAborted, progressReporter) {
+async function uploadAssets(assets, apiUrl, credential, recordingId, signal, throwIfAborted, progressReporter) {
     const logInfo = (message) => {
         if (progressReporter) {
             progressReporter.info(message);
@@ -1377,7 +1434,7 @@ async function uploadAssets(assets, apiUrl, secret, recordingId, signal, throwIf
                     method: 'POST',
                     headers: {
                         'Content-Type': 'application/json',
-                        'X-ScreenCI-Secret': secret,
+                        [credential.header]: credential.value,
                     },
                     body: JSON.stringify({
                         fileHash: asset.fileHash,
@@ -1390,7 +1447,7 @@ async function uploadAssets(assets, apiUrl, secret, recordingId, signal, throwIf
                 }), signal);
                 if (!checkRes.ok) {
                     const text = await checkRes.text();
-                    throw new UploadAssetError(`Failed to check asset ${displayAssetPath(asset.path)}: ${checkRes.status} ${extractBackendError(text)}${hint401(checkRes.status, secret)}`);
+                    throw new UploadAssetError(`Failed to check asset ${displayAssetPath(asset.path)}: ${checkRes.status} ${extractBackendError(text)}${hint401(checkRes.status, credential.value)}`);
                 }
                 const checkBody = (await checkRes.json());
                 if (checkBody.exists) {
@@ -1420,7 +1477,7 @@ async function uploadAssets(assets, apiUrl, secret, recordingId, signal, throwIf
                 headers: {
                     'Content-Type': contentType,
                     'Content-Length': String(fileBuffer.byteLength),
-                    'X-ScreenCI-Secret': secret,
+                    [credential.header]: credential.value,
                     'X-ScreenCI-File-Hash': asset.fileHash,
                     'X-ScreenCI-Asset-Size': String(asset.size),
                     'X-ScreenCI-Asset-Path': encodeURIComponent(asset.path),
@@ -1434,7 +1491,7 @@ async function uploadAssets(assets, apiUrl, secret, recordingId, signal, throwIf
                     logInfo(`${pc.green('✔')} ${label} already exists: ${displayAssetPath(asset.path)}`);
                 }
                 else {
-                    throw new UploadAssetError(`Failed to upload asset ${displayAssetPath(asset.path)}: ${res.status} ${extractBackendError(text)}${hint401(res.status, secret)}`);
+                    throw new UploadAssetError(`Failed to upload asset ${displayAssetPath(asset.path)}: ${res.status} ${extractBackendError(text)}${hint401(res.status, credential.value)}`);
                 }
             }
             else {
@@ -1452,7 +1509,7 @@ async function uploadAssets(assets, apiUrl, secret, recordingId, signal, throwIf
         }
     }
 }
-export async function uploadRecordings(screenciDir, projectName, apiUrl, secret, specificEntry, verbose = false) {
+export async function uploadRecordings(screenciDir, projectName, apiUrl, credential, specificEntry, verbose = false) {
     const uploadAbort = createUploadAbortController('upload');
     const recordId = randomUUID();
     let entries;
@@ -1500,7 +1557,7 @@ export async function uploadRecordings(screenciDir, projectName, apiUrl, secret,
         // waits for all of them to land before dispatching the batch, so it needs
         // to know how many to expect.
         const screenshotCount = candidates.filter((candidate) => candidate.data.output === 'screenshot').length;
-        const results = await Promise.all(candidates.map(async (candidate, index) => await uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, secret, verbose, uploadAbort, progressReporter, index, recordId, screenshotCount)));
+        const results = await Promise.all(candidates.map(async (candidate, index) => await uploadRecordingCandidate(candidate, screenciDir, projectName, apiUrl, credential, verbose, uploadAbort, progressReporter, index, recordId, screenshotCount)));
         firstProjectId =
             results.find((result) => result.projectId !== null)?.projectId ?? null;
         const resolvedPlan = results.find((result) => result.plan !== undefined)?.plan ?? null;
@@ -1761,10 +1818,10 @@ export async function requireScreenCISecret(configPath) {
     const { resolvedConfigPath, screenciConfig } = await loadScreenCIConfigAndEnv(configPath);
     const secret = process.env.SCREENCI_SECRET;
     if (!secret) {
-        // No browser sign-in flow: the secret comes from an init one-time token or
-        // from the secrets page. Guide the user to either path and exit non-zero.
+        // These commands need a real account (unlike `record`, which can upload
+        // anonymously): guide the user to copy their secret and exit non-zero.
         const envFilePath = await resolveProjectEnvFilePath(resolvedConfigPath);
-        logger.error(`No SCREENCI_SECRET configured. Copy your secret from ${pc.cyan(getScreenCISecretsUrl())} into ${envFilePath}, or re-run init with a one-time setup token from ${pc.cyan(getScreenCISecretsUrl())}.`);
+        logger.error(`No SCREENCI_SECRET configured. Copy your secret from ${pc.cyan(getScreenCISecretsUrl())} into ${envFilePath}.`);
         logScreenCISecretGuide();
         process.exit(1);
     }
@@ -1930,6 +1987,39 @@ async function printInfo(configPath) {
     const data = await res.json();
     process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
 }
+/**
+ * Resolves the credential `record`'s upload should authenticate with. A real
+ * SCREENCI_SECRET wins outright. Otherwise, checks the locally stored anon
+ * trial token: `claimed` self-upgrades by writing the real secret into `.env`
+ * and deleting the local anon state (no manual step required); `not_found`/
+ * `expired` nags and starts a fresh trial; `pending` proceeds anonymously.
+ */
+export async function resolveUploadCredential(screenciDir, apiUrl, envFilePath, secretFromEnv) {
+    if (secretFromEnv) {
+        return {
+            credential: secretCredential(secretFromEnv),
+            usedAnonCredential: false,
+        };
+    }
+    const token = await getOrCreateAnonToken(screenciDir);
+    const status = await checkAnonSessionStatus(token, { backendUrl: apiUrl });
+    if (status.status === 'claimed') {
+        await persistScreenCISecret(envFilePath, status.secret);
+        await deleteAnonSessionFile(screenciDir);
+        logger.info('Linked to your ScreenCI account. Future uploads use your API key.');
+        return {
+            credential: secretCredential(status.secret),
+            usedAnonCredential: false,
+        };
+    }
+    if (status.status === 'not_found' || status.status === 'expired') {
+        logger.info('Your previous trial expired or was already claimed elsewhere. Starting a new one.');
+        await deleteAnonSessionFile(screenciDir);
+        const freshToken = await getOrCreateAnonToken(screenciDir);
+        return { credential: anonCredential(freshToken), usedAnonCredential: true };
+    }
+    return { credential: anonCredential(token), usedAnonCredential: true };
+}
 // Uploads the recordings already written under `.screenci` for the resolved
 // config. Shared by `record` (after a Playwright run) and `retry` (which
 // re-sends the existing recordings without re-running Playwright). A non-null
@@ -1950,17 +2040,17 @@ async function uploadRecordedVideosForConfig(configPath, playwrightFailure, verb
             : resolve(dirname(resolvedConfigPath), '.env'), true);
         const apiUrl = getDevBackendUrl();
         const appUrl = getDevFrontendUrl();
-        const secret = process.env.SCREENCI_SECRET;
         const uploadPolicy = resolveRecordUploadPolicy(screenciConfig);
         const configDir = dirname(resolvedConfigPath);
         const screenciDir = resolve(configDir, '.screenci');
+        const envFilePath = screenciConfig.envFile
+            ? resolve(configDir, screenciConfig.envFile)
+            : resolve(configDir, '.env');
         const completedRecordingCount = await countCompletedRecordings(screenciDir);
+        const { credential, usedAnonCredential } = await resolveUploadCredential(screenciDir, apiUrl, envFilePath, process.env.SCREENCI_SECRET);
         if (playwrightFailure !== null && completedRecordingCount === 0) {
             logger.info('All recordings failed.');
         }
-        else if (!secret) {
-            logger.info(`No SCREENCI_SECRET configured for uploads. Copy your secret from ${getScreenCISecretsUrl()} into the project env file, then rerun ${getSuggestedScreenciCommand('record')}.`);
-        }
         else if (playwrightFailure !== null &&
             uploadPolicy === 'all-or-nothing') {
             logger.info('Some recordings failed, skipping upload because record.upload is "all-or-nothing".');
@@ -1981,7 +2071,7 @@ async function uploadRecordedVideosForConfig(configPath, playwrightFailure, verb
                 plan: null,
             };
             try {
-                uploadResult = await uploadRecordings(screenciDir, screenciConfig.projectName, apiUrl, secret, undefined, verbose);
+                uploadResult = await uploadRecordings(screenciDir, screenciConfig.projectName, apiUrl, credential, undefined, verbose);
             }
             catch (err) {
                 if (isUploadCancelledError(err)) {
@@ -2024,6 +2114,9 @@ async function uploadRecordedVideosForConfig(configPath, playwrightFailure, verb
                     : 'Recording finished, rendering in progress. Results available at:');
                 logger.info(pc.cyan(projectUrl));
             }
+            if (usedAnonCredential && (recordId !== null || projectId !== null)) {
+                logger.info('Recorded without an account. Open the link above to view it, and sign up to keep it (by continuing you agree to the Terms).');
+            }
             if (notices.length > 0) {
                 logger.info('');
                 for (const notice of notices) {
@@ -2194,20 +2287,22 @@ export async function main() {
         await deleteVideoCommand(id, options['yes'] ?? false, options['config']);
     });
     // init command
-    program
+    const initCommand = program
         .command('init [name]')
         .description('Initialize a new screenci project')
         .option('--agent <name>', 'target agent for skills install, e.g. opencode. Supported agents: https://github.com/vercel-labs/skills#supported-agents')
         .option('--package-manager <manager>', `package manager to use: npm, pnpm, or yarn 2+ (default: ${defaultPackageManager})`)
         .option('-y, --yes', 'accept init defaults')
-        .option('-v, --verbose', 'verbose output')
-        .action(async (name, options) => {
+        .option('-v, --verbose', 'verbose output');
+    registerInitToggleOptions(initCommand);
+    initCommand.action(async (name, options) => {
         const agent = options['agent'];
         await runInit(name, {
             verbose: options['verbose'] ?? false,
             yes: options['yes'] ?? false,
             packageManager: parsePackageManager(options['packageManager'], process.env['SCREENCI_INIT_CWD'] ?? process.cwd()),
             ...(agent !== undefined ? { agent } : {}),
+            ...initToggleOptionsFromCommander(options),
         });
     });
     try {
@@ -2353,6 +2448,11 @@ function validateArgs(args) {
  * code seeds, and a recording is never blocked by this fetch.
  */
 async function fetchTextOverridesEnv(configPath, languages, verbose) {
+    // Studio config only exists for a real (non-anonymous) org, and record must
+    // still work without an account, so skip the fetch entirely rather than
+    // calling requireScreenCISecret, which would hard-exit without a secret.
+    if (!process.env.SCREENCI_SECRET)
+        return {};
     try {
         const { screenciConfig, secret, apiUrl } = await requireScreenCISecret(configPath);
         const params = new URLSearchParams({
@@ -2393,6 +2493,11 @@ async function fetchTextOverridesEnv(configPath, languages, verbose) {
  * is never blocked by this fetch.
  */
 async function fetchRecordOptionsEnv(configPath, verbose) {
+    // Studio config only exists for a real (non-anonymous) org, and record must
+    // still work without an account, so skip the fetch entirely rather than
+    // calling requireScreenCISecret, which would hard-exit without a secret.
+    if (!process.env.SCREENCI_SECRET)
+        return {};
     try {
         const { screenciConfig, secret, apiUrl } = await requireScreenCISecret(configPath);
         const params = new URLSearchParams({
@@ -2427,9 +2532,10 @@ async function run(command, additionalArgs, customConfigPath, verbose = false, m
     if (command === 'test' || process.env.SCREENCI_RECORDING !== 'true') {
         await loadEnvFileFromConfigSource(configPath, false);
     }
-    // Only validate args for record command
+    // Only validate args for record command. No secret is required here: record
+    // can upload anonymously (see resolveUploadCredential), so this must not
+    // hard-exit the way requireScreenCISecret does for account-only commands.
     if (command === 'record') {
-        await requireScreenCISecret(configPath);
         validateArgs(additionalArgs);
         const screenciDir = resolve(dirname(configPath), '.screenci');
         clearRecordingDirectories(screenciDir);