replicas-cli 0.3.104 → 0.3.106

package/dist/index.cjs

@@ -24527,7 +24527,7 @@ Every Replicas workspace is a remote Linux VM. Repositories are cloned under \`~
 
 Hooks run with \`bash -lc\` from \`~/workspaces\` (the parent of every repository checkout), so start scripts with \`cd ~/workspaces/<repo-name>\`. A repository may also ship its own \`replicas.json\` / \`replicas.yaml\` with \`startHook\`, \`warmHook\`, and \`systemPrompt\`; repository hooks run after the environment hooks. Prefer proposing environment hooks unless the repository already manages its own.
 
-The organization's base environment applies to every environment built on it; never propose putting repository-specific setup there.
+Forks inherit everything their parent sets; never propose putting repository-specific setup in an environment other environments fork from.
 
 ## Progress and the setup run
 
@@ -24735,7 +24735,6 @@ After \`propose\` succeeds, mark the \`propose\` step completed and send one mes
 - <two to four findings about the codebase that shaped the configuration, written for a person>
 
 ![<Project> walkthrough](<chat embed URL printed by replicas media upload>)
-[View in Canvas](<View in Replicas URL>)
 
 **Proposed configuration**
 Review the start hook, warm hook, system prompt, variables, and automations in the Environment panel on the right. Edit anything inline, then select **Save configuration**. Ask me here if you want changes and I will revise the proposal.
@@ -25185,6 +25184,12 @@ var REFERENCE8 = `# Media (Screenshots, GIFs, Recordings, Audio, HTML)
 
 This is the single source of truth for delivering screenshots, GIFs, screen recordings, generated diagrams, audio clips, and self-contained HTML pages through Replicas and external surfaces (Slack, Linear, GitHub, GitLab).
 
