replicas-cli 0.2.640 → 0.2.642

package/README.md

@@ -41,6 +41,9 @@ Choose the organization used by organization-scoped commands. The selection pers
 ### `replicas connect <workspace-name>`
 Connect to a workspace via SSH.
 
+### `replicas code [workspace-name...]`
+Open a workspace in VS Code via Remote SSH. Omit the argument to pick a workspace with the arrow keys and Enter, or pass a name or ID. Names with spaces work with or without quotes.
+
 ### Coding agents
 Use `replicas claude-auth` or `replicas codex-auth` to connect Claude Code or Codex credentials. Cursor uses a Cursor API key configured in Coding Agents settings.
 

package/dist/index.cjs

@@ -24617,6 +24617,11 @@ var SENTRY_ABILITY = {
   referenceFile: { name: "SENTRY.md", content: REFERENCE11 }
 };
 
+// ../shared/src/slack-response-style.ts
+var SLACK_CONCISE_REPLY_SHAPE = "one to three plain sentences on what you did and what it means, with no headers, bullet lists, command logs, or step-by-step narration";
+var SLACK_BLOCK_KIT_GUIDANCE = "Use Block Kit whenever structure or a link would make the message faster to scan or use. You have broad leeway to combine supported display elements: `section` and `fields` for compact updates; `context` for secondary metadata; `header` and `divider` for genuinely distinct sections; images for useful previews; and `actions` with URL buttons for pull requests, dashboards, downloads, or next steps. Consult the [Slack Block Kit reference](https://docs.slack.dev/reference/block-kit/blocks) for exact schemas before using an unfamiliar block. Do not add selects, date pickers, approval buttons, or other controls that require an interaction callback. Keep simple replies as plain text, do not add decorative UI or repeat content across blocks, and always keep `text` as a concise, complete fallback for notifications and accessibility.";
+var SLACK_PR_BUTTON_GUIDANCE = 'The first time you share a given pull request or merge request link in a thread \u2014 the message announcing you opened it \u2014 attach a button for it: send `blocks` alongside `text` \u2014 a `section` block holding your message as `mrkdwn`, then an `actions` block with one element per newly shared link, `{"type": "button", "style": "primary", "text": {"type": "plain_text", "text": "View PR"}, "url": "<pr url>", "action_id": "view_pr"}`. Later messages about a pull request you already linked in this thread keep the link in the sentence and get no button, and never re-post a button for a link someone already has. Label it "View MR" for GitLab, and if there are several give each button a unique `action_id` and name its repository in the label ("View PR \xB7 web"). Always keep `text` populated with the same message \u2014 Slack uses it for notifications and fallback \u2014 and keep the link in the sentence too.';
+
 // ../shared/src/default-skills/replicas-agent/abilities/slack.ts
 var SECTION12 = `### Slack
 Send messages, read threads, search conversations, and transfer files through the workspace-scoped TypeScript SDK.
@@ -24664,6 +24669,10 @@ await Bun.write('/tmp/recording.mov', response);
 
 ## Send and attach a message
 
+Write like a teammate, not a report. Lead with the outcome, remove repetition and filler, and preserve the facts needed to understand the result, blocker, or next action. A routine update is ${SLACK_CONCISE_REPLY_SHAPE}.
+
+${SLACK_BLOCK_KIT_GUIDANCE}
+
 \`\`\`ts
 const message = await replicas.slack.call<{ channel: string; ts: string }>('chat.postMessage', {
   channel: 'C0123ABC',
@@ -24672,26 +24681,7 @@ const message = await replicas.slack.call<{ channel: string; ts: string }>('chat
 await replicas.slack.attachThread({ channel: message.channel, threadTs: message.ts });
 \`\`\`
 
-A link in the message text stays plain text, so the message that first shares a pull request or merge request link passes \`blocks\` alongside \`text\` to render a button for it. Keep \`text\` set to the same message \u2014 Slack uses it for notifications and fallback.
-
-\`\`\`ts
-await replicas.slack.call('chat.postMessage', {
-  channel: 'C0123ABC',
-  thread_ts: '1234567890.123456',
-  text: summary,
-  blocks: [
-    { type: 'section', text: { type: 'mrkdwn', text: summary } },
-    {
-      type: 'actions',
-      elements: [
-        { type: 'button', style: 'primary', text: { type: 'plain_text', text: 'View PR' }, url: prUrl, action_id: 'view_pr' },
-      ],
-    },
-  ],
-});
-\`\`\`
-
-Only the announcing message gets the button \u2014 follow-ups about a pull request already linked in the thread keep the link in the text and drop the \`blocks\`. Use "View MR" for GitLab. With several links, give each button a unique \`action_id\` and name its repository in the label ("View PR \xB7 web").
+${SLACK_PR_BUTTON_GUIDANCE}
 
 For screenshots, recordings, diagrams, or other media, read \`references/MEDIA.md\` before posting. It is the single source of truth for uploading the Replicas copy and the raw file to Slack; a dashboard link in \`text\` is not an inline attachment.
 
@@ -27252,7 +27242,7 @@ var headlessFilesystemAgentResultSchema = external_exports.object({
 });
 
 // ../shared/src/cli-version.ts
-var CLI_VERSION = "0.2.640";
+var CLI_VERSION = "0.2.642";
 
 // ../shared/src/version.ts
 function compareVersions(v1, v2) {
@@ -28512,27 +28502,37 @@ async function resolveWorkspaceRecord(workspaceName) {
   if (!canCallOrgApi()) {
     throw new Error('No organization selected. Please run "replicas org switch" first.');
   }
-  const exactWorkspace = await fetchWorkspaceById(workspaceName);
-  if (exactWorkspace) return exactWorkspace;
-  console.log(import_chalk5.default.blue(`
-Searching for workspace: ${workspaceName}...`));
-  const response = await orgAuthenticatedFetch(
-    `/v1/workspaces?name=${encodeURIComponent(workspaceName)}`
-  );
-  if (response.workspaces.length === 0) {
-    throw new Error(`No workspaces found with name matching "${workspaceName}".`);
+  if (workspaceName) {
+    const exactWorkspace = await fetchWorkspaceById(workspaceName);
+    if (exactWorkspace) return exactWorkspace;
+  }
+  console.log(import_chalk5.default.blue(workspaceName ? `
+Searching for workspace: ${workspaceName}...` : "\nLoading workspaces..."));
+  const params = new URLSearchParams({ limit: "100" });
+  if (workspaceName) params.set("name", workspaceName);
+  const workspaces = [];
+  for (let page = 1; ; page++) {
+    params.set("page", String(page));
+    const response = await orgAuthenticatedFetch(`/v1/workspaces?${params}`);
+    workspaces.push(...response.workspaces);
+    if (page >= response.totalPages || response.workspaces.length === 0) break;
+  }
+  if (workspaces.length === 0) {
+    throw new Error(workspaceName ? `No workspaces found with name matching "${workspaceName}".` : "No workspaces found.");
   }
   let selectedWorkspace;
-  if (response.workspaces.length === 1) {
-    selectedWorkspace = response.workspaces[0];
+  if (workspaceName && workspaces.length === 1) {
+    selectedWorkspace = workspaces[0];
   } else {
-    console.log(import_chalk5.default.yellow(`
-Found ${response.workspaces.length} workspaces matching "${workspaceName}":`));
+    if (workspaceName) {
+      console.log(import_chalk5.default.yellow(`
+Found ${workspaces.length} workspaces matching "${workspaceName}":`));
+    }
     const selectResponse = await (0, import_prompts5.default)({
       type: "select",
       name: "workspaceId",
       message: "Select a workspace:",
-      choices: response.workspaces.map((ws) => ({
+      choices: workspaces.map((ws) => ({
         title: `${ws.name} (${ws.status || "unknown"})`,
         value: ws.id,
         description: `Status: ${ws.status || "unknown"}`
@@ -28541,7 +28541,7 @@ Found ${response.workspaces.length} workspaces matching "${workspaceName}":`));
     if (!selectResponse.workspaceId) {
       throw new Error("Workspace selection cancelled.");
     }
