replicas-cli 0.2.182 → 0.2.183

package/dist/index.mjs

@@ -7316,7 +7316,7 @@ var require_dist = __commonJS({
 // src/index.ts
 import "dotenv/config";
 import { Command, InvalidArgumentError } from "commander";
-import chalk21 from "chalk";
+import chalk22 from "chalk";
 
 // src/commands/login.ts
 import http from "http";
@@ -7603,7 +7603,7 @@ function generateState() {
 }
 async function loginCommand() {
   const state = generateState();
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     let authTimeout;
     let hasHandledCallback = false;
     let lastRedirectUrl = null;
@@ -7740,7 +7740,7 @@ async function loginCommand() {
           setImmediate(() => {
             server.closeAllConnections?.();
             server.close();
-            resolve();
+            resolve2();
           });
         } catch (error2) {
           const errorUrl = `${WEB_APP_URL}/cli-login/error?message=${encodeURIComponent("Failed to verify authentication.")}`;
@@ -7843,13 +7843,13 @@ import chalk5 from "chalk";
 import { spawn } from "child_process";
 var SSH_OPTIONS = ["-o", "StrictHostKeyChecking=no", "-o", "UserKnownHostsFile=/dev/null"];
 async function connectSSH(token, host, proxyCommand) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const sshArgs = proxyCommand ? [...SSH_OPTIONS, "-o", `ProxyCommand=${proxyCommand}`, `${token}@${host}`] : [...SSH_OPTIONS, `${token}@${host}`];
     const ssh = spawn("ssh", sshArgs, {
       stdio: "inherit"
     });
     ssh.on("close", () => {
-      resolve();
+      resolve2();
     });
     ssh.on("error", reject);
   });
@@ -8105,8 +8105,200 @@ function extractPrNumber(url) {
   return parsed ? String(parsed.number) : null;
 }
 
+// ../shared/src/default-skills/replicas-agent/abilities/computer.ts
+var SECTION = `### Computer use (Linux desktop control)
+Drive the workspace's Linux desktop - open a browser, click, type, scroll, screenshot, record - and surface a live noVNC viewer to the user via the \`replicas computer\` CLI. Every Replicas workspace boots with Xvfb / openbox / x11vnc / noVNC pre-installed.
+
+**Reference:** \`references/COMPUTER-USE.md\`
+
+Use this when:
+- A task requires interacting with a website, web app, or desktop application that has no usable API
+- You want the user to watch the agent work - \`replicas computer start\` exposes a \`Desktop\` tab in the dashboard
+- You're testing UI changes in a browser before reporting them as done
+- You want to record a screen capture of a task as proof to share back`;
+var REFERENCE = `# Computer use (Linux desktop control)
+
+Every Replicas workspace boots with a full Linux desktop stack - Xvfb (1920\xD71080), openbox, tint2, x11vnc, noVNC, ffmpeg, and Google Chrome. You drive it through the \`replicas computer\` CLI.
+
+Use this for anything the user can't reasonably do via an API - clicking around web apps, filling forms, testing UI changes, dragging files between desktop apps, recording a walkthrough.
+
+## When to use it
+
+- **Prefer real APIs first.** If a task has a CLI or HTTP API (GitHub, Linear, Slack, Replicas itself), use that. Driving a UI is slower, flakier, and less auditable.
+- **Use it when there's no API**: testing a frontend you just changed, navigating a vendor portal, demonstrating a flow on video.
+- **Use it when the user wants to watch.** \`replicas computer start\` exposes a live \`Desktop\` tab in the dashboard - they can watch you work in real time.
+
+## Never use raw \`xdotool\` / \`scrot\` / \`ffmpeg\` directly
+
+The CLI is the canonical surface. Chat transcripts that show \`DISPLAY=:99 xdotool key Return\` are noisy and break when the underlying stack changes. Always call the CLI:
+
+\`\`\`bash
+# DO
+replicas computer key Return
+replicas computer screenshot /tmp/state.png
+
+# DON'T
+DISPLAY=:99 xdotool key Return
+scrot /tmp/state.png
+\`\`\`
+
+## Quickstart
+
+\`\`\`bash
+# 1) Make the desktop visible to the user (creates an authenticated noVNC
+#    preview on port 6080, prints the viewer URL, adds a "Desktop" tab to the
+#    dashboard).
+replicas computer start
+
+# 2) Launch a browser on the workspace display.
+replicas computer launch chrome
+
+# 3) Take a screenshot so you can see what's there.
+replicas computer screenshot /tmp/state.png
+# (Read the PNG yourself before deciding where to click.)
+
+# 4) Drive the UI.
+replicas computer key ctrl+l                       # focus address bar
+replicas computer type "https://news.ycombinator.com"
+replicas computer key Return
+replicas computer click 521 700                    # click coordinates from the screenshot
+replicas computer scroll down --amount 5
+
+# 5) (Optional) Record a screencap to share back.
+replicas computer record start /tmp/demo.mp4 --fps 60
+# ... do stuff ...
+replicas computer record stop
+replicas media upload /tmp/demo.mp4
+
+# 6) Tear down the live preview when done (services keep running for next time).
+replicas computer stop
+\`\`\`
+
+## Command reference
+
+### \`replicas computer start [--port N] [--display :N] [--size WxH]\`
+Ensures all desktop services are running and creates an authenticated noVNC preview. Prints the viewer URL (\`https://<port>-<hash>.tryreplicas.com/\`). The Replicas dashboard automatically shows a \`Desktop\` tab while this preview is live - point the user at it instead of pasting the URL.
+
+Idempotent - safe to call repeatedly. Use it as the first computer-use command in any session.
+
+### \`replicas computer stop [--port N]\`
+Tears down the noVNC preview (the \`Desktop\` tab disappears). The underlying Xvfb / openbox / x11vnc / browser keep running so the next \`start\` is instant.
+
+### \`replicas computer status\`
+Prints which desktop services are running and the active preview URL (if any). Useful for debugging when a tool call seems to be doing nothing.
+
+### \`replicas computer screenshot <path>\`
+Captures the current desktop to a PNG at the given path. Read the file (e.g. with your Read tool) to see what's on screen - coordinates from the screenshot drive subsequent \`click\` / \`move\` / \`drag\` calls.
+
+### \`replicas computer click <x> <y> [--button N] [--double] [--modifiers ctrl+shift]\`
+Move to (x, y) and click. Default is left-click (button 1); pass \`--button 3\` for right-click. \`--modifiers\` holds keys during the click (e.g. ctrl-click a link to open in a new tab).
+
+### \`replicas computer move <x> <y>\`
+Move the mouse without clicking. Useful for hovering tooltips.
+
+### \`replicas computer type <text> [--delay MS]\`
+Type a literal string into the focused field. Default per-character delay is 12ms (~80 wpm) - feels human and avoids breaking apps that debounce input. Bump \`--delay 30\` for stricter apps.
+
+For key combos (not literal text), use \`key\`. \`type "ctrl+l"\` will literally type the seven characters \`c t r l + l\`.
+
+### \`replicas computer key <combo>\`
+Press a single key or combo. Examples: \`Return\`, \`Escape\`, \`Tab\`, \`ctrl+l\`, \`ctrl+shift+t\`, \`alt+Left\`, \`Page_Down\`, \`Home\`. Syntax matches \`xdotool key\`.
+
+### \`replicas computer scroll <up|down|left|right> [--amount N] [--x X --y Y]\`
+Scroll the wheel. Pass \`--x\` / \`--y\` to hover before scrolling (otherwise scrolls wherever the cursor currently is). Default amount is 3 wheel ticks.
+
+### \`replicas computer drag <fromX> <fromY> <toX> <toY>\`
+Press left mouse at (fromX, fromY), drag to (toX, toY), release. For things like dragging a file onto an upload zone.
+
+### \`replicas computer launch <app> [args...]\`
+Spawns an app on the workspace display. Built-in aliases:
+- \`chrome\` - Google Chrome with a clean profile and sane flags
+- \`chromium\` - Chromium variant
+- \`firefox\` - Firefox
+- \`terminal\` - xfce4-terminal (modern, themed); \`xterm\` for the classic
+- \`notepad\` / \`editor\` - mousepad (lightweight GTK text editor)
+- \`files\` / \`filemanager\` - thunar (file manager)
+Anything else gets \`exec\`'d verbatim, so \`replicas computer launch xeyes\` works if xeyes is installed.
+
+### \`replicas computer record start <path> [--fps N]\`
+Starts an ffmpeg screen recorder. Output is a fragmented MP4 (still playable if the workspace dies mid-record). Default 60fps; drop to 30 if the workspace is CPU-constrained.
+
+Only one recording at a time. Re-running \`start\` while one is active fails - call \`stop\` first.
+
+### \`replicas computer record stop\`
+SIGINTs ffmpeg, waits for it to finalize the MP4, prints the output path. Upload it with \`replicas media upload <path>\` to share it.
+
+## Patterns
+
+### Action / screenshot loop
+You are blind between tool calls. After any action that changes the screen, take a screenshot before deciding the next coordinate:
+
+\`\`\`bash
+replicas computer click 521 700
+sleep 2  # let the page settle
+replicas computer screenshot /tmp/after-click.png
+# read /tmp/after-click.png, decide next click
+\`\`\`
+
+\`sleep\` is a regular shell sleep - there's no \`replicas computer wait\` command, but you can mix shell sleeps freely.
+
+### Typing into an address bar
+\`\`\`bash
+replicas computer key ctrl+l                    # focus address bar
+replicas computer type "https://example.com"
+replicas computer key Return
+sleep 3                                          # wait for page load
+replicas computer screenshot /tmp/loaded.png
+\`\`\`
+
+### Coordinates from screenshots
+The display is 1920\xD71080. Screenshot pixels map 1:1 to click coordinates - if your Read tool shows a button at pixel (520, 700), click \`replicas computer click 520 700\`. **No translation needed.** Modern image-reading models often imagine the screenshot is at a different resolution; trust the \`xdpyinfo\` value (\`replicas computer status\` shows the real size).
+
+### Letting the user watch
+Always start the desktop session with \`replicas computer start\` *before* doing anything visual, even if you don't need the URL yourself. The Desktop tab appears in their dashboard. They get to watch and intervene if needed.
+
+### Recording a deliverable
+For tasks the user wants proof of:
+\`\`\`bash
+replicas computer start                                 # makes it visible live too
+replicas computer record start /tmp/walkthrough.mp4
+# ... your work ...
+replicas computer record stop
+replicas media upload /tmp/walkthrough.mp4
+\`\`\`
+Then embed the printed \`![\u2026](\u2026)\` line in your chat reply. See \`MEDIA.md\`.
+
+### Cleaning up
+Call \`replicas computer stop\` when you're done with the visual demo so the live preview URL goes away. The services keep running so the next \`start\` is instant.
+
+## Failure modes
+
+- **"Desktop services script missing"**: workspace image is older than this skill. Tell the user - nothing you can do from the CLI side.
+- **\`xdotool ... failed: Can't open display\`**: Xvfb didn't come up. \`replicas computer status\` will show which service is dead. Re-running any CLI command auto-attempts to start it.
+- **Browser doesn't appear after \`launch chrome\`**: give it 1-2s, then screenshot. Chrome cold-start on the virtual display takes ~500ms but bigger pages take longer.
+- **Live preview shows static / black screen**: the browser may have crashed. \`replicas computer status\` should show no Chrome process - re-launch.
+
+## What gets baked in vs. lazy
+
+| Component | Where |
+|---|---|
+| \`xvfb\`, \`openbox\`, \`tint2\`, \`x11vnc\`, \`websockify\`, \`xdotool\`, \`scrot\`, \`ffmpeg\`, \`google-chrome\` | Baked into the workspace image |
+| Xvfb / openbox / tint2 / x11vnc / websockify processes | Started at workspace boot (\`replicas-start-desktop-services\`) |
+| noVNC preview URL (port 6080) | **Lazy** - created by \`replicas computer start\` |
+| Dashboard \`Desktop\` tab | Appears when the preview URL is live, disappears on \`stop\` |
+
+You can call any of the input tools (\`click\`, \`type\`, \`screenshot\`, etc.) without first calling \`start\` - they'll work since the daemons are running. \`start\` is only needed when you want the user to see the live stream.
+`;
+var COMPUTER_ABILITY = {
+  label: "Computer use",
+  description: "Drive the workspace's Linux desktop and stream a live noVNC viewer.",
+  bullet: "- Driving the workspace Linux desktop (open a browser, click, type, scroll, screenshot, record) and exposing a live noVNC viewer in the dashboard",
+  section: SECTION,
+  referenceFile: { name: "COMPUTER-USE.md", content: REFERENCE }
+};
+
 // ../shared/src/default-skills/replicas-agent/abilities/docker.ts
-var SECTION = `### Docker
+var SECTION2 = `### Docker
 Start and use the Docker daemon in Replicas workspaces. Docker is pre-installed but the daemon does not auto-start.
 
 **Reference:** \`references/DOCKER.md\`
@@ -8115,7 +8307,7 @@ Use this when:
 - You need to run \`docker\` or \`docker compose\` commands
 - You need to build or run Docker containers
 - Your task involves containerized services or Docker-based workflows`;
-var REFERENCE = `# Docker
+var REFERENCE2 = `# Docker
 
 Docker is pre-installed in Replicas workspaces, but the daemon does **not** auto-start. You must start it manually before running any \`docker\` or \`docker compose\` commands.
 
@@ -8144,12 +8336,12 @@ var DOCKER_ABILITY = {
   label: "Docker",
   description: "Start the daemon, build/run containers, drive `docker compose`.",
   bullet: "- Using Docker (starting the daemon, running containers, docker compose)",
-  section: SECTION,
-  referenceFile: { name: "DOCKER.md", content: REFERENCE }
+  section: SECTION2,
+  referenceFile: { name: "DOCKER.md", content: REFERENCE2 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/github.ts
-var SECTION2 = `### GitHub
+var SECTION3 = `### GitHub
 Use the pre-authenticated \`gh\` CLI for pull requests, issues, actions, and API calls.
 
 **Reference:** \`references/GITHUB.md\`
@@ -8159,7 +8351,7 @@ Use this when:
 - You need to interact with GitHub issues or actions
 - You need to use the GitHub API for advanced operations
 - You need to include images in PR descriptions`;
-var REFERENCE2 = `# GitHub Integration
+var REFERENCE3 = `# GitHub Integration
 
 This guide covers how to interact with GitHub from within your Replicas workspace.
 
@@ -8285,12 +8477,12 @@ var GITHUB_ABILITY = {
   label: "GitHub",
   description: "Pre-authenticated `gh` CLI for PRs, issues, releases, and GraphQL.",
   bullet: "- Interacting with GitHub (creating PRs, managing issues, using the API, etc.)",
-  section: SECTION2,
-  referenceFile: { name: "GITHUB.md", content: REFERENCE2 }
+  section: SECTION3,
+  referenceFile: { name: "GITHUB.md", content: REFERENCE3 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/google.ts
-var SECTION3 = `### Google Workspace (Docs, Sheets, Forms, Drive)
+var SECTION4 = `### Google Workspace (Docs, Sheets, Forms, Drive)
 Create and edit Google Docs, Sheets, and Forms via the Replicas gateway. Files are owned by Replicas \u2014 the integration cannot access pre-existing Google content created outside of it.
 
 **Reference:** \`references/GOOGLE.md\`
@@ -8299,7 +8491,7 @@ Use this when:
 - You need to create or edit a Google Doc, Sheet, or Form
 - You need to share, rename, move, or delete a Replicas-created Google file
 - You need to read responses from a Replicas-created Google Form`;
-var REFERENCE3 = `# Google Workspace (Docs, Sheets, Forms, Drive)
+var REFERENCE4 = `# Google Workspace (Docs, Sheets, Forms, Drive)
 
 This guide covers how to create and edit Google Docs, Sheets, and Forms \u2014 plus do basic Drive file operations \u2014 from inside a Replicas workspace, using the monolith as a gateway to Google's APIs.
 
@@ -8560,12 +8752,12 @@ var GOOGLE_ABILITY = {
   label: "Google Workspace",
   description: "Create / edit Docs, Sheets, Forms, and Drive files via the Replicas gateway.",
   bullet: "- Interacting with Google Workspace (creating and editing Docs, Sheets, and Forms, sharing files, reading form responses, etc.)",
-  section: SECTION3,
-  referenceFile: { name: "GOOGLE.md", content: REFERENCE3 }
+  section: SECTION4,
+  referenceFile: { name: "GOOGLE.md", content: REFERENCE4 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/linear.ts
-var SECTION4 = `### Linear
+var SECTION5 = `### Linear
 Fetch issues, update state, add comments, and search via the Linear GraphQL API.
 
 **Reference:** \`references/LINEAR.md\`
@@ -8574,7 +8766,7 @@ Use this when:
 - You encounter a Linear issue link and need to understand the task
 - You need to update an issue's state (e.g. mark as done)
 - You need to comment on or search for Linear issues`;
-var REFERENCE4 = `# Linear Integration
+var REFERENCE5 = `# Linear Integration
 
 This guide covers how to interact with Linear from within your Replicas workspace.
 
@@ -8649,12 +8841,12 @@ var LINEAR_ABILITY = {
   label: "Linear",
   description: "Fetch issues, post comments, update states via the Linear GraphQL API.",
   bullet: "- Interacting with Linear (fetching issues, updating state, commenting, etc.)",
-  section: SECTION4,
-  referenceFile: { name: "LINEAR.md", content: REFERENCE4 }
+  section: SECTION5,
+  referenceFile: { name: "LINEAR.md", content: REFERENCE5 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/media.ts
-var SECTION5 = `### Media
+var SECTION6 = `### Media
 Share screenshots, screen recordings, generated diagrams, and audio clips inline in the Replicas chat (and as references in external messages).
 
 **Reference:** \`references/MEDIA.md\`
@@ -8663,7 +8855,7 @@ Use this when:
 - You produce a screenshot, recording, generated image, or audio clip the user should see
 - You record video output (browser automation, screen capture) \u2014 including the recommended aspect ratio and FPS
 - You need to embed media in a Slack/Linear/GitHub message AND keep a referenceable copy in the Replicas dashboard`;
-var REFERENCE5 = `# Media (Screenshots, Recordings, Audio)
+var REFERENCE6 = `# Media (Screenshots, Recordings, Audio)
 
 This guide covers how to share screenshots, screen recordings, generated diagrams, and audio clips with the user inline in the Replicas chat.
 
@@ -8777,12 +8969,12 @@ var MEDIA_ABILITY = {
   label: "Media",
   description: "Share screenshots, recordings, generated images, and audio clips.",
   bullet: "- Sharing media (screenshots, screen recordings, generated diagrams, audio clips) \u2014 including in your Replicas chat reply and to external platforms",
-  section: SECTION5,
-  referenceFile: { name: "MEDIA.md", content: REFERENCE5 }
+  section: SECTION6,
+  referenceFile: { name: "MEDIA.md", content: REFERENCE6 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/previews.ts
-var SECTION6 = `### Previews
+var SECTION7 = `### Previews
 Expose locally running services (web apps, APIs, databases) as public preview URLs so humans can interact with them directly.
 
 **Reference:** \`references/PREVIEWS.md\`
@@ -8791,7 +8983,7 @@ Use this when:
 - You need to start a service that a human should view or interact with
 - The task involves UI work that benefits from human review
 - You are verifying frontend/backend integrations visually`;
-var REFERENCE6 = `# Preview URLs
+var REFERENCE7 = `# Preview URLs
 
 When you run services on ports \u2014 such as a web app, API server, or database \u2014 humans may want to interact with them directly. You can expose your locally running services as public preview URLs.
 
@@ -8873,12 +9065,12 @@ var PREVIEWS_ABILITY = {
   label: "Previews",
   description: "Expose locally running services on public preview URLs for humans.",
   bullet: "- Creating preview URLs for locally running services",
-  section: SECTION6,
-  referenceFile: { name: "PREVIEWS.md", content: REFERENCE6 }
+  section: SECTION7,
+  referenceFile: { name: "PREVIEWS.md", content: REFERENCE7 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/replicas.ts
-var SECTION7 = `### Replicas (in-workspace CLI)
+var SECTION8 = `### Replicas (in-workspace CLI)
 Take action *with* Replicas itself \u2014 manage automations, environments (variables, files), repos, and \`replicas.json\` config \u2014 using the pre-installed, pre-authenticated \`replicas\` CLI.
 
 **Reference:** \`references/REPLICAS.md\`
@@ -8888,7 +9080,7 @@ Use this when:
 - The user asks you to manage environments, environment variables, or environment files
 - The user asks "what envs / repos / automations do I have?"
 - The user asks you to scaffold a \`replicas.json\` / \`replicas.yaml\` in a repo`;
-var REFERENCE7 = `# Replicas (in-workspace CLI)
+var REFERENCE8 = `# Replicas (in-workspace CLI)
 
 This guide covers how to take action *with* Replicas itself from inside a Replicas workspace \u2014 managing automations, environments (and their variables/files), repos, previews, and the user's \`replicas.json\` config \u2014 using the pre-installed \`replicas\` CLI.
 
@@ -9082,13 +9274,13 @@ var REPLICAS_ABILITY = {
   description: "Teach the agent about Replicas itself \u2014 automations, environments, the in-workspace CLI.",
   // No bullet — help_instructions covers the `replicas` CLI surface in detail.
   bullet: "",
-  section: SECTION7,
-  referenceFile: { name: "REPLICAS.md", content: REFERENCE7 },
+  section: SECTION8,
+  referenceFile: { name: "REPLICAS.md", content: REFERENCE8 },
   locked: true
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/slack.ts
-var SECTION8 = `### Slack
+var SECTION9 = `### Slack
 Send messages, read threads, search conversations, and upload files via the Slack Web API.
 
 **Reference:** \`references/SLACK.md\`
@@ -9098,7 +9290,7 @@ Use this when:
 - You need to read or fetch a Slack conversation
 - You encounter a Slack message link and need to retrieve its content
 - The task asks you to notify, update, or communicate via Slack`;
-var REFERENCE8 = `# Slack Integration
+var REFERENCE9 = `# Slack Integration
 
 This guide covers how to interact with Slack from within your Replicas workspace.
 
@@ -9171,13 +9363,14 @@ var SLACK_ABILITY = {
   label: "Slack",
   description: "Send messages, read threads, search conversations, upload files.",
   bullet: "- Interacting with Slack (sending messages, reading threads, etc.)",
-  section: SECTION8,
-  referenceFile: { name: "SLACK.md", content: REFERENCE8 }
+  section: SECTION9,
+  referenceFile: { name: "SLACK.md", content: REFERENCE9 }
 };
 
 // ../shared/src/default-skills/replicas-agent/registry.ts
 var REPLICAS_AGENT_ABILITY_REGISTRY = {
   replicas: REPLICAS_ABILITY,
+  computer: COMPUTER_ABILITY,
   docker: DOCKER_ABILITY,
   github: GITHUB_ABILITY,
   google: GOOGLE_ABILITY,
@@ -9222,6 +9415,14 @@ var HOOK_EXEC_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
 // ../shared/src/replicas-config.ts
 var REPLICAS_CONFIG_FILENAMES = ["replicas.json", "replicas.yaml", "replicas.yml"];
 
+// ../shared/src/engine/environment.ts
+var DESKTOP_NOVNC_PORT = 6080;
+function getDesktopViewerUrl(publicUrl) {
+  return `${publicUrl.replace(/\/$/, "")}/`;
+}
+var DESKTOP_VIEWER_WIDTH = 1920;
+var DESKTOP_VIEWER_HEIGHT = 1080;
+
 // ../shared/src/engine/types.ts
 var DEFAULT_CHAT_TITLES = {
   claude: "Claude Code",
@@ -10746,7 +10947,7 @@ async function exchangeCodeForTokens(code, codeVerifier) {
   };
 }
 function startCallbackServer(expectedState, codeVerifier) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const server = http2.createServer(async (req, res) => {
       try {
         if (!req.url) {
@@ -10789,7 +10990,7 @@ function startCallbackServer(expectedState, codeVerifier) {
             res.writeHead(302, { "Location": `${WEB_APP_URL2}/codex/oauth/success` });
             res.end();
             server.close();
-            resolve(tokens);
+            resolve2(tokens);
           } catch (tokenError) {
             const errorMessage = encodeURIComponent(tokenError instanceof Error ? tokenError.message : "Unknown error");
             res.writeHead(302, { "Location": `${WEB_APP_URL2}/codex/oauth/error?message=${errorMessage}` });
@@ -10823,7 +11024,7 @@ async function runCodexOAuthFlow() {
   const state = generateState2();
   const authUrl = buildAuthorizationUrl(pkce.codeChallenge, state);
   const tokensPromise = startCallbackServer(state, pkce.codeVerifier);
-  await new Promise((resolve) => setTimeout(resolve, 500));
+  await new Promise((resolve2) => setTimeout(resolve2, 500));
   console.log("If the browser does not open automatically, visit:");
   console.log(authUrl);
   console.log();
@@ -10912,10 +11113,10 @@ async function promptForAuthorizationCode(instruction) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(instruction, (answer) => {
       rl.close();
-      resolve(answer.trim());
+      resolve2(answer.trim());
     });
   });
 }
@@ -12274,20 +12475,31 @@ async function engineFetch(path6, options) {
 }
 
 // src/commands/preview.ts
-function parsePort(port) {
+function parsePreviewPort(port) {
   const portNum = parseInt(port, 10);
   if (isNaN(portNum) || portNum < 1 || portNum > 65535) {
     throw new Error("Port must be a number between 1 and 65535");
   }
   return portNum;
 }
+function createAgentPreview(port, authenticated) {
+  return agentFetch("/v1/previews", {
+    method: "POST",
+    body: { port, authenticated }
+  });
+}
+function listAgentPreviews() {
+  return engineFetch("/previews");
+}
+function deleteAgentPreview(port) {
+  return agentFetch(`/v1/previews/${port}`, {
+    method: "DELETE"
+  });
+}
 async function previewCreateCommand(port, options) {
-  const portNum = parsePort(port);
+  const portNum = parsePreviewPort(port);
   if (isAgentMode()) {
-    const result = await agentFetch("/v1/previews", {
-      method: "POST",
-      body: { port: portNum, authenticated: options.authenticated ?? false }
-    });
+    const result = await createAgentPreview(portNum, options.authenticated ?? false);
     console.log(result.preview.publicUrl);
   } else {
     throw new Error("In human mode, use: replicas preview add <workspaceId> --port <port>");
@@ -12295,7 +12507,7 @@ async function previewCreateCommand(port, options) {
 }
 async function previewListCommand(workspaceId) {
   if (isAgentMode()) {
-    const result = await engineFetch("/previews");
+    const result = await listAgentPreviews();
     if (result.previews.length === 0) {
       console.log("No active previews");
       return;
@@ -12320,7 +12532,7 @@ async function previewListCommand(workspaceId) {
   }
 }
 async function previewAddCommand(workspaceId, options) {
-  const portNum = parsePort(options.port);
+  const portNum = parsePreviewPort(options.port);
   const result = await orgAuthenticatedFetch(
     `/v1/workspaces/${workspaceId}/previews`,
     {
@@ -12331,14 +12543,12 @@ async function previewAddCommand(workspaceId, options) {
   console.log(chalk18.green(`Preview created: ${result.preview.publicUrl}`));
 }
 async function previewDeleteCommand(port) {
-  const portNum = parsePort(port);
-  await agentFetch(`/v1/previews/${portNum}`, {
-    method: "DELETE"
-  });
+  const portNum = parsePreviewPort(port);
+  await deleteAgentPreview(portNum);
   console.log(`Preview deleted on port ${portNum}`);
 }
 async function previewRemoveCommand(workspaceId, options) {
-  const portNum = parsePort(options.port);
+  const portNum = parsePreviewPort(options.port);
   await orgAuthenticatedFetch(
     `/v1/workspaces/${workspaceId}/previews/${portNum}`,
     { method: "DELETE" }
@@ -12444,8 +12654,289 @@ async function mediaListCommand(options) {
   }
 }
 
-// src/commands/interactive.ts
+// src/commands/computer.ts
+import { spawn as spawn3, spawnSync } from "child_process";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { dirname, isAbsolute, resolve } from "path";
 import chalk19 from "chalk";
+var STATE_DIR = process.env.REPLICAS_DESKTOP_STATE_DIR || "/tmp/replicas-computer";
+var DEFAULT_DISPLAY = process.env.REPLICAS_DESKTOP_DISPLAY || ":99";
+var NOVNC_PORT = process.env.REPLICAS_DESKTOP_NOVNC_PORT ? parseInt(process.env.REPLICAS_DESKTOP_NOVNC_PORT, 10) : DESKTOP_NOVNC_PORT;
+var SERVICES_SCRIPT = "/usr/local/bin/replicas-start-desktop-services";
+function fail(msg) {
+  throw new Error(msg);
+}
+function ensureServicesRunning() {
+  if (!existsSync(SERVICES_SCRIPT)) {
+    fail(
+      `Desktop services script missing at ${SERVICES_SCRIPT}. The workspace image is out of date \u2014 Xvfb / openbox / x11vnc / websockify must be installed and \`replicas-start-desktop-services\` baked in.`
+    );
+  }
+  const r = spawnSync("bash", [SERVICES_SCRIPT], { stdio: "pipe" });
+  if (r.status !== 0) {
+    fail(`Failed to start desktop services: ${r.stderr?.toString() || "unknown error"}`);
+  }
+}
+function withDisplay(env = process.env) {
+  return { ...env, DISPLAY: DEFAULT_DISPLAY };
+}
+function runDisplayCmd(bin, args) {
+  ensureServicesRunning();
+  const r = spawnSync(bin, args, { env: withDisplay(), stdio: "pipe" });
+  if (r.status !== 0) {
+    fail(`${bin} ${args.join(" ")} failed: ${r.stderr?.toString().trim() || `exit ${r.status}`}`);
+  }
+  return r.stdout?.toString() ?? "";
+}
+function parseCoord(value, label) {
+  const n = Number.parseInt(value, 10);
+  if (!Number.isFinite(n)) fail(`${label} must be an integer (got "${value}")`);
+  return n;
+}
+function resolvePath(p) {
+  return isAbsolute(p) ? p : resolve(process.cwd(), p);
+}
+async function computerStartCommand(options) {
+  if (options.display) process.env.REPLICAS_DESKTOP_DISPLAY = options.display;
+  if (options.size) {
+    const m = /^(\d+)x(\d+)$/.exec(options.size);
+    if (!m) fail(`--size must be WIDTHxHEIGHT (got "${options.size}")`);
+    process.env.REPLICAS_DESKTOP_WIDTH = m[1];
+    process.env.REPLICAS_DESKTOP_HEIGHT = m[2];
+  }
+  ensureServicesRunning();
+  const port = options.port ? parsePreviewPort(options.port) : NOVNC_PORT;
+  let publicUrl;
+  try {
+    const result = await createAgentPreview(port, true);
+    publicUrl = result.preview.publicUrl;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (!/409/.test(msg)) throw err;
+    const list = await listAgentPreviews();
+    const existing = list.previews.find((p) => p.port === port);
+    if (!existing) throw err;
+    publicUrl = existing.publicUrl;
+  }
+  const viewerUrl = getDesktopViewerUrl(publicUrl);
+  mkdirSync(STATE_DIR, { recursive: true });
+  writeFileSync(
+    `${STATE_DIR}/preview.json`,
+    JSON.stringify({ port, publicUrl, viewerUrl }, null, 2)
+  );
+  console.log(viewerUrl);
+  console.error(chalk19.dim(`Desktop preview ready (port ${port}, authenticated).`));
+  console.error(chalk19.dim(`The Replicas dashboard will show a "Desktop" tab while this preview is live.`));
+}
+async function computerStopCommand(options) {
+  const port = options.port ? parsePreviewPort(options.port) : NOVNC_PORT;
+  await deleteAgentPreview(port);
+  rmSync(`${STATE_DIR}/preview.json`, { force: true });
+  console.log(`Desktop preview stopped on port ${port}`);
+}
+async function computerStatusCommand() {
+  const procs = ["Xvfb", "openbox", "tint2", "x11vnc", "websockify"];
+  for (const p of procs) {
+    const r = spawnSync("pgrep", ["-af", p], { stdio: "pipe" });
+    const running = r.status === 0 && !!r.stdout?.toString().trim();
+    console.log(`  ${running ? chalk19.green("\u25CF") : chalk19.red("\u25CB")} ${p}`);
+  }
+  const previewFile = `${STATE_DIR}/preview.json`;
+  if (existsSync(previewFile)) {
+    try {
+      const meta = JSON.parse(readFileSync(previewFile, "utf8"));
+      console.log(`  ${chalk19.cyan("preview")}: ${meta.viewerUrl}`);
+    } catch {
+    }
+  } else {
+    console.log(`  ${chalk19.dim("preview: not started (run `replicas computer start`)")}`);
+  }
+}
+async function computerScreenshotCommand(path6) {
+  const target = resolvePath(path6);
+  mkdirSync(dirname(target), { recursive: true });
+  runDisplayCmd("scrot", ["-o", target]);
+  console.log(target);
+}
+async function computerClickCommand(xStr, yStr, options) {
+  const x = parseCoord(xStr, "x");
+  const y = parseCoord(yStr, "y");
+  const button = options.button ?? "1";
+  const args = ["mousemove", "--sync", String(x), String(y)];
+  if (options.modifiers) {
+    for (const mod of options.modifiers.split("+")) {
+      args.push("keydown", mod);
+    }
+  }
+  if (options.double) {
+    args.push("click", "--repeat", "2", "--delay", "50", button);
+  } else {
+    args.push("click", button);
+  }
+  if (options.modifiers) {
+    for (const mod of options.modifiers.split("+").reverse()) {
+      args.push("keyup", mod);
+    }
+  }
+  runDisplayCmd("xdotool", args);
+  console.log(`clicked ${button === "1" ? "left" : button === "2" ? "middle" : button === "3" ? "right" : `button ${button}`} at (${x},${y})${options.double ? " x2" : ""}`);
+}
+async function computerMoveCommand(xStr, yStr) {
+  const x = parseCoord(xStr, "x");
+  const y = parseCoord(yStr, "y");
+  runDisplayCmd("xdotool", ["mousemove", "--sync", String(x), String(y)]);
+  console.log(`moved to (${x},${y})`);
+}
+async function computerTypeCommand(text, options) {
+  const delay = options.delay ? parseCoord(options.delay, "--delay") : 12;
+  runDisplayCmd("xdotool", ["type", "--delay", String(delay), "--", text]);
+  console.log(`typed ${text.length} char${text.length === 1 ? "" : "s"}`);
+}
+async function computerKeyCommand(combo) {
+  runDisplayCmd("xdotool", ["key", "--", combo]);
+  console.log(`pressed ${combo}`);
+}
+async function computerScrollCommand(direction, options) {
+  const dir = direction.toLowerCase();
+  const buttonMap = { up: "4", down: "5", left: "6", right: "7" };
+  const button = buttonMap[dir];
+  if (!button) fail(`direction must be one of up|down|left|right (got "${direction}")`);
+  const amount = options.amount ? parseCoord(options.amount, "--amount") : 3;
+  const args = [];
+  if (options.x && options.y) {
+    args.push("mousemove", "--sync", options.x, options.y);
+  }
+  args.push("click", "--repeat", String(amount), "--delay", "30", button);
+  runDisplayCmd("xdotool", args);
+  console.log(`scrolled ${dir} x${amount}`);
+}
+async function computerDragCommand(fx, fy, tx, ty) {
+  const fromX = parseCoord(fx, "fromX");
+  const fromY = parseCoord(fy, "fromY");
+  const toX = parseCoord(tx, "toX");
+  const toY = parseCoord(ty, "toY");
+  runDisplayCmd("xdotool", [
+    "mousemove",
+    "--sync",
+    String(fromX),
+    String(fromY),
+    "mousedown",
+    "1",
+    "mousemove",
+    "--sync",
+    String(toX),
+    String(toY),
+    "mouseup",
+    "1"
+  ]);
+  console.log(`dragged (${fromX},${fromY}) -> (${toX},${toY})`);
+}
+var APP_ALIASES = {
+  chrome: ["google-chrome", "--no-first-run", "--no-default-browser-check", "--start-maximized", "--user-data-dir=/tmp/replicas-computer/chrome-profile"],
+  chromium: ["chromium", "--no-first-run", "--no-default-browser-check"],
+  firefox: ["firefox"],
+  terminal: ["xfce4-terminal"],
+  xterm: ["xterm"],
+  notepad: ["mousepad"],
+  editor: ["mousepad"],
+  files: ["thunar"],
+  filemanager: ["thunar"]
+};
+async function computerLaunchCommand(app, args) {
+  ensureServicesRunning();
+  const baseArgs = APP_ALIASES[app] ?? [app];
+  const bin = baseArgs[0];
+  const fullArgs = [...baseArgs.slice(1), ...args];
+  const child = spawn3(bin, fullArgs, {
+    env: withDisplay(),
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  console.log(`launched ${bin} (pid ${child.pid})`);
+}
+var RECORD_PID_FILE = `${STATE_DIR}/ffmpeg.pid`;
+async function computerRecordStartCommand(path6, options) {
+  ensureServicesRunning();
+  if (existsSync(RECORD_PID_FILE)) {
+    const pid = parseInt(readFileSync(RECORD_PID_FILE, "utf8").trim(), 10);
+    if (Number.isFinite(pid)) {
+      let alive = false;
+      try {
+        process.kill(pid, 0);
+        alive = true;
+      } catch {
+      }
+      if (alive) fail(`recording already in progress (pid ${pid}). run \`replicas computer record stop\` first.`);
+    }
+  }
+  const target = resolvePath(path6);
+  mkdirSync(dirname(target), { recursive: true });
+  const fps = options.fps ? parseCoord(options.fps, "--fps") : 60;
+  const width = process.env.REPLICAS_DESKTOP_WIDTH || String(DESKTOP_VIEWER_WIDTH);
+  const height = process.env.REPLICAS_DESKTOP_HEIGHT || String(DESKTOP_VIEWER_HEIGHT);
+  const child = spawn3("ffmpeg", [
+    "-y",
+    "-hide_banner",
+    "-loglevel",
+    "warning",
+    "-f",
+    "x11grab",
+    "-framerate",
+    String(fps),
+    "-video_size",
+    `${width}x${height}`,
+    "-draw_mouse",
+    "1",
+    "-i",
+    DEFAULT_DISPLAY,
+    "-c:v",
+    "libx264",
+    "-preset",
+    "ultrafast",
+    "-tune",
+    "zerolatency",
+    "-crf",
+    "23",
+    "-pix_fmt",
+    "yuv420p",
+    "-movflags",
+    "+faststart+frag_keyframe+empty_moov",
+    target
+  ], { detached: true, stdio: "ignore" });
+  child.unref();
+  if (!child.pid) fail("failed to launch ffmpeg");
+  mkdirSync(STATE_DIR, { recursive: true });
+  writeFileSync(RECORD_PID_FILE, String(child.pid));
+  writeFileSync(`${STATE_DIR}/recording-path.txt`, target);
+  console.log(target);
+}
+async function computerRecordStopCommand() {
+  if (!existsSync(RECORD_PID_FILE)) fail("no recording in progress");
+  const pid = parseInt(readFileSync(RECORD_PID_FILE, "utf8").trim(), 10);
+  if (!Number.isFinite(pid)) fail("invalid recording pidfile");
+  try {
+    process.kill(pid, "SIGINT");
+  } catch {
+  }
+  for (let i = 0; i < 30; i++) {
+    try {
+      process.kill(pid, 0);
+    } catch {
+      break;
+    }
+    await new Promise((r) => setTimeout(r, 200));
+  }
+  rmSync(RECORD_PID_FILE, { force: true });
+  const pathFile = `${STATE_DIR}/recording-path.txt`;
+  if (existsSync(pathFile)) {
+    console.log(readFileSync(pathFile, "utf8").trim());
+    rmSync(pathFile, { force: true });
+  }
+}
+
+// src/commands/interactive.ts
+import chalk20 from "chalk";
 
 // src/interactive/index.tsx
 import { createCliRenderer } from "@opentui/core";
@@ -12898,7 +13389,7 @@ function useWorkspaceEvents(workspaceId, enabled = true) {
       while (!cancelled) {
         await connect();
         if (cancelled) break;
-        await new Promise((resolve) => setTimeout(resolve, 1e3));
+        await new Promise((resolve2) => setTimeout(resolve2, 1e3));
       }
     };
     run().catch(() => setConnected(false));
@@ -15565,13 +16056,13 @@ async function interactiveCommand() {
       'No organization selected. Please run "replicas org switch" to select an organization.'
     );
   }
-  console.log(chalk19.gray("Starting interactive mode..."));
+  console.log(chalk20.gray("Starting interactive mode..."));
   await launchInteractive();
 }
 
 // src/commands/environment.ts
 import fs5 from "fs";
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 import prompts5 from "prompts";
 var UUID_RE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
 function maskValue(value) {
@@ -15584,38 +16075,38 @@ async function resolveEnvironmentId(input) {
   const response = await orgAuthenticatedFetch("/v1/environments");
   const env = response.environments.find((e) => e.name === input);
   if (!env) {
-    console.log(chalk20.red(`Environment not found: ${input}`));
+    console.log(chalk21.red(`Environment not found: ${input}`));
     const available = response.environments.map((e) => e.name).join(", ");
-    console.log(chalk20.gray(`Available: ${available || "(none)"}`));
+    console.log(chalk21.gray(`Available: ${available || "(none)"}`));
     process.exit(1);
   }
   return env.id;
 }
 function printEnvironment(env) {
-  console.log(chalk20.white(`  ${env.name}${env.is_global ? chalk20.gray(" (global)") : ""}`));
-  console.log(chalk20.gray(`    ID: ${env.id}`));
+  console.log(chalk21.white(`  ${env.name}${env.is_global ? chalk21.gray(" (global)") : ""}`));
+  console.log(chalk21.gray(`    ID: ${env.id}`));
   if (env.description) {
-    console.log(chalk20.gray(`    Description: ${env.description}`));
+    console.log(chalk21.gray(`    Description: ${env.description}`));
   }
   if (env.repository_id) {
-    console.log(chalk20.gray(`    Repository: ${env.repository_id}`));
+    console.log(chalk21.gray(`    Repository: ${env.repository_id}`));
   } else if (env.repository_set_id) {
-    console.log(chalk20.gray(`    Repository Set: ${env.repository_set_id}`));
+    console.log(chalk21.gray(`    Repository Set: ${env.repository_set_id}`));
   }
   if (env.variable_count !== void 0) {
-    console.log(chalk20.gray(`    Variables: ${env.variable_count}, Files: ${env.file_count ?? 0}, Skills: ${env.skill_count ?? 0}, MCPs: ${env.mcp_count ?? 0}`));
+    console.log(chalk21.gray(`    Variables: ${env.variable_count}, Files: ${env.file_count ?? 0}, Skills: ${env.skill_count ?? 0}, MCPs: ${env.mcp_count ?? 0}`));
   }
-  console.log(chalk20.gray(`    Updated: ${formatDate2(env.updated_at)}`));
+  console.log(chalk21.gray(`    Updated: ${formatDate2(env.updated_at)}`));
   console.log();
 }
 async function environmentListCommand() {
   ensureOrgApiAuthenticated();
   const response = await orgAuthenticatedFetch("/v1/environments");
   if (response.environments.length === 0) {
-    console.log(chalk20.yellow("\nNo environments found.\n"));
+    console.log(chalk21.yellow("\nNo environments found.\n"));
     return;
   }
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Environments (${response.environments.length}):
 `));
   for (const env of response.environments) {
@@ -15626,7 +16117,7 @@ async function environmentGetCommand(idOrName) {
   ensureOrgApiAuthenticated();
   const id = await resolveEnvironmentId(idOrName);
   const response = await orgAuthenticatedFetch(`/v1/environments/${id}`);
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Environment: ${response.environment.name}
 `));
   printEnvironment(response.environment);
@@ -15642,7 +16133,7 @@ async function environmentCreateCommand(name, options) {
       validate: (v) => v.trim() ? true : "Name is required"
     });
     if (!r.name) {
-      console.log(chalk20.yellow("\nCancelled."));
+      console.log(chalk21.yellow("\nCancelled."));
       return;
     }
     envName = r.name;
@@ -15655,8 +16146,8 @@ async function environmentCreateCommand(name, options) {
       const repos2 = await orgAuthenticatedFetch("/v1/repositories");
       const repo = repos2.repositories.find((r) => r.name === options.repository);
       if (!repo) {
-        console.log(chalk20.red(`Repository not found: ${options.repository}`));
-        console.log(chalk20.gray(`Available: ${repos2.repositories.map((r) => r.name).join(", ")}`));
+        console.log(chalk21.red(`Repository not found: ${options.repository}`));
+        console.log(chalk21.gray(`Available: ${repos2.repositories.map((r) => r.name).join(", ")}`));
         process.exit(1);
       }
       repositoryId = repo.id;
@@ -15686,9 +16177,9 @@ async function environmentCreateCommand(name, options) {
     method: "POST",
     body
   });
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Created environment: ${response.environment.name}`));
-  console.log(chalk20.gray(`  ID: ${response.environment.id}
+  console.log(chalk21.gray(`  ID: ${response.environment.id}
 `));
 }
 async function environmentEditCommand(idOrName, options) {
@@ -15707,21 +16198,21 @@ async function environmentEditCommand(idOrName, options) {
       const repos2 = await orgAuthenticatedFetch("/v1/repositories");
       const repo = repos2.repositories.find((r) => r.name === options.repository);
       if (!repo) {
-        console.log(chalk20.red(`Repository not found: ${options.repository}`));
+        console.log(chalk21.red(`Repository not found: ${options.repository}`));
         process.exit(1);
       }
       body.repository_id = repo.id;
     }
   }
   if (Object.keys(body).length === 0) {
-    console.log(chalk20.yellow("\nNo changes specified. Pass --name, --description, --repository, or --system-prompt."));
+    console.log(chalk21.yellow("\nNo changes specified. Pass --name, --description, --repository, or --system-prompt."));
     return;
   }
   const response = await orgAuthenticatedFetch(`/v1/environments/${id}`, {
     method: "PATCH",
     body
   });
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Updated environment: ${response.environment.name}
 `));
 }
@@ -15736,20 +16227,20 @@ async function environmentDeleteCommand(idOrName, options) {
       initial: false
     });
     if (!r.confirm) {
-      console.log(chalk20.yellow("\nCancelled."));
+      console.log(chalk21.yellow("\nCancelled."));
       return;
     }
   }
   await orgAuthenticatedFetch(`/v1/environments/${id}`, { method: "DELETE" });
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Deleted environment ${idOrName}.
 `));
 }
 function printVariable(v, reveal) {
-  console.log(chalk20.white(`  ${v.key}`));
-  console.log(chalk20.gray(`    ID: ${v.id}`));
-  console.log(chalk20.gray(`    Value: ${reveal ? v.value : maskValue(v.value)}`));
-  console.log(chalk20.gray(`    Updated: ${formatDate2(v.updated_at)}`));
+  console.log(chalk21.white(`  ${v.key}`));
+  console.log(chalk21.gray(`    ID: ${v.id}`));
+  console.log(chalk21.gray(`    Value: ${reveal ? v.value : maskValue(v.value)}`));
+  console.log(chalk21.gray(`    Updated: ${formatDate2(v.updated_at)}`));
   console.log();
 }
 async function envVarsListCommand(envIdOrName, options) {
@@ -15759,14 +16250,14 @@ async function envVarsListCommand(envIdOrName, options) {
     `/v1/environments/${id}/variables`
   );
   if (response.environment_variables.length === 0) {
-    console.log(chalk20.yellow("\nNo variables.\n"));
+    console.log(chalk21.yellow("\nNo variables.\n"));
     return;
   }
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Variables (${response.environment_variables.length}):
 `));
   if (!options.reveal) {
-    console.log(chalk20.gray("  Values are masked. Pass --reveal to show full values.\n"));
+    console.log(chalk21.gray("  Values are masked. Pass --reveal to show full values.\n"));
   }
   for (const v of response.environment_variables) printVariable(v, !!options.reveal);
 }
@@ -15783,7 +16274,7 @@ async function envVarsSetCommand(envIdOrName, key, value) {
       `/v1/environments/${id}/variables/${match.id}`,
       { method: "PATCH", body: body2 }
     );
-    console.log(chalk20.green(`
+    console.log(chalk21.green(`
 Updated variable ${response2.environment_variable.key}.
 `));
     return;
@@ -15797,7 +16288,7 @@ Updated variable ${response2.environment_variable.key}.
     `/v1/environments/${id}/variables`,
     { method: "POST", body }
   );
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Created variable ${response.environment_variable.key}.
 `));
 }
@@ -15811,7 +16302,7 @@ async function envVarsDeleteCommand(envIdOrName, keyOrId, options) {
     );
     const match = existing.environment_variables.find((v) => v.key === keyOrId);
     if (!match) {
-      console.log(chalk20.red(`Variable not found: ${keyOrId}`));
+      console.log(chalk21.red(`Variable not found: ${keyOrId}`));
       process.exit(1);
     }
     variableId = match.id;
@@ -15824,23 +16315,23 @@ async function envVarsDeleteCommand(envIdOrName, keyOrId, options) {
       initial: false
     });
     if (!r.confirm) {
-      console.log(chalk20.yellow("\nCancelled."));
+      console.log(chalk21.yellow("\nCancelled."));
       return;
     }
   }
   await orgAuthenticatedFetch(`/v1/environments/${id}/variables/${variableId}`, {
     method: "DELETE"
   });
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Deleted variable ${keyOrId}.
 `));
 }
 function printFile(f) {
-  console.log(chalk20.white(`  ${f.path}`));
-  console.log(chalk20.gray(`    ID: ${f.id}`));
-  console.log(chalk20.gray(`    Name: ${f.name}`));
-  console.log(chalk20.gray(`    Size: ${f.content.length} bytes`));
-  console.log(chalk20.gray(`    Updated: ${formatDate2(f.updated_at)}`));
+  console.log(chalk21.white(`  ${f.path}`));
+  console.log(chalk21.gray(`    ID: ${f.id}`));
+  console.log(chalk21.gray(`    Name: ${f.name}`));
+  console.log(chalk21.gray(`    Size: ${f.content.length} bytes`));
+  console.log(chalk21.gray(`    Updated: ${formatDate2(f.updated_at)}`));
   console.log();
 }
 async function envFilesListCommand(envIdOrName) {
@@ -15850,10 +16341,10 @@ async function envFilesListCommand(envIdOrName) {
     `/v1/environments/${id}/files`
   );
   if (response.environment_files.length === 0) {
-    console.log(chalk20.yellow("\nNo files.\n"));
+    console.log(chalk21.yellow("\nNo files.\n"));
     return;
   }
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Files (${response.environment_files.length}):
 `));
   for (const f of response.environment_files) printFile(f);
@@ -15884,7 +16375,7 @@ async function envFilesSetCommand(envIdOrName, destinationPath, options) {
       `/v1/environments/${id}/files/${match.id}`,
       { method: "PATCH", body: body2 }
     );
-    console.log(chalk20.green(`
+    console.log(chalk21.green(`
 Updated file ${response2.environment_file.path}.
 `));
     return;
@@ -15899,7 +16390,7 @@ Updated file ${response2.environment_file.path}.
     `/v1/environments/${id}/files`,
     { method: "POST", body }
   );
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Created file ${response.environment_file.path}.
 `));
 }
@@ -15913,7 +16404,7 @@ async function envFilesDeleteCommand(envIdOrName, pathOrId, options) {
     );
     const match = existing.environment_files.find((f) => f.path === pathOrId);
     if (!match) {
-      console.log(chalk20.red(`File not found: ${pathOrId}`));
+      console.log(chalk21.red(`File not found: ${pathOrId}`));
       process.exit(1);
     }
     fileId = match.id;
@@ -15926,20 +16417,20 @@ async function envFilesDeleteCommand(envIdOrName, pathOrId, options) {
       initial: false
     });
     if (!r.confirm) {
-      console.log(chalk20.yellow("\nCancelled."));
+      console.log(chalk21.yellow("\nCancelled."));
       return;
     }
   }
   await orgAuthenticatedFetch(`/v1/environments/${id}/files/${fileId}`, {
     method: "DELETE"
   });
-  console.log(chalk20.green(`
+  console.log(chalk21.green(`
 Deleted file ${pathOrId}.
 `));
 }
 
 // src/index.ts
-var CLI_VERSION = "0.2.182";
+var CLI_VERSION = "0.2.183";
 function parseBooleanOption(value) {
   if (value === "true") return true;
   if (value === "false") return false;
@@ -15952,7 +16443,7 @@ program.command("login").description("Authenticate with your Replicas account").
     await loginCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -15964,7 +16455,7 @@ program.command("init").description("Create a replicas.json or replicas.yaml con
     initCommand(options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -15976,7 +16467,7 @@ program.command("logout").description("Clear stored credentials").action(() => {
     logoutCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -15988,7 +16479,7 @@ program.command("whoami").description("Display current authenticated user").acti
     await whoamiCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16000,7 +16491,7 @@ program.command("codex-auth").description("Authenticate Replicas with your Codex
     await codexAuthCommand(options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16012,7 +16503,7 @@ program.command("claude-auth").description("Authenticate Replicas with your Clau
     await claudeAuthCommand(options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16025,7 +16516,7 @@ org.command("switch").description("Switch to a different organization").action(a
     await orgSwitchCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16037,7 +16528,7 @@ org.action(async () => {
     await orgCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16049,7 +16540,7 @@ program.command("connect <workspace-name>").description("Connect to a workspace
     await connectCommand(workspaceName);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16061,7 +16552,7 @@ program.command("code <workspace-name>").description("Open a workspace in VSCode
     await codeCommand(workspaceName);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16074,7 +16565,7 @@ config.command("get <key>").description("Get a configuration value").action(asyn
     await configGetCommand(key);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16086,7 +16577,7 @@ config.command("set <key> <value>").description("Set a configuration value").act
     await configSetCommand(key, value);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16098,7 +16589,7 @@ config.command("list").description("List all configuration values").action(async
     await configListCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16110,7 +16601,7 @@ program.command("list").description("List all replicas").option("-p, --page <pag
     await replicaListCommand(options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16122,7 +16613,7 @@ program.command("get <id>").description("Get replica details by ID").action(asyn
     await replicaGetCommand(id);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16134,7 +16625,7 @@ program.command("create [name]").description("Create a new replica").option("-m,
     await replicaCreateCommand(name, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16146,7 +16637,7 @@ program.command("send <id>").description("Send a message to a replica").option("
     await replicaSendCommand(id, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16158,7 +16649,7 @@ program.command("delete <id>").description("Delete a replica").option("-f, --for
     await replicaDeleteCommand(id, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16170,7 +16661,7 @@ program.command("read <id>").description("Read conversation history of a replica
     await replicaReadCommand(id, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16183,7 +16674,7 @@ automation.command("list").description("List all automations").option("-p, --pag
     await automationListCommand(options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16195,7 +16686,7 @@ automation.command("get <id>").description("Get automation details by ID").actio
     await automationGetCommand(id);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16210,7 +16701,7 @@ automation.command("create [name]").description("Create a new automation").optio
     });
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16222,7 +16713,7 @@ automation.command("edit <id>").description("Edit an existing automation").optio
     await automationEditCommand(id, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16234,7 +16725,7 @@ automation.command("run <id>").description("Manually trigger an automation (cron
     await automationRunCommand(id);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16246,7 +16737,7 @@ automation.command("delete <id>").description("Delete an automation").option("-f
     await automationDeleteCommand(id, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16258,7 +16749,7 @@ automation.action(async () => {
     await automationListCommand({});
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16271,7 +16762,7 @@ repos.command("list").description("List all repositories").action(async () => {
     await repositoriesListCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16283,7 +16774,7 @@ repos.action(async () => {
     await repositoriesListCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16296,7 +16787,7 @@ environment.command("list").description("List all environments").action(async ()
     await environmentListCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16308,7 +16799,7 @@ environment.command("get <id-or-name>").description('Get an environment by ID or
     await environmentGetCommand(idOrName);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16320,7 +16811,7 @@ environment.command("create [name]").description("Create a new environment").opt
     await environmentCreateCommand(name, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16332,7 +16823,7 @@ environment.command("edit <id-or-name>").description("Edit an environment").opti
     await environmentEditCommand(idOrName, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16344,7 +16835,7 @@ environment.command("delete <id-or-name>").description("Delete an environment").
     await environmentDeleteCommand(idOrName, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16357,7 +16848,7 @@ envVars.command("list <env>").description("List variables in an environment (val
     await envVarsListCommand(env, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16369,7 +16860,7 @@ envVars.command("set <env> <key> <value>").description("Create or update a varia
     await envVarsSetCommand(env, key, value);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16381,7 +16872,7 @@ envVars.command("delete <env> <key-or-id>").description("Delete a variable by ke
     await envVarsDeleteCommand(env, keyOrId, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16394,7 +16885,7 @@ envFiles.command("list <env>").description("List files in an environment").actio
     await envFilesListCommand(env);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16406,7 +16897,7 @@ envFiles.command("set <env> <destination-path>").description("Create or update a
     await envFilesSetCommand(env, destinationPath, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16418,7 +16909,7 @@ envFiles.command("delete <env> <path-or-id>").description("Delete a file by dest
     await envFilesDeleteCommand(env, pathOrId, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16430,7 +16921,7 @@ environment.action(async () => {
     await environmentListCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16442,7 +16933,7 @@ program.command("interact").alias("i").description("Launch the interactive termi
     await interactiveCommand();
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk21.red(`
+      console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
     }
@@ -16493,7 +16984,7 @@ if (isAgentMode()) {
       await previewAddCommand(workspaceId, options);
     } catch (error) {
       if (error instanceof Error) {
-        console.error(chalk21.red(`
+        console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
       }
@@ -16505,7 +16996,7 @@ if (isAgentMode()) {
       await previewListCommand(workspaceId);
     } catch (error) {
       if (error instanceof Error) {
-        console.error(chalk21.red(`
+        console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
       }
@@ -16517,7 +17008,7 @@ if (isAgentMode()) {
       await previewRemoveCommand(workspaceId, options);
     } catch (error) {
       if (error instanceof Error) {
-        console.error(chalk21.red(`
+        console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
       }
@@ -16532,7 +17023,7 @@ if (isAgentMode()) {
       await mediaUploadCommand(files, options);
     } catch (error) {
       if (error instanceof Error) {
-        console.error(chalk21.red(`
+        console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
       }
@@ -16544,19 +17035,47 @@ if (isAgentMode()) {
       await mediaListCommand(options);
     } catch (error) {
       if (error instanceof Error) {
-        console.error(chalk21.red(`
+        console.error(chalk22.red(`
 \u2717 ${error.message}
 `));
       }
       process.exit(1);
     }
   });
+  const computer = program.command("computer").description("Drive the workspace Linux desktop (mouse, keyboard, screenshots, screen recording, live preview)");
+  const wrap = (fn) => async (...args) => {
+    try {
+      await fn(...args);
+    } catch (error) {
+      if (error instanceof Error) {
+        console.error(chalk22.red(`
+\u2717 ${error.message}
+`));
+      }
+      process.exit(1);
+    }
+  };
+  computer.command("start").description("Ensure the desktop stack is running and create an authenticated noVNC preview URL. Prints the viewer URL.").option("--port <port>", "noVNC port to expose (default: 6080)").option("--display <id>", "X display to use (default: :99)").option("--size <WxH>", "Display size, e.g. 1920x1080 (default: 1920x1080)").action(wrap((options) => computerStartCommand(options)));
+  computer.command("stop").description("Tear down the noVNC preview. Desktop services stay running for the next start.").option("--port <port>", "noVNC port to unregister (default: 6080)").action(wrap((options) => computerStopCommand(options)));
+  computer.command("status").description("Show which desktop services are running and the active preview URL").action(wrap(() => computerStatusCommand()));
+  computer.command("screenshot <path>").description("Capture the current desktop to a PNG file. Use the path with `replicas media upload` to share it.").action(wrap((path6) => computerScreenshotCommand(path6)));
+  computer.command("click <x> <y>").description("Move to (x, y) and click. Coordinates are in pixels on the workspace display.").option("-b, --button <n>", "Mouse button (1=left, 2=middle, 3=right). Default 1.").option("--double", "Double-click instead of single-click").option("--modifiers <mods>", "Hold modifier keys during the click, e.g. ctrl or ctrl+shift").action(wrap((x, y, options) => computerClickCommand(x, y, options)));
+  computer.command("move <x> <y>").description("Move the mouse to (x, y) without clicking").action(wrap((x, y) => computerMoveCommand(x, y)));
+  computer.command("type <text>").description("Type a literal string into the focused field. Use `key` for key combos like ctrl+l.").option("--delay <ms>", "Per-character delay in ms (default 12 \u2248 80 wpm)").action(wrap((text, options) => computerTypeCommand(text, options)));
+  computer.command("key <combo>").description("Press a key combo, e.g. Return, Escape, ctrl+l, ctrl+shift+t. Same syntax as xdotool key.").action(wrap((combo) => computerKeyCommand(combo)));
+  computer.command("scroll <direction>").description("Scroll up | down | left | right. Optionally provide --x / --y to hover before scrolling.").option("--amount <n>", "Wheel ticks (default 3)").option("--x <x>", "Hover x before scrolling").option("--y <y>", "Hover y before scrolling").action(wrap((direction, options) => computerScrollCommand(direction, options)));
+  computer.command("drag <fromX> <fromY> <toX> <toY>").description("Press the left mouse button at (fromX, fromY), drag to (toX, toY), release.").action(wrap((fx, fy, tx, ty) => computerDragCommand(fx, fy, tx, ty)));
+  computer.command("launch <app> [args...]").description("Launch an app on the workspace display. Aliases: chrome, chromium, firefox, terminal.").action(wrap((app, args) => computerLaunchCommand(app, args)));
+  const record = computer.command("record").description("Screen-record the workspace display to an MP4 (1080p 60fps libx264).");
+  record.command("start <path>").description("Start recording to <path>. Output is fragmented MP4 (safe if the workspace dies mid-record).").option("--fps <n>", "Frame rate (default 60)").action(wrap((path6, options) => computerRecordStartCommand(path6, options)));
+  record.command("stop").description("Stop the active recording and finalize the MP4. Prints the output path.").action(wrap(() => computerRecordStopCommand()));
   const allowed = /* @__PURE__ */ new Set([
     "init",
     "whoami",
     "connect",
     "preview",
     "media",
+    "computer",
     "automation",
     "repos",
     "environment"