+## Always
+
+- Every picture, GIF, recording, or HTML page you mention in your reply to the user shows up in that reply: paste its printed \`![\u2026](\u2026)\` or \`HTML page\` line on its own line. Do this even when you also posted it to a PR, Slack, Linear, or GitLab, and even when the task came from one of them.
+- Never send the user somewhere else to see it ("see the Canvas", "check the media tab"). Uploads also appear in the Canvas's media folder, so they stay there for later.
+- Keep the whole \`replicas media upload\` output. Don't pipe it through \`tail\`, \`grep\`, or \`head\`; you need every line it prints.
+
 ## Prerequisites
 
 The \`replicas\` CLI is pre-installed and authenticated in your workspace. No additional setup is needed.
@@ -25253,7 +25258,7 @@ If none of these apply, don't upload.
 \`replicas media upload\` is always the first delivery action. When the current task has an external destination, every other delivery step follows only after that command succeeds. For every file:
 
 1. First, run \`replicas media upload\` with the original file. Do not begin any destination upload until the command succeeds. This creates the canonical dashboard copy and prints an embed plus a per-file dashboard link. Every image gets a public link, so its printed embed works in chat and on GitHub.
-2. Include the printed embed line in the Replicas chat reply, followed by **View in Canvas** using the matching per-file dashboard URL. HTML uses its printed page link instead of an image embed.
+2. Include the printed embed line in the Replicas chat reply. HTML uses its printed page link instead of an image embed.
 3. Identify every destination in the task and use its inline representation from the table below. Slack, Linear, and GitLab require an upload of the same original bytes; GitHub uses the image's printed public embed.
 4. Put the **View in Replicas** dashboard link next to the destination embed as a secondary link.
 5. Check each destination response. If its upload or public link fails, say so explicitly and keep the dashboard link; never claim that a dashboard link is an inline embed.
@@ -25294,21 +25299,13 @@ Names are normalized to hyphen-case (spaces become hyphens, e.g. \`Login page\`
 
 For each media file, the CLI prints an embed line and a dashboard link:
 
-1. Images always print \`![filename](<public-url>)\`. This public, stable link works in Replicas chat, GitHub, and anywhere else Markdown images render. No flag is needed.
-2. Video and audio print \`Replicas chat embed: ![filename](<api-url>)\` by default; this authenticated URL renders inline in Replicas chat **only** \u2014 see below. \`--access public\` prints a public embed instead.
+1. Images always print \`![<name>](<public-url>)\`, using the \`--name\` you passed. This public, stable link works in Replicas chat, GitHub, and anywhere else Markdown images render. No flag is needed.
+2. Video and audio print \`Replicas chat embed: ![<name>](<api-url>)\` by default; this authenticated URL renders inline in Replicas chat **only** \u2014 see below. \`--access public\` prints a public link instead, \`[<name>](<public-url>)\`, which plays in Replicas chat and opens the video anywhere else. Never put a video inside \`![\u2026](\u2026)\` or a \`<video>\` tag on GitHub: it shows as a broken image or disappears. Videos also print the PR line to paste once you have a GIF, already linked to the video.
 3. \`View in Replicas: <deep-link>\` is a per-file dashboard URL of the form \`https://app.replicas.dev/workspaces/<workspace-id>?mode=media&media=<media-id>\` that opens directly to that specific file.
 
 Match each "View in Replicas" line to the embed line directly above it \u2014 that's the deep link for that file.
 
-HTML uploads print an \`HTML page\` Markdown link instead of an image embed.
-
-For an HTML page that should stay inside the Replicas organization, create an authenticated link:
-
-\`\`\`bash
-replicas media upload recap.html --name "Visual recap" --access organization
-\`\`\`
-
-The printed \`Forge link (organization only)\` opens a dedicated page. Signed-in organization members go straight to it; signed-out members sign in and return to the page.
+HTML uploads print an \`HTML page\` Markdown link instead of an image embed. It previews the page inside Replicas chat only. They also print a \`Forge link (organization only)\` to use everywhere else: it opens a dedicated page, where signed-in organization members go straight to the report and signed-out members sign in first.
 
 Video and audio stay private unless they must play without Replicas sign-in; then pass \`--access public\` (alias \`--share\`):
 
@@ -25325,7 +25322,7 @@ Permanently delete an upload with \`replicas media delete <media-id>\`. The back
 | URL | What it is | Where it's allowed |
 |---|---|---|
 | \`https://api.replicas.dev/v1/media/<id>\` (inside \`![\u2026](\u2026)\`) | Authenticated API redirect printed for private video, audio, and HTML \u2014 requires the Replicas chat session | **Only** in the Replicas chat reply. Nowhere else. |
-| \`https://replicas.dev/organizations/<organization-id>/media/<media-id>\` | Organization-only page printed by \`--access organization\` | Pull requests and other places where every viewer belongs to the Replicas organization. |
+| \`https://app.replicas.dev/organizations/<organization-id>/media/<media-id>\` | Organization-only page (\`Forge link\`) printed for every HTML upload, and for video or audio with \`--access organization\` | Pull requests and other places where every viewer belongs to the Replicas organization. |
 | \`https://api.replicas.dev/v1/media/public/<id>/<token>\` | Public bearer URL printed for every image, and for video or audio with \`--access public\` | The Replicas chat reply and GitHub embeds. |
 | \`https://app.replicas.dev/workspaces/<workspace-id>?mode=media&media=<media-id>\` | Authenticated dashboard deep link that opens the media file in the workspace | Everywhere external: Slack, GitHub, GitLab, Linear, PR bodies, comments, emails. |
 
@@ -25343,7 +25340,7 @@ This rule has no exceptions:
 
 ### ALWAYS link a Replicas web URL \u2014 never the authenticated API URL \u2014 when referencing media externally
 
-For an organization-only HTML page, use the \`Forge link\` printed by \`--access organization\`. For other authenticated media references, use the dashboard form:
+For an HTML page, use its printed \`Forge link\`. For other authenticated media references, use the dashboard form:
 
 \`\`\`
 https://app.replicas.dev/workspaces/<workspace-id>?mode=media&media=<media-id>
@@ -25361,8 +25358,6 @@ Include each markdown embed line **verbatim** where you want that file to render
 
 Never reply with only dashboard links (for example a "Links:" list of \`?mode=media&media=\` URLs) in place of the embeds: a dashboard link renders as plain text, so the user sees nothing inline. This applies even when the task came from Slack, Linear, GitHub, or GitLab; the chat reply still gets the embeds.
 
-After (or alongside) the embeds, include a \`[View in Canvas](<deep-link>)\` hyperlink for each file using the per-file dashboard URL printed by the CLI as **View in Replicas**. Keep that URL unchanged so it opens the specific media item in the workspace's Canvas. External messages still label this dashboard link **View in Replicas**.
-
 ## On external platforms: embed the file AND link the dashboard
 
 After \`replicas media upload\` succeeds, external delivery has two required follow-up steps for every file:
@@ -25494,7 +25489,7 @@ gh pr edit 456 --body-file /tmp/pr-body.md
 gh pr comment 456 --body-file /tmp/comment.md
 \`\`\`
 
-GitHub does not play external videos inline, so show motion with a GIF (see *Make a GIF from a recording* above); its printed embed animates inline like any image. Videos stay private. When the full recording is also worth watching, upload the MP4 too and link the GIF to the recording's **View in Replicas** URL. When a still is enough, use a poster instead (\`ffmpeg -i /tmp/demo.mp4 -frames:v 1 /tmp/demo-poster.png\`), uploaded like any image:
+GitHub does not play external videos inline, so show motion with a GIF (see *Make a GIF from a recording* above); its printed embed animates inline like any image. Videos stay private. When the full recording is also worth watching, upload the MP4 too and paste the PR line it prints, with your GIF's link filled in. The GIF links to the recording's **View in Replicas** URL, or to its public link when you passed \`--access public\`. When a still is enough, use a poster instead (\`ffmpeg -i /tmp/demo.mp4 -frames:v 1 /tmp/demo-poster.png\`), uploaded like any image:
 
 \`\`\`markdown
 [![Checkout flow](<public-gif-or-poster-url>)](<recording-dashboard-url>)
@@ -25502,7 +25497,7 @@ GitHub does not play external videos inline, so show motion with a GIF (see *Mak
 
 Public links are unauthenticated bearer capabilities. Revoke with \`replicas media revoke <media-id>\` **only** when the user asks or the media should intentionally stop rendering; never as routine post-task cleanup, since revoking breaks every embed already posted on the PR.
 
-For a self-contained HTML report, upload it with \`--access organization\` and put the printed \`Forge link\` Markdown in the PR body or comment. GitHub cannot render the page inline, so use the normal link rather than image syntax. HTML pages cannot be shared publicly.
+For a self-contained HTML report, upload it and put the printed \`Forge link\` Markdown in the PR body or comment. GitHub cannot render the page inline, so use the normal link rather than image syntax. HTML pages cannot be shared publicly.
 
 Do **not** commit screenshots to the repo, use placeholder URLs, expose the authenticated \`/v1/media/<id>\` URL, or automate GitHub's undocumented browser upload flow.
 
@@ -25554,7 +25549,7 @@ replicas media upload chart-a.svg chart-b.svg --name "Latency chart" --name "Err
 - \`--kind <image|video|audio|html>\` \u2014 override auto-detection
 - \`--name <name>\`: required display name shown in the dashboard, one per file in order
 - \`--session-id <id>\` \u2014 associate the upload with a specific session
-- \`--access organization|public\`: for video, audio, and HTML, create an organization-only link or a public bearer URL (video and audio only). Images are always public
+- \`--access organization|public\`: for video and audio, print an organization-only link or create a public bearer URL. Images are always public, and HTML always gets an organization-only link
 - \`--share\`: alias for \`--access public\`; not supported for HTML
 `;
 var MEDIA_ABILITY = {
@@ -25997,7 +25992,7 @@ replicas environment delete <id-or-name> [--force]
 \`\`\`
 
 Notes:
-- Environments resolve by **name or UUID**. \`replicas environment list\` marks the org's base environment, which every other environment builds on.
+- Environments resolve by **name or UUID**. A fork inherits its parent's setup and can override or hide any of it.
 - An env needs a repo to back a workspace with code. If you \`create\` without \`--repository\`, the CLI prompts; in non-interactive contexts pass \`-r\`.
 
 ### Environment variables
@@ -28765,7 +28760,7 @@ var headlessAgentRequestSchema = external_exports.object({
 });
 
 // ../shared/src/cli-version.ts
-var CLI_VERSION = "0.3.104";
+var CLI_VERSION = "0.3.106";
 
 // ../shared/src/version.ts
 function compareVersions(v1, v2) {
@@ -31617,8 +31612,8 @@ async function resolveEnvironmentId(input) {
   }
   return resolved.id;
 }
-function printEnvironment(env, isBase = false) {
-  console.log(import_chalk20.default.white(`  ${env.name}${isBase ? import_chalk20.default.gray(" (base)") : ""}`));
+function printEnvironment(env) {
+  console.log(import_chalk20.default.white(`  ${env.name}`));
   console.log(import_chalk20.default.gray(`    ID: ${env.id}`));
   if (env.description) {
     console.log(import_chalk20.default.gray(`    Description: ${env.description}`));
@@ -31636,7 +31631,7 @@ function printEnvironment(env, isBase = false) {
 async function environmentListCommand() {
   ensureOrgApiAuthenticated();
   const response = await orgAuthenticatedFetch("/v1/environments");
-  output(response, ({ environments, base_environment_id }) => {
+  output(response, ({ environments }) => {
     if (environments.length === 0) {
       console.log(import_chalk20.default.yellow("\nNo environments found.\n"));
       return;
@@ -31644,7 +31639,7 @@ async function environmentListCommand() {
     console.log(import_chalk20.default.green(`
 Environments (${environments.length}):
 `));
-    for (const env of environments) printEnvironment(env, env.id === base_environment_id);
+    for (const env of environments) printEnvironment(env);
   });
 }
 async function environmentGetCommand(idOrName) {
@@ -32297,7 +32292,7 @@ async function replicaCreateCommand(name, options) {
   let replicaName = name;
   let message2 = options.message;
   const environmentInput = options.environment?.trim();
-  let selectedEnvironmentId = environmentInput === "global" ? envResponse.base_environment_id ?? void 0 : environmentInput && await resolveEnvironmentId(environmentInput);
+  let selectedEnvironmentId = environmentInput === "global" ? (await orgAuthenticatedFetch("/v1/environments/global")).environment.id : environmentInput && await resolveEnvironmentId(environmentInput);
   let codingAgent = parseReplicaAgent(options.agent);
   if (replicaName && /\s/.test(replicaName)) {
     throw new Error("Replica name cannot contain spaces.");
@@ -32328,7 +32323,7 @@ async function replicaCreateCommand(name, options) {
       choices: environments.map((env) => ({
         title: env.name,
         value: env.id,
-        description: env.id === envResponse.base_environment_id ? "base" : `${env.repository_ids?.length ?? 0} repositories`
+        description: `${env.repository_ids?.length ?? 0} repositories`
       }))
     });
     const answer = response2.environment;
@@ -33975,10 +33970,11 @@ var MEDIA_ACCESS_VALUES = ["organization", "public"];
 function publicMediaUrl(mediaId, token) {
   return `${MONOLITH_URL}/v1/media/public/${mediaId}/${token}`;
 }
-var MEDIA_DELIVERY_HINT = "Next: paste each ![\u2026](\u2026) or HTML page line above verbatim into your Replicas chat reply so it renders inline; View in Replicas links are secondary and never replace it. Slack, Linear, and GitLab also need a native upload of the file bytes; see the replicas-agent skill's references/MEDIA.md.";
-function formatMediaEmbed(fileName, mediaId, publicUrl) {
-  if (publicUrl) return `![${fileName}](${publicUrl})`;
-  return `Replicas chat embed: ![${fileName}](${MONOLITH_URL}/v1/media/${mediaId})`;
+var MEDIA_DELIVERY_HINT = "Next: paste each media line above (`![\u2026](\u2026)`, `[\u2026](\u2026)`, or `HTML page`) verbatim into your Replicas chat reply so it renders inline; View in Replicas links are secondary and never replace it. Slack, Linear, and GitLab also need a native upload of the file bytes; see the replicas-agent skill's references/MEDIA.md.";
+var markdownLabel = (name) => name.replace(/[[\]]/g, "");
+function formatMediaEmbed(name, media2, publicUrl) {
+  if (publicUrl) return `${media2.kind === MEDIA_KIND.IMAGE ? "!" : ""}[${markdownLabel(name)}](${publicUrl})`;
+  return `Replicas chat embed: ![${markdownLabel(name)}](${MONOLITH_URL}/v1/media/${media2.id})`;
 }
 async function shareMedia(mediaId) {
   const { token } = await agentFetch(`/v1/engine/media/${mediaId}/share`, {
@@ -34034,7 +34030,7 @@ async function uploadOne(filePath, displayName, kind, options) {
     method: "POST",
     body: form
   });
-  return { fileName, media: media2 };
+  return media2;
 }
 async function mediaUploadCommand(filePaths, options) {
   if (filePaths.length === 0) {
@@ -34072,7 +34068,7 @@ async function mediaUploadCommand(filePaths, options) {
   );
   const shareResults = await Promise.allSettled(
     results.map(
-      (result, i) => result.status === "fulfilled" && shared[i] ? shareMedia(result.value.media.id) : Promise.resolve(null)
+      (result, i) => result.status === "fulfilled" && shared[i] ? shareMedia(result.value.id) : Promise.resolve(null)
     )
   );
   const config3 = readAgentConfig();
@@ -34081,7 +34077,7 @@ async function mediaUploadCommand(filePaths, options) {
   for (let i = 0; i < results.length; i++) {
     const result = results[i];
     if (result.status === "fulfilled") {
-      const { fileName, media: media2 } = result.value;
+      const media2 = result.value;
       const shareResult = shareResults[i];
       const publicUrl = shareResult?.status === "fulfilled" ? shareResult.value ?? void 0 : void 0;
       if (shared[i]) {
@@ -34101,8 +34097,9 @@ async function mediaUploadCommand(filePaths, options) {
         name: names[i],
         media: media2,
         public_url: publicUrl,
-        embed: media2.kind === MEDIA_KIND.HTML ? `HTML page: [${fileName}](${MONOLITH_URL}/v1/media/${media2.id})` : !shared[i] || publicUrl ? formatMediaEmbed(fileName, media2.id, publicUrl) : void 0,
-        organization_url: options.access === "organization" && !shared[i] ? getOrganizationMediaUrl(media2.organization_id, media2.id) : void 0,
+        embed: media2.kind === MEDIA_KIND.HTML ? `HTML page: [${markdownLabel(names[i])}](${MONOLITH_URL}/v1/media/${media2.id})` : !shared[i] || publicUrl ? formatMediaEmbed(names[i], media2, publicUrl) : void 0,
+        // The HTML page link above only works inside Replicas chat, so HTML always gets a link that works elsewhere.
+        organization_url: media2.kind === MEDIA_KIND.HTML || options.access === "organization" && !shared[i] ? getOrganizationMediaUrl(media2.organization_id, media2.id) : void 0,
         dashboard_url: config3?.workspace_id ? getWorkspaceDashboardUrl(config3.workspace_id, { mode: "media", mediaId: media2.id }) : void 0
       });
     } else {
@@ -34117,6 +34114,10 @@ async function mediaUploadCommand(filePaths, options) {
         console.log(`Forge link (organization only): [View ${upload.name}](${upload.organization_url})`);
       }
       if (upload.dashboard_url) console.log(`View in Replicas: ${upload.dashboard_url}`);
+      if (upload.media.kind === MEDIA_KIND.VIDEO) {
+        const videoLink = upload.public_url ?? upload.dashboard_url;
+        console.log(`GitHub can't play videos. For a PR, make a GIF with \`replicas media gif ${upload.file}\`, upload it, and paste it linked to this video: [![${markdownLabel(upload.name)}](<GIF link>)](${videoLink})`);
+      }
     }
     if (uploads.some((upload) => upload.embed)) console.log(`
 ${MEDIA_DELIVERY_HINT}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-cli",
-  "version": "0.3.104",
+  "version": "0.3.106",
   "description": "CLI for managing Replicas workspaces - SSH into cloud dev environments with automatic port forwarding",
   "main": "dist/index.cjs",
   "bin": {