axinstall 1.2.0 → 1.4.0

package/README.md

@@ -8,12 +8,18 @@ Install AI CLI agents (Claude Code, Codex, Gemini, etc.) in any environment.
 # Install Claude Code globally
 npx axinstall claude
 
+# Install multiple agents in one command
+npx axinstall claude codex gemini opencode copilot
+
 # Install with a specific package manager
 npx axinstall claude --with npm
 
 # Preview what would be installed (dry run)
 npx axinstall claude --dry-run
 
+# Enable verbose output
+npx axinstall claude --verbose
+
 # List supported agents
 npx axinstall --list-agents
 
@@ -43,15 +49,22 @@ export AXINSTALL_YARN_PATH=/path/to/yarn
 export AXINSTALL_BREW_PATH=/path/to/brew
 ```
 
+Choose a default installer via environment variable:
+
+```bash
+export AXINSTALL_WITH=pnpm
+```
+
 ## Examples
 
 ### Install agents
 
 ```bash
-# Install using auto-detected package manager (pnpm > bun > yarn > npm > brew)
+# Install using auto-detected package manager (npm > pnpm > bun > yarn > brew)
 axinstall claude
 axinstall codex
 axinstall gemini
+axinstall claude codex gemini opencode copilot
 
 # Force a specific package manager
 axinstall claude --with npm
@@ -87,7 +100,7 @@ Add to your `CLAUDE.md` or `AGENTS.md`:
 Run `npx -y axinstall --help` to learn available options.
 
 Use `axinstall` to install AI CLI agents in any environment. It auto-detects
-the best available package manager (pnpm, bun, yarn, npm, brew) and handles
+the best available package manager (npm, pnpm, bun, yarn, brew) and handles
 the installation with a single command.
 ```
 

package/dist/cli.d.ts

@@ -3,6 +3,6 @@
  * axinstall - AI agent installation CLI.
  *
  * Installs CLI agents (Claude Code, Codex, Gemini, etc.) using
- * the best available package manager in the environment.
+ * npm by default (override via --with or AXINSTALL_WITH).
  */
 export {};

package/dist/cli.js

@@ -3,7 +3,7 @@
  * axinstall - AI agent installation CLI.
  *
  * Installs CLI agents (Claude Code, Codex, Gemini, etc.) using
- * the best available package manager in the environment.
+ * npm by default (override via --with or AXINSTALL_WITH).
  */
 import { Command } from "@commander-js/extra-typings";
 import { AGENT_CLIS } from "axshared";
@@ -31,33 +31,38 @@ const program = new Command()
     .showSuggestionAfterError()
     .option("--list-agents", "List supported agents")
     .option("--status", "Show installed agents and available package managers")
-    .option("--only <scope>", "Limit --status output (agents|installers). Default: all.")
+    .option("--only <scope>", "Limit --status output (all|agents|installers). Default: all.")
     .option("-v, --verbose", "Enable verbose output")
     .addHelpText("after", `
 Examples:
-  $ axinstall claude                              Install Claude Code globally
-  $ axinstall claude --local                      Install to node_modules/.bin
-  $ axinstall claude --with npm                   Use specific package manager
-  $ axinstall claude --dry-run                    Preview installation command
+  $ axinstall "claude"                              Install Claude Code globally
+  $ axinstall "claude" "codex" "gemini"            Install multiple agents sequentially
+  $ axinstall "claude" --local                      Install to node_modules/.bin
+  $ axinstall "claude" --with "npm"                 Use specific package manager
+  $ axinstall "claude" --dry-run                    Preview installation command
   $ axinstall --list-agents | tail -n +2 | cut -f1   List agent CLI names
-  $ axinstall --status --only installers | grep available  Show available installers
+  $ axinstall --status --only "installers" | grep available  Show available installers
 
 Environment:
-  AXINSTALL_WITH    Default package manager (${INSTALLER_NAMES})
+  AXINSTALL_WITH    Force package manager (${INSTALLER_NAMES})
 
