replicas-cli 0.2.279 → 0.2.280

package/README.md

@@ -50,6 +50,9 @@ Connect to a workspace via SSH.
 ### `replicas interact`
 Launch the interactive terminal dashboard — a full TUI alternative to the web dashboard. View workspaces, chat with agents, monitor environment status, and create workspaces without leaving the terminal.
 
+### 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.
+
 ## Configuration
 
 Create a `replicas.json` or `replicas.yaml` file in your repository root:

package/dist/index.mjs

@@ -7559,11 +7559,33 @@ var VALID_AGENT_PROVIDERS = ["claude", "codex", "cursor", "relay"];
 function isValidAgentProvider(value) {
   return VALID_AGENT_PROVIDERS.some((p) => p === value);
 }
+var AGENT_PROVIDER_OPTIONS = [
+  {
+    value: "claude",
+    label: "Claude Code",
+    description: "Use Claude Code for tasks"
+  },
+  {
+    value: "codex",
+    label: "OpenAI Codex",
+    description: "Use OpenAI Codex for tasks"
+  },
+  {
+    value: "cursor",
+    label: "Cursor",
+    description: "Use Cursor for tasks"
+  },
+  {
+    value: "relay",
+    label: "Relay",
+    description: "Orchestrating agent that delegates to Claude Code and Codex subagents"
+  }
+];
 var VALID_THINKING_LEVELS = ["low", "medium", "high", "max"];
 function isValidThinkingLevel(value) {
   return VALID_THINKING_LEVELS.some((l) => l === value);
 }
-function getProviderDisplayName(provider) {
+function getProviderDisplayName(provider, variant = "short") {
   switch (provider) {
     case "codex":
       return "Codex";
@@ -7572,7 +7594,7 @@ function getProviderDisplayName(provider) {
     case "relay":
       return "Relay";
     case "claude":
-      return "Claude";
+      return variant === "long" ? "Claude Code" : "Claude";
   }
 }
 
@@ -9242,7 +9264,7 @@ var HOOK_EXEC_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
 var REPLICAS_CONFIG_FILENAMES = ["replicas.json", "replicas.yaml", "replicas.yml"];
 
 // ../shared/src/cli-version.ts
-var CLI_VERSION = "0.2.279";
+var CLI_VERSION = "0.2.280";
 
 // ../shared/src/engine/environment.ts
 var DESKTOP_NOVNC_PORT = 6080;
@@ -12589,6 +12611,16 @@ Update available: ${currentVersion} \u2192 ${latestVersion}`));
 // src/commands/replica.ts
 import chalk15 from "chalk";
 import prompts3 from "prompts";
+var REPLICA_AGENT_PROVIDERS = VALID_AGENT_PROVIDERS.filter((provider) => provider !== "relay");
+function parseReplicaAgent(value) {
+  if (!value) return void 0;
+  const normalized = value.trim().toLowerCase();
+  if (isValidAgentProvider(normalized) && normalized !== "relay") {
+    return normalized;
+  }
+  console.log(chalk15.red(`Invalid coding agent: ${value}. Must be one of: ${REPLICA_AGENT_PROVIDERS.join(", ")}`));
+  process.exit(1);
+}
 function formatDate(dateString) {
   return new Date(dateString).toLocaleString();
 }
@@ -12789,7 +12821,7 @@ async function replicaCreateCommand(name, options) {
     let replicaName = name;
     let message = options.message;
     let selectedEnvironmentId = options.environment?.trim();
-    let codingAgent = options.agent;
+    let codingAgent = parseReplicaAgent(options.agent);
     if (replicaName && /\s/.test(replicaName)) {
       console.log(chalk15.red("Replica name cannot contain spaces."));
       process.exit(1);
@@ -12846,21 +12878,14 @@ async function replicaCreateCommand(name, options) {
         type: "select",
         name: "agent",
         message: "Select coding agent:",
-        choices: [
-          { title: "Claude", value: "claude" },
-          { title: "Codex", value: "codex" }
-        ],
+        choices: AGENT_PROVIDER_OPTIONS.filter((option) => option.value !== "relay").map((option) => ({ title: option.label, value: option.value })),
         initial: 0
       });
       if (!response2.agent) {
         console.log(chalk15.yellow("\nCancelled."));
         return;
       }
-      codingAgent = response2.agent;
-    }
-    if (!codingAgent || !["claude", "codex"].includes(codingAgent)) {
-      console.log(chalk15.red(`Invalid coding agent: ${codingAgent}. Must be one of: claude, codex`));
-      process.exit(1);
+      codingAgent = parseReplicaAgent(response2.agent);
     }
     const body = {
       name: replicaName,
@@ -12911,11 +12936,7 @@ async function replicaSendCommand(id, options) {
       message
     };
     if (options.agent) {
-      if (!["claude", "codex"].includes(options.agent)) {
-        console.log(chalk15.red(`Invalid coding agent: ${options.agent}. Must be one of: claude, codex`));
-        process.exit(1);
-      }
-      body.coding_agent = options.agent;
+      body.coding_agent = parseReplicaAgent(options.agent);
     }
     const response = await orgAuthenticatedFetch(
       `/v1/replica/${id}/send`,
@@ -15938,11 +15959,6 @@ ${parsed.userPrompt}` });
 
 // src/interactive/components/ChatMessage.tsx
 import { Fragment as Fragment3, jsx as jsx6, jsxs as jsxs6 } from "@opentui/react/jsx-runtime";
