@auroraflow/code 0.0.16 → 0.0.17

package/README.md

@@ -16,8 +16,7 @@ lib/               current MVP support modules
 
 ## Install
 
-Installing `@auroraflow/code` as a global npm package attempts to install/update the
-official Claude Code and Codex global commands:
+Install `@auroraflow/code` as a global npm package:
 
 ```bash
 npm install -g @auroraflow/code
@@ -26,12 +25,18 @@ npm install -g @auroraflow/code
 Aurora does not export `claude` or `codex` bins. The standalone `claude` and
 `codex` commands remain the official clients and keep their official behavior.
 Aurora only wraps them through `aurora-claude` and `aurora-codex`.
+Aurora does not auto-install official clients during package installation; this
+keeps `npm install -g @auroraflow/code` fast and avoids hiding npm/network
+failures inside postinstall.
 
 To install or update the official clients explicitly:
 
 ```bash
 aurora install-clients
 aurora update-clients
+aurora install codex
+aurora install claude
+aurora install all
 ```
 
 ## Commands
@@ -43,6 +48,8 @@ node bin/aurora.js
 node bin/aurora.js init
 node bin/aurora.js claude
 node bin/aurora.js codex
+node bin/aurora.js install codex
+node bin/aurora.js install claude
 node bin/aurora.js install-clients
 node bin/aurora.js update-clients
 node bin/aurora.js status
@@ -50,6 +57,8 @@ node bin/aurora.js status
 
 Running `aurora` without a subcommand opens an interactive client selector. Use
 Up/Down (or `j`/`k`) and Enter to launch Claude or Codex through Aurora.
+If the selected official client is missing, Aurora prompts to install that
+specific client before launch.
 
 The launcher stores shared local state under `~/.aurora` and starts a local
 sidecar at `127.0.0.1:17878`. Official clients talk to the sidecar; the sidecar

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auroraflow/code",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "type": "module",
   "description": "Aurora launcher and sidecar for official Codex and Claude Code clients.",
   "repository": {

package/packages/cli/src/index.js

@@ -1,7 +1,7 @@
 import { ensureLayout, readAccount, readState, writeAccount, writeState } from "../../state/src/index.js";
-import { officialClientStatuses, runClient, updateOfficialClients } from "../../clients/src/index.js";
+import { installOfficialClient, officialClientStatus, officialClientStatuses, runClient, updateOfficialClients } from "../../clients/src/index.js";
 import { ensureSidecarRunning, installSidecarService, sidecarServiceStatus, uninstallSidecarService } from "../../service/src/index.js";
-import { chooseClient, promptFields } from "../../../lib/prompt.js";
+import { chooseClient, promptChoice, promptFields } from "../../../lib/prompt.js";
 
 export async function runAuroraCLI(argv = process.argv.slice(2)) {
   await ensureLayout();
@@ -28,6 +28,9 @@ export async function runAuroraCLI(argv = process.argv.slice(2)) {
         officialClients: officialClientStatuses()
       }, null, 2));
       return;
+    case "install":
+      await installCommand(rest);
+      return;
     case "install-clients":
     case "install-official-clients":
     case "update-clients":
@@ -70,6 +73,26 @@ async function sidecarCommand(args) {
   }
 }
 
+async function installCommand(args) {
+  const target = args[0] ?? "";
+  switch (target) {
+    case "codex":
+    case "claude":
+      await installOfficialClient(target);
+      console.log(JSON.stringify({ officialClients: officialClientStatuses() }, null, 2));
+      return;
+    case "all":
+    case "clients":
+    case "official-clients":
+      await updateOfficialClients();
+      console.log(JSON.stringify({ officialClients: officialClientStatuses() }, null, 2));
+      return;
+    default:
+      console.error("Usage: aurora install [codex|claude|all]");
+      process.exit(1);
+  }
+}
+
 export async function runAuroraClaude(argv = process.argv.slice(2)) {
   await ensureLayout();
   await runClient("claude", argv);
@@ -86,9 +109,23 @@ async function startInteractive(args) {
     await init();
   }
   const client = await chooseClient();
+  await ensureOfficialClientForInteractive(client);
   await runClient(client, args);
 }
 
+async function ensureOfficialClientForInteractive(client) {
+  const status = officialClientStatus(client);
+  if (status?.installed) return;
+  const action = await promptChoice(`${status?.name ?? client} is not installed`, [
+    { label: `Install ${status?.name ?? client} now`, value: "install" },
+    { label: "Exit", value: "exit" }
+  ]);
+  if (action !== "install") {
+    throw new Error(`${status?.name ?? client} is required. Run: aurora install ${client}`);
+  }
+  await installOfficialClient(client);
+}
+
 async function init() {
   const existing = await readState();
   const account = await readAccount();
@@ -164,6 +201,9 @@ function usage(exitCode) {
   aurora init
   aurora claude [args...]
   aurora codex [args...]
+  aurora install codex
+  aurora install claude
+  aurora install all
   aurora install-clients
   aurora update-clients
   aurora status

package/packages/clients/src/index.js

@@ -84,8 +84,15 @@ export async function updateOfficialClients() {
 }
 
 export async function installOfficialClients() {
+  await installOfficialClient("claude");
+  await installOfficialClient("codex");
+}
+
+export async function installOfficialClient(client) {
+  const spec = OFFICIAL_CLIENTS[client];
+  if (!spec) throw new Error(`unknown official client: ${client}`);
   const npm = npmCommandSpec();
-  const args = ["install", "-g", "@anthropic-ai/claude-code@latest", "@openai/codex@latest"];
+  const args = ["install", "-g", `${spec.packageName}@latest`];
   await spawnAndWait(npm.command, [...npm.args, ...args], { ...process.env });
 }
 
@@ -93,12 +100,16 @@ export function isGlobalNpmLifecycle() {
   return process.env.npm_config_global === "true" || process.env.npm_config_location === "global";
 }
 
+export function officialClientStatus(client) {
+  return officialClientStatuses().find(status => status.id === client) ?? null;
+}
+
 function officialClientBin(client) {
   const spec = OFFICIAL_CLIENTS[client];
   if (!spec) throw new Error(`unknown official client: ${client}`);
   const bin = resolveOfficialClientBin(spec.binName);
   if (!bin) {
-    throw new Error(`${spec.name} is not installed. Run: aurora install-clients`);
+    throw new Error(`${spec.name} is not installed. Run: aurora install ${client}`);
   }
   return bin;
 }