-Requirements:
+Default:
+  npm (requires npm unless overridden)
+  To use pnpm/bun/yarn/brew, pass --with <installer> or set AXINSTALL_WITH=<installer>.
+
+Supported installers:
   ${INSTALLER_NAMES}
   Override paths: ${INSTALLER_ENV_VARS}`);
 // =============================================================================
 // Install / List / Status (Default)
 // =============================================================================
 program
-    .argument("[agent]", `Agent to install (${AGENT_CLIS.join(", ")})`)
+    .argument("[agents...]", `Agents to install (${AGENT_CLIS.join(", ")})`)
     .option("--with <installer>", `Package manager to use (${INSTALLER_IDS.join(", ")})`)
     .option("--local", "Install to node_modules/.bin (run via package runner)", false)
     .option("--dry-run", "Show command without executing", false)
-    .action((agentCli, cliOptions) => {
-    runCommand(agentCli, cliOptions);
+    .action((agentClis, cliOptions) => {
+    runCommand(agentClis, cliOptions);
 });
 // =============================================================================
 // Parse and Execute

package/dist/detect-agent.js

@@ -3,14 +3,14 @@
  *
  * Detects which AI agents are installed in the current environment.
  */
-import { execSync } from "node:child_process";
+import { execFileSync } from "node:child_process";
 import { getAllAgents } from "axshared";
 /**
  * Check if a single agent is installed by running `<cli> --version`.
  */
 function checkAgent(agent) {
     try {
-        const output = execSync(`${agent.cli} --version`, {
+        const output = execFileSync(agent.cli, ["--version"], {
             encoding: "utf8",
             stdio: ["pipe", "pipe", "pipe"],
         }).trim();

package/dist/detect-installer.d.ts

@@ -16,14 +16,14 @@ declare function checkAllInstallers(): InstallerCheckResult[];
  * Get all available installers.
  */
 declare function getAvailableInstallers(): Installer[];
-/**
- * Auto-detect the best available installer based on priority.
- *
- * Priority order: npm > pnpm > bun > yarn > brew
- */
-declare function detectBestInstaller(): Installer | undefined;
 /**
  * Check if a specific installer is available.
  */
 declare function isInstallerAvailable(id: InstallerId): boolean;
-export { checkInstaller, checkAllInstallers, getAvailableInstallers, detectBestInstaller, isInstallerAvailable, };
+/**
+ * Detect the best available installer based on `INSTALLER_PRIORITY`.
+ *
+ * Retained for library consumers; the CLI defaults to npm unless overridden.
+ */
+declare function detectBestInstaller(): Installer | undefined;
+export { checkInstaller, checkAllInstallers, getAvailableInstallers, isInstallerAvailable, detectBestInstaller, };

package/dist/detect-installer.js

@@ -46,24 +46,23 @@ function getAvailableInstallers() {
         .map((result) => result.installer);
 }
 /**
- * Auto-detect the best available installer based on priority.
+ * Check if a specific installer is available.
+ */
+function isInstallerAvailable(id) {
+    const installer = getInstaller(id);
+    return checkInstaller(installer).available;
+}
+/**
+ * Detect the best available installer based on `INSTALLER_PRIORITY`.
  *
- * Priority order: npm > pnpm > bun > yarn > brew
+ * Retained for library consumers; the CLI defaults to npm unless overridden.
  */
 function detectBestInstaller() {
-    const available = new Set(getAvailableInstallers().map((installer) => installer.id));
     for (const id of INSTALLER_PRIORITY) {
-        if (available.has(id)) {
-            return getInstaller(id);
-        }
+        if (!isInstallerAvailable(id))
+            continue;
+        return getInstaller(id);
     }
     return undefined;
 }
-/**
- * Check if a specific installer is available.
- */
-function isInstallerAvailable(id) {
-    const installer = getInstaller(id);
-    return checkInstaller(installer).available;
-}
-export { checkInstaller, checkAllInstallers, getAvailableInstallers, detectBestInstaller, isInstallerAvailable, };
+export { checkInstaller, checkAllInstallers, getAvailableInstallers, isInstallerAvailable, detectBestInstaller, };

package/dist/handle-install.d.ts

@@ -7,5 +7,5 @@ interface InstallOptions {
     dryRun: boolean;
     verbose?: boolean;
 }
-export declare function handleInstall(agentCli: string, options: InstallOptions): void;
+export declare function handleInstall(agentCli: string, options: InstallOptions): boolean;
 export {};

package/dist/handle-install.js

@@ -2,22 +2,24 @@
  * Agent installation handler.
  */
 import { AGENT_CLIS, getAgent, isValidAgentCli } from "axshared";
-import { detectBestInstaller, isInstallerAvailable, } from "./detect-installer.js";
+import { isInstallerAvailable } from "./detect-installer.js";
 import { executeInstall } from "./execute-install.js";
 import { getAllInstallers, getInstaller } from "./installer-data.js";
 import { resolveInstallerCommand } from "./resolve-installer-command.js";
 import { INSTALLER_IDS } from "./types.js";
 const INSTALLER_ID_SET = new Set(INSTALLER_IDS);
 const INSTALLER_NAMES = INSTALLER_IDS.join(", ");
-const INSTALLER_ENV_VARS = INSTALLER_IDS.map((id) => getInstaller(id).envVar).join(", ");
 function isInstallerId(value) {
     return INSTALLER_ID_SET.has(value);
 }
 function reportMissingInstaller(installer) {
     const command = resolveInstallerCommand(installer);
     console.error(`Error: Installer '${installer.id}' not available`);
-    console.error(`Looked for: ${command}`);
+    // Escape control characters/newlines from env-var-controlled paths without
+    // adding surrounding quotes.
+    console.error(`Looked for: ${JSON.stringify(command).slice(1, -1)}`);
     console.error(`Install ${installer.name} and try again.`);
+    console.error(`To use a different installer, pass --with <installer> (${INSTALLER_NAMES}) or set AXINSTALL_WITH=<installer>.`);
     console.error(`Override path: ${installer.envVar}=/path/to/${installer.command}`);
     console.error(`Run 'axinstall --status --only installers' to verify availability.`);
     process.exitCode = 1;
@@ -28,35 +30,22 @@ export function handleInstall(agentCli, options) {
         console.error(`Available: ${AGENT_CLIS.join(", ")}`);
         console.error("Try 'axinstall --help' for usage information.");
         process.exitCode = 1;
-        return;
+        return false;
     }
     const agent = getAgent(agentCli);
-    const requestedInstaller = options.with ?? process.env["AXINSTALL_WITH"];
-    let installer;
-    if (requestedInstaller) {
-        if (!isInstallerId(requestedInstaller)) {
-            console.error(`Error: Unknown installer '${requestedInstaller}'`);
-            console.error(`Available: ${INSTALLER_IDS.join(", ")}`);
-            console.error("Try 'axinstall --help' for usage information.");
-            process.exitCode = 1;
-            return;
-        }
-        installer = getInstaller(requestedInstaller);
-        if (!isInstallerAvailable(requestedInstaller)) {
-            reportMissingInstaller(installer);
-            return;
-        }
+    const rawInstallerInput = options.with ?? process.env["AXINSTALL_WITH"];
+    const requestedInstaller = rawInstallerInput?.trim() || "npm";
+    if (!isInstallerId(requestedInstaller)) {
+        console.error(`Error: Unknown installer '${requestedInstaller}'`);
+        console.error(`Available: ${INSTALLER_IDS.join(", ")}`);
+        console.error("Try 'axinstall --help' for usage information.");
+        process.exitCode = 1;
+        return false;
     }
-    else {
-        installer = detectBestInstaller();
-        if (!installer) {
-            console.error("Error: No package manager found");
-            console.error(`Install ${INSTALLER_NAMES} and try again.`);
-            console.error(`Override paths: ${INSTALLER_ENV_VARS}`);
-            console.error("Run 'axinstall --status --only installers' to verify availability.");
-            process.exitCode = 1;
-            return;
-        }
+    const installer = getInstaller(requestedInstaller);
+    if (!isInstallerAvailable(requestedInstaller)) {
+        reportMissingInstaller(installer);
+        return false;
     }
     // Validate local installation support
     if (options.local && !installer.localInstallArgs) {
@@ -67,7 +56,7 @@ export function handleInstall(agentCli, options) {
         console.error(`Error: Installer '${installer.id}' does not support local installation`);
         console.error(`Use a different installer: ${localInstallers}`);
         process.exitCode = 1;
-        return;
+        return false;
     }
     const result = executeInstall({
         agent,
@@ -77,7 +66,7 @@ export function handleInstall(agentCli, options) {
     });
     if (options.dryRun) {
         console.log(result.command);
-        return;
+        return true;
     }
     if (result.ok) {
         if (options.verbose) {
@@ -97,7 +86,7 @@ export function handleInstall(agentCli, options) {
                 console.error(`Run '${agent.cli}' to get started.`);
             }
         }
-        return;
+        return true;
     }
     console.error(`Error: Failed to install ${agent.name}`);
     console.error(`Command: ${result.command}`);
@@ -105,4 +94,5 @@ export function handleInstall(agentCli, options) {
         console.error(`Details: ${result.error.message}`);
     }
     process.exitCode = 1;
+    return false;
 }

package/dist/index.d.ts

@@ -5,8 +5,9 @@
  */
 export { INSTALLER_IDS } from "./types.js";
 export type { Installer, InstallerId, InstallerCheckResult } from "./types.js";
-export { getInstaller, getAllInstallers, INSTALLERS, INSTALLER_PRIORITY, } from "./installer-data.js";
-export { checkInstaller, checkAllInstallers, getAvailableInstallers, detectBestInstaller, isInstallerAvailable, } from "./detect-installer.js";
+export { getInstaller, getAllInstallers, INSTALLERS, } from "./installer-data.js";
+export { checkInstaller, checkAllInstallers, detectBestInstaller, getAvailableInstallers, isInstallerAvailable, } from "./detect-installer.js";
+export { INSTALLER_PRIORITY } from "./installer-data.js";
 export { checkAgent, checkAllAgents, getInstalledAgents, } from "./detect-agent.js";
 export type { AgentCheckResult } from "./detect-agent.js";
 export { buildInstallCommand, executeInstall } from "./execute-install.js";

package/dist/index.js

@@ -6,9 +6,10 @@
 // Types
 export { INSTALLER_IDS } from "./types.js";
 // Installer data
-export { getInstaller, getAllInstallers, INSTALLERS, INSTALLER_PRIORITY, } from "./installer-data.js";
+export { getInstaller, getAllInstallers, INSTALLERS, } from "./installer-data.js";
 // Installer detection
-export { checkInstaller, checkAllInstallers, getAvailableInstallers, detectBestInstaller, isInstallerAvailable, } from "./detect-installer.js";
+export { checkInstaller, checkAllInstallers, detectBestInstaller, getAvailableInstallers, isInstallerAvailable, } from "./detect-installer.js";
+export { INSTALLER_PRIORITY } from "./installer-data.js";
 // Agent detection
 export { checkAgent, checkAllAgents, getInstalledAgents, } from "./detect-agent.js";
 // Installation

package/dist/installer-data.d.ts

@@ -2,10 +2,19 @@
  * Installer definitions and metadata.
  */
 import type { Installer, InstallerId } from "./types.js";
+/**
+ * Installer preference order used by `detectBestInstaller()` (library API).
+ *
+ * The CLI defaults to npm by design; this list is retained for programmatic
+ * consumers who want auto-detection.
+ *
+ * Note: Keep this order stable unless intentionally making a behavior change
+ * for library consumers.
+ */
+declare const INSTALLER_PRIORITY: readonly InstallerId[];
 /** All installers indexed by ID */
 declare const INSTALLERS: Record<InstallerId, Installer>;
-/** Default priority order for auto-detection */
-declare const INSTALLER_PRIORITY: readonly InstallerId[];
 declare function getInstaller(id: InstallerId): Installer;
 declare function getAllInstallers(): Installer[];
-export { getInstaller, getAllInstallers, INSTALLERS, INSTALLER_PRIORITY };
+export { getInstaller, getAllInstallers, INSTALLERS };
+export { INSTALLER_PRIORITY };

package/dist/installer-data.js

@@ -1,6 +1,22 @@
 /**
  * Installer definitions and metadata.
  */
+/**
+ * Installer preference order used by `detectBestInstaller()` (library API).
+ *
+ * The CLI defaults to npm by design; this list is retained for programmatic
+ * consumers who want auto-detection.
+ *
+ * Note: Keep this order stable unless intentionally making a behavior change
+ * for library consumers.
+ */
+const INSTALLER_PRIORITY = [
+    "npm",
+    "pnpm",
+    "bun",
+    "yarn",
+    "brew",
+];
 const npm = {
     id: "npm",
     name: "npm",
@@ -54,18 +70,11 @@ const INSTALLERS = {
     yarn,
     brew,
 };
-/** Default priority order for auto-detection */
-const INSTALLER_PRIORITY = [
-    "npm",
-    "pnpm",
-    "bun",
-    "yarn",
-    "brew",
-];
 function getInstaller(id) {
     return INSTALLERS[id];
 }
 function getAllInstallers() {
     return Object.values(INSTALLERS);
 }
-export { getInstaller, getAllInstallers, INSTALLERS, INSTALLER_PRIORITY };
+export { getInstaller, getAllInstallers, INSTALLERS };
+export { INSTALLER_PRIORITY };

package/dist/resolve-installer-command.js

@@ -1,5 +1,6 @@
 function resolveInstallerCommand(installer) {
     const override = process.env[installer.envVar];
-    return override && override.length > 0 ? override : installer.command;
+    const trimmedOverride = override?.trim();
+    return trimmedOverride || installer.command;
 }
 export { resolveInstallerCommand };

package/dist/run-command.d.ts

@@ -10,4 +10,4 @@ export interface CliOptions {
     local: boolean;
     dryRun: boolean;
 }
-export declare function runCommand(agentCli: string | undefined, options: CliOptions): void;
+export declare function runCommand(agentClis: string[] | undefined, options: CliOptions): void;

package/dist/run-command.js

@@ -6,14 +6,14 @@ import { isStatusScope, printStatus, printSupportedAgents, } from "./print-statu
 import { validateOptions } from "./validate-cli-options.js";
 function reportUsageError(message) {
     console.error(`Error: ${message}`);
-    console.error("Usage: axinstall [options] <agent>");
+    console.error("Usage: axinstall [options] [agents...]");
     console.error("       axinstall --list-agents");
     console.error("       axinstall --status [--only <scope>]");
     console.error("Try 'axinstall --help' for usage information.");
     process.exitCode = 1;
 }
-export function runCommand(agentCli, options) {
-    const validation = validateOptions(agentCli, options);
+export function runCommand(agentClis, options) {
+    const validation = validateOptions(agentClis, options);
     if (!validation.valid) {
         reportUsageError(validation.message);
         return;
@@ -25,15 +25,20 @@ export function runCommand(agentCli, options) {
     if (options.status) {
         const scopeInput = options.only?.toLowerCase() ?? "all";
         if (!isStatusScope(scopeInput)) {
-            reportUsageError(`Invalid --only value '${options.only}'. Use agents or installers.`);
+            reportUsageError(`Invalid --only value '${options.only}'. Use all, agents, or installers.`);
             return;
         }
         printStatus(scopeInput);
         return;
     }
-    if (!agentCli) {
-        reportUsageError("Missing required argument 'agent'.");
+    if (!agentClis || agentClis.length === 0) {
+        reportUsageError("Missing required argument 'agent(s)' (or use --list-agents/--status).");
         return;
     }
-    handleInstall(agentCli, options);
+    for (const agentCli of agentClis) {
+        const installOk = handleInstall(agentCli, options);
+        if (!installOk) {
+            return;
+        }
+    }
 }

package/dist/validate-cli-options.d.ts

@@ -10,5 +10,5 @@ type ValidationSuccess = {
     valid: true;
 };
 type ValidationResult = ValidationError | ValidationSuccess;
-export declare function validateOptions(agentCli: string | undefined, options: CliOptions): ValidationResult;
+export declare function validateOptions(agentClis: string[] | undefined, options: CliOptions): ValidationResult;
 export {};

package/dist/validate-cli-options.js

@@ -1,17 +1,18 @@
 /**
  * CLI option validation.
  */
-export function validateOptions(agentCli, options) {
+export function validateOptions(agentClis, options) {
+    const hasAgentArguments = Boolean(agentClis && agentClis.length > 0);
     if (options.listAgents && options.status) {
         return {
             valid: false,
             message: "Use either --list-agents or --status, not both.",
         };
     }
-    if ((options.listAgents || options.status) && agentCli) {
+    if ((options.listAgents || options.status) && hasAgentArguments) {
         return {
             valid: false,
-            message: "Do not pass an agent when using --list-agents or --status.",
+            message: "Do not pass agents when using --list-agents or --status.",
         };
     }
     if ((options.listAgents || options.status) && options.with) {

package/package.json

@@ -2,8 +2,8 @@
   "name": "axinstall",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.2.0",
-  "description": "Universal installer for AI CLI agents with automatic package manager detection",
+  "version": "1.4.0",
+  "description": "Universal installer for AI CLI agents (defaults to npm)",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Jercik/axinstall.git"
@@ -63,27 +63,27 @@
     "automation",
     "coding-assistant"
   ],
-  "packageManager": "pnpm@10.27.0",
+  "packageManager": "pnpm@10.28.1",
   "engines": {
     "node": ">=22.14.0"
   },
   "dependencies": {
     "@commander-js/extra-typings": "^14.0.0",
-    "axshared": "^1.8.0",
-    "commander": "^14.0.2"
+    "axshared": "^5.0.0",
+    "commander": "^14.0.3"
   },
   "devDependencies": {
     "@total-typescript/ts-reset": "^0.6.1",
-    "@types/node": "^25.0.3",
-    "@vitest/coverage-v8": "^4.0.16",
-    "eslint": "^9.39.2",
-    "eslint-config-axkit": "^1.0.0",
+    "@types/node": "^25.3.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^10.0.1",
+    "eslint-config-axkit": "^1.2.1",
     "fta-check": "^1.5.1",
     "fta-cli": "^3.0.0",
-    "knip": "^5.80.0",
-    "prettier": "3.7.4",
-    "semantic-release": "^25.0.2",
+    "knip": "^5.85.0",
+    "prettier": "3.8.1",
+    "semantic-release": "^25.0.3",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
+    "vitest": "^4.0.18"
   }
 }