-var AGENT_LABELS = {
-  claude: "Claude",
-  codex: "Codex",
-  relay: "Relay"
-};
 function truncate4(text, maxLen) {
   return text.length > maxLen ? text.slice(0, maxLen - 1) + "\u2026" : text;
 }
@@ -16089,7 +16105,7 @@ function ChatMessage({ message, provider }) {
     }
     case "agent":
       return /* @__PURE__ */ jsxs6("box", { flexDirection: "column", paddingX: 1, children: [
-        /* @__PURE__ */ jsx6("text", { children: /* @__PURE__ */ jsx6("span", { fg: "#3eeba3", children: /* @__PURE__ */ jsx6("strong", { children: AGENT_LABELS[provider] }) }) }),
+        /* @__PURE__ */ jsx6("text", { children: /* @__PURE__ */ jsx6("span", { fg: "#3eeba3", children: /* @__PURE__ */ jsx6("strong", { children: getProviderDisplayName(provider) }) }) }),
         /* @__PURE__ */ jsx6(
           "markdown",
           {
@@ -16197,7 +16213,8 @@ function ChatArea({
   isProcessing,
   loading,
   agentAvailable,
-  agentLabel
+  agentLabel,
+  agentConnectHelp
 }) {
   const textareaRef = useRef2(null);
   const scrollboxRef = useRef2(null);
@@ -16349,9 +16366,8 @@ function ChatArea({
               ) }),
               !agentAvailable && /* @__PURE__ */ jsx7("box", { paddingX: 1, height: 1, children: /* @__PURE__ */ jsx7("text", { children: /* @__PURE__ */ jsxs7("span", { fg: "#d97706", children: [
                 agentLabel,
-                " is not connected. Run `replicas ",
-                agentLabel === "Codex" ? "codex-auth" : "claude-auth",
-                "` to connect."
+                " is not connected. ",
+                agentConnectHelp
               ] }) }) }),
               /* @__PURE__ */ jsxs7(
                 "box",
@@ -16711,7 +16727,8 @@ function WorkspaceInfo({ status, workspaceName, workspaceId, focused, loading, a
   const env = rawEnv && agentAvailability ? {
     ...rawEnv,
     claudeAuthMethod: agentAvailability.claude.available ? rawEnv.claudeAuthMethod : "none",
-    codexAuthMethod: agentAvailability.codex.available ? rawEnv.codexAuthMethod : "none"
+    codexAuthMethod: agentAvailability.codex.available ? rawEnv.codexAuthMethod : "none",
+    cursorAuthMethod: agentAvailability.cursor.available ? rawEnv.cursorAuthMethod : "none"
   } : rawEnv;
   const dashboardItem = findItem("dashboard");
   const wakeItem = findItem("wake");
@@ -16772,7 +16789,7 @@ function WorkspaceInfo({ status, workspaceName, workspaceId, focused, loading, a
             onClick: () => handleAction(wakeItem)
           }
         ),
-        (status.isClaudeProcessing || status.isCodexProcessing || status.isRelayProcessing) && /* @__PURE__ */ jsxs8("box", { backgroundColor: "#1a1500", paddingX: 1, marginX: 1, marginBottom: 1, children: [
+        (status.isClaudeProcessing || status.isCodexProcessing || status.isCursorProcessing || status.isRelayProcessing) && /* @__PURE__ */ jsxs8("box", { backgroundColor: "#1a1500", paddingX: 1, marginX: 1, marginBottom: 1, children: [
           status.isClaudeProcessing && /* @__PURE__ */ jsx8("text", { children: /* @__PURE__ */ jsxs8("span", { fg: "#ffaa00", children: [
             "\u25C6",
             " Claude thinking..."
@@ -16781,6 +16798,10 @@ function WorkspaceInfo({ status, workspaceName, workspaceId, focused, loading, a
             "\u25C6",
             " Codex thinking..."
           ] }) }),
+          status.isCursorProcessing && /* @__PURE__ */ jsx8("text", { children: /* @__PURE__ */ jsxs8("span", { fg: "#ffaa00", children: [
+            "\u25C6",
+            " Cursor thinking..."
+          ] }) }),
           status.isRelayProcessing && /* @__PURE__ */ jsx8("text", { children: /* @__PURE__ */ jsxs8("span", { fg: "#ffaa00", children: [
             "\u25C6",
             " Relay thinking..."
@@ -16794,6 +16815,10 @@ function WorkspaceInfo({ status, workspaceName, workspaceId, focused, loading, a
           /* @__PURE__ */ jsxs8("box", { flexDirection: "row", justifyContent: "space-between", paddingX: 1, backgroundColor: "#111111", children: [
             /* @__PURE__ */ jsx8("text", { children: /* @__PURE__ */ jsx8("span", { fg: "#cccccc", children: "Codex" }) }),
             /* @__PURE__ */ jsx8("text", { children: AUTH_METHOD_LABELS[env.codexAuthMethod] ? /* @__PURE__ */ jsx8("span", { fg: "#3eeba3", children: AUTH_METHOD_LABELS[env.codexAuthMethod] }) : /* @__PURE__ */ jsx8("span", { fg: "#ff4444", children: "\u2717" }) })
+          ] }),
+          /* @__PURE__ */ jsxs8("box", { flexDirection: "row", justifyContent: "space-between", paddingX: 1, backgroundColor: "#111111", children: [
+            /* @__PURE__ */ jsx8("text", { children: /* @__PURE__ */ jsx8("span", { fg: "#cccccc", children: "Cursor" }) }),
+            /* @__PURE__ */ jsx8("text", { children: AUTH_METHOD_LABELS[env.cursorAuthMethod] ? /* @__PURE__ */ jsx8("span", { fg: "#3eeba3", children: AUTH_METHOD_LABELS[env.cursorAuthMethod] }) : /* @__PURE__ */ jsx8("span", { fg: "#ff4444", children: "\u2717" }) })
           ] })
         ] }),
         /* @__PURE__ */ jsx8(Section, { title: "View", children: (() => {
@@ -17031,6 +17056,12 @@ var authValue = {
   monolithUrl: MONOLITH_URL5,
   queryClient
 };
+function getAgentConnectHelp(provider) {
+  if (provider === "codex") return "Run `replicas codex-auth` to connect.";
+  if (provider === "cursor") return "Add a Cursor API key in Coding Agents settings.";
+  if (provider === "relay") return "Configure Relay in Coding Agents settings.";
+  return "Run `replicas claude-auth` to connect.";
+}
 function App() {
   return /* @__PURE__ */ jsx11(ReplicasAuthProvider, { value: authValue, children: /* @__PURE__ */ jsxs9(ToastProvider, { children: [
     /* @__PURE__ */ jsx11(AppInner, {}),
@@ -17116,8 +17147,9 @@ function AppInner() {
   const selectedChat = chats.find((c) => c.id === resolvedChatId) ?? null;
   const isProcessing = mockThinking || (selectedChat?.processing ?? false);
   const selectedAgent = selectedChat?.provider ?? "claude";
-  const agentAvailable = agentAvailability ? selectedAgent === "codex" ? agentAvailability.codex.available : agentAvailability.claude.available : true;
-  const agentLabel = selectedAgent === "codex" ? "Codex" : "Claude Code";
+  const agentAvailable = agentAvailability ? selectedAgent === "codex" ? agentAvailability.codex.available : selectedAgent === "cursor" ? agentAvailability.cursor.available : selectedAgent === "relay" ? agentAvailability.relay.available : agentAvailability.claude.available : true;
+  const agentLabel = getProviderDisplayName(selectedAgent, "long");
+  const agentConnectHelp = getAgentConnectHelp(selectedAgent);
   const displayMessages = useMemo6(() => {
     if (isMockSelected) return mockMessages;
     const rawEvents = historyData?.events ?? [];
@@ -17313,7 +17345,7 @@ function AppInner() {
         return;
       }
       if (!agentAvailable) {
-        toast.error(new Error(`${agentLabel} is not connected. Run \`replicas ${selectedAgent === "codex" ? "codex-auth" : "claude-auth"}\` to connect.`));
+        toast.error(new Error(`${agentLabel} is not connected. ${agentConnectHelp}`));
         return;
       }
       sendMessageMutation.mutate({
@@ -17321,7 +17353,7 @@ function AppInner() {
         planMode: taskMode === "plan"
       });
     },
-    [selectedWorkspaceId, resolvedChatId, isMockSelected, sendMessageMutation, taskMode, agentAvailable, agentLabel, selectedAgent, toast.error]
+    [selectedWorkspaceId, resolvedChatId, isMockSelected, sendMessageMutation, taskMode, agentAvailable, agentLabel, agentConnectHelp, toast.error]
   );
   return /* @__PURE__ */ jsxs9("box", { flexDirection: "column", width: "100%", height: "100%", backgroundColor: "#000000", children: [
     /* @__PURE__ */ jsxs9("box", { flexDirection: "row", flexGrow: 1, backgroundColor: "#000000", children: [
@@ -17366,7 +17398,8 @@ function AppInner() {
           isProcessing,
           loading: loadingMessages,
           agentAvailable,
-          agentLabel
+          agentLabel,
+          agentConnectHelp
         }
       ) : selectedWorkspaceId && statusData?.status === "sleeping" ? /* @__PURE__ */ jsxs9(
         "box",
@@ -18134,7 +18167,7 @@ program.command("get <id>").description("Get replica details by ID").action(asyn
     process.exit(1);
   }
 });
-program.command("create [name]").description("Create a new replica").option("-m, --message <message>", "Initial message for the replica").option("-e, --environment <environment>", "Environment ID").option("-a, --agent <agent>", "Coding agent (claude, codex)").action(async (name, options) => {
+program.command("create [name]").description("Create a new replica").option("-m, --message <message>", "Initial message for the replica").option("-e, --environment <environment>", "Environment ID").option("-a, --agent <agent>", "Coding agent (claude, codex, cursor)").action(async (name, options) => {
   try {
     await replicaCreateCommand(name, options);
   } catch (error) {
@@ -18146,7 +18179,7 @@ program.command("create [name]").description("Create a new replica").option("-m,
     process.exit(1);
   }
 });
-program.command("send <id>").description("Send a message to a replica").option("-m, --message <message>", "Message to send").option("-a, --agent <agent>", "Coding agent (claude, codex)").action(async (id, options) => {
+program.command("send <id>").description("Send a message to a replica").option("-m, --message <message>", "Message to send").option("-a, --agent <agent>", "Coding agent (claude, codex, cursor)").action(async (id, options) => {
   try {
     await replicaSendCommand(id, options);
   } catch (error) {
@@ -18207,7 +18240,7 @@ automation.command("get <id>").description("Get automation details by ID").actio
     process.exit(1);
   }
 });
-automation.command("create [name]").description("Create a new automation").option("-p, --prompt <prompt>", "Prompt for the automation").option("-e, --environment <environment>", "Environment name or ID").option("--trigger-cron <schedule>", 'Cron schedule expression (e.g. "0 9 * * 1-5")').option("--trigger-cron-timezone <timezone>", "Timezone for cron trigger (default: UTC)").option("--trigger-github <event>", 'GitHub event (e.g. "pull_request.opened")').option("--trigger-github-repos <repos>", "Comma-separated repo names to filter GitHub trigger").option("--lifecycle <policy>", "Workspace lifecycle: delete_when_done, delete_after_inactivity, default").option("--auto-stop-minutes <minutes>", "Inactivity timeout in minutes (3-1440, requires --lifecycle delete_after_inactivity)").option("--pr-followups", "Allow follow-up actions on matching PRs").option("--agent-provider <provider>", 'Coding agent to use: claude, codex, relay (or "none" to inherit org default)').option("--model <model>", 'Model identifier (must be valid for --agent-provider; pass "none" to clear)').option("--thinking-level <level>", 'Thinking/reasoning level: low, medium, high, max (or "none" to clear)').option("--plan-mode", "Run automation messages in plan mode").option("--goal-mode", "Set automation messages as Codex goals").option("--fast-mode", "Run automation messages in fast mode").option("--personal", "Create a personal automation owned by the authenticated user").option("--disabled", "Create in disabled state").action(async (name, options) => {
+automation.command("create [name]").description("Create a new automation").option("-p, --prompt <prompt>", "Prompt for the automation").option("-e, --environment <environment>", "Environment name or ID").option("--trigger-cron <schedule>", 'Cron schedule expression (e.g. "0 9 * * 1-5")').option("--trigger-cron-timezone <timezone>", "Timezone for cron trigger (default: UTC)").option("--trigger-github <event>", 'GitHub event (e.g. "pull_request.opened")').option("--trigger-github-repos <repos>", "Comma-separated repo names to filter GitHub trigger").option("--lifecycle <policy>", "Workspace lifecycle: delete_when_done, delete_after_inactivity, default").option("--auto-stop-minutes <minutes>", "Inactivity timeout in minutes (3-1440, requires --lifecycle delete_after_inactivity)").option("--pr-followups", "Allow follow-up actions on matching PRs").option("--agent-provider <provider>", 'Coding agent to use: claude, codex, cursor, relay (or "none" to inherit org default)').option("--model <model>", 'Model identifier (must be valid for --agent-provider; pass "none" to clear)').option("--thinking-level <level>", 'Thinking/reasoning level: low, medium, high, max (or "none" to clear)').option("--plan-mode", "Run automation messages in plan mode").option("--goal-mode", "Set automation messages as Codex goals").option("--fast-mode", "Run automation messages in fast mode").option("--personal", "Create a personal automation owned by the authenticated user").option("--disabled", "Create in disabled state").action(async (name, options) => {
   try {
     await automationCreateCommand(name, {
       ...options,
@@ -18222,7 +18255,7 @@ automation.command("create [name]").description("Create a new automation").optio
     process.exit(1);
   }
 });
-automation.command("edit <id>").description("Edit an existing automation").option("-n, --name <name>", "New name").option("-p, --prompt <prompt>", "New prompt").option("-e, --enabled <enabled>", "Enable or disable (true/false)").option("--trigger-cron <schedule>", "Set cron schedule (replaces existing triggers)").option("--trigger-cron-timezone <timezone>", "Timezone for cron trigger").option("--trigger-github <event>", "Set GitHub event (replaces existing triggers)").option("--trigger-github-repos <repos>", "Comma-separated repo names to filter GitHub trigger").option("--environment <environment>", "Environment name or ID").option("--lifecycle <policy>", "Workspace lifecycle: delete_when_done, delete_after_inactivity, default").option("--auto-stop-minutes <minutes>", "Inactivity timeout in minutes (3-1440, requires --lifecycle delete_after_inactivity)").option("--pr-followups <enabled>", "Allow follow-up actions on matching PRs (true/false)", parseBooleanOption).option("--agent-provider <provider>", 'Coding agent to use: claude, codex, relay (or "none" to inherit org default)').option("--model <model>", 'Model identifier (must be valid for --agent-provider; pass "none" to clear)').option("--thinking-level <level>", 'Thinking/reasoning level: low, medium, high, max (or "none" to clear)').option("--plan-mode <enabled>", "Run automation messages in plan mode (true/false)", parseBooleanOption).option("--goal-mode <enabled>", "Set automation messages as Codex goals (true/false)", parseBooleanOption).option("--fast-mode <enabled>", "Run automation messages in fast mode (true/false)", parseBooleanOption).action(async (id, options) => {
+automation.command("edit <id>").description("Edit an existing automation").option("-n, --name <name>", "New name").option("-p, --prompt <prompt>", "New prompt").option("-e, --enabled <enabled>", "Enable or disable (true/false)").option("--trigger-cron <schedule>", "Set cron schedule (replaces existing triggers)").option("--trigger-cron-timezone <timezone>", "Timezone for cron trigger").option("--trigger-github <event>", "Set GitHub event (replaces existing triggers)").option("--trigger-github-repos <repos>", "Comma-separated repo names to filter GitHub trigger").option("--environment <environment>", "Environment name or ID").option("--lifecycle <policy>", "Workspace lifecycle: delete_when_done, delete_after_inactivity, default").option("--auto-stop-minutes <minutes>", "Inactivity timeout in minutes (3-1440, requires --lifecycle delete_after_inactivity)").option("--pr-followups <enabled>", "Allow follow-up actions on matching PRs (true/false)", parseBooleanOption).option("--agent-provider <provider>", 'Coding agent to use: claude, codex, cursor, relay (or "none" to inherit org default)').option("--model <model>", 'Model identifier (must be valid for --agent-provider; pass "none" to clear)').option("--thinking-level <level>", 'Thinking/reasoning level: low, medium, high, max (or "none" to clear)').option("--plan-mode <enabled>", "Run automation messages in plan mode (true/false)", parseBooleanOption).option("--goal-mode <enabled>", "Set automation messages as Codex goals (true/false)", parseBooleanOption).option("--fast-mode <enabled>", "Run automation messages in fast mode (true/false)", parseBooleanOption).action(async (id, options) => {
   try {
     await automationEditCommand(id, options);
   } catch (error) {

package/package.json

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