-    const selected = response.workspaces.find((ws) => ws.id === selectResponse.workspaceId);
+    const selected = workspaces.find((ws) => ws.id === selectResponse.workspaceId);
     if (!selected) {
       throw new Error("Selected workspace was not found.");
     }
@@ -28701,6 +28701,10 @@ async function codeCommand(workspaceName) {
     console.log(import_chalk7.default.red('Not logged in. Please run "replicas login" first.'));
     process.exit(1);
   }
+  if (!workspaceName && !process.stdin.isTTY) {
+    console.error(import_chalk7.default.red('Pass a workspace name or ID, or run "replicas code" in an interactive terminal.'));
+    process.exit(1);
+  }
   try {
     const { workspace, sshToken, sshHost, sshProxyCommand, repoName } = await prepareWorkspaceConnection(workspaceName);
     const hostAlias = getWorkspaceHostAlias(workspace.name);
@@ -32154,7 +32158,7 @@ Error: ${error51 instanceof Error ? error51.message : "Unknown error"}`));
     process.exit(1);
   }
 });
-program.command("code <workspace-name...>").description("Open a workspace in VSCode/Cursor via Remote SSH").action(async (workspaceName) => {
+program.command("code [workspace-name...]").description("Open a workspace in VSCode/Cursor via Remote SSH (pick a workspace if omitted)").action(async (workspaceName = []) => {
   try {
     await codeCommand(workspaceName.join(" "));
   } catch (error51) {

package/package.json

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