axinstall 1.3.0 → 1.4.0

package/README.md

@@ -6,37 +6,30 @@ Install AI CLI agents (Claude Code, Codex, Gemini, etc.) in any environment.
 
 ```bash
 # Install Claude Code globally
-npx -y axinstall "claude"
+npx axinstall claude
+
+# Install multiple agents in one command
+npx axinstall claude codex gemini opencode copilot
 
 # Install with a specific package manager
-npx -y axinstall "claude" --with "npm"
+npx axinstall claude --with npm
 
 # Preview what would be installed (dry run)
-npx -y axinstall "claude" --dry-run
+npx axinstall claude --dry-run
+
+# Enable verbose output
+npx axinstall claude --verbose
 
 # List supported agents
-npx -y axinstall --list-agents
+npx axinstall --list-agents
 
 # Check installed agents and available package managers
-npx -y axinstall --status
-
-# Enable verbose output
-npx -y axinstall "claude" --verbose
+npx axinstall --status
 ```
 
-## Prerequisites
-
-- Node.js >=22.14.0
-- Use `pnpm dlx` (recommended) or `npx` (bundled with npm) for one-off runs
-- Examples assume a POSIX shell (sh/bash/zsh); adjust for PowerShell or CMD
+## Requirements
 
-By default, `axinstall` installs agents using **npm**. This means `npm` must be
-available unless you explicitly override the installer:
-
-- `--with <installer>` (e.g., `--with "pnpm"`)
-- `AXINSTALL_WITH=<installer>`
-
-Supported installers:
+axinstall needs at least one supported package manager available:
 
 - npm
 - pnpm
@@ -44,11 +37,6 @@ Supported installers:
 - yarn
 - Homebrew (`brew`)
 
-## Conventions
-
-- Prefer long flags in scripts (`--verbose` instead of `-v`)
-- Examples include explicit quoting for flag values and arguments
-
 ### Custom Paths
 
 Override the default binary lookup by setting environment variables:
@@ -61,59 +49,46 @@ 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 npm (default)
-npx -y axinstall "claude"
-npx -y axinstall "codex"
-npx -y axinstall "gemini"
+# 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
-npx -y axinstall "claude" --with "npm"
-npx -y axinstall "opencode" --with "brew"
+axinstall claude --with npm
+axinstall opencode --with brew
 
 # Install locally (not globally)
-npx -y axinstall "claude" --local
+axinstall claude --local
 ```
 
 ### Pipeline examples
 
 ```bash
 # Get list of agent CLI names
-npx -y axinstall --list-agents | tail -n +2 | cut -f1
+axinstall --list-agents | tail -n +2 | cut -f1
 
 # Find agents from a specific provider
-npx -y axinstall --list-agents | tail -n +2 | awk -F'\t' '$4 == "Anthropic" {print $1}'
+axinstall --list-agents | tail -n +2 | awk -F'\t' '$4 == "Anthropic" {print $1}'
 
 # Get available installers only
-npx -y axinstall --status --only "installers" | tail -n +2 | awk -F'\t' '$4 == "available" {print $2}'
+axinstall --status --only installers | tail -n +2 | awk -F'\t' '$4 == "available" {print $2}'
 
 # Count installed vs not found agents
-npx -y axinstall --status --only "agents" | tail -n +2 | cut -f4 | sort | uniq -c
-```
-
-## Output
-
-`--list-agents` prints a tab-separated header and rows with columns:
-
+axinstall --status --only agents | tail -n +2 | cut -f4 | sort | uniq -c
 ```
-CLI	NAME	PACKAGE	PROVIDER
-```
-
-`--status` prints a tab-separated header and rows with columns:
-
-```
-TYPE	ID	NAME	STATUS	VERSION	PROVIDER	PACKAGE
-```
-
-- `TYPE` values: `AGENT` | `INSTALLER`
-- `STATUS` values:
-  - for `AGENT`: `installed` | `not_found`
-  - for `INSTALLER`: `available` | `not_found`
-- `--only` values: `"all"` | `"agents"` | `"installers"`
 
 ## Agent Rule
 
@@ -124,9 +99,9 @@ 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 uses the
-requested package manager (via `--with` / `AXINSTALL_WITH`) and uses npm
-by default.
+Use `axinstall` to install AI CLI agents in any environment. It auto-detects
+the best available package manager (npm, pnpm, bun, yarn, brew) and handles
+the installation with a single command.
 ```
 
 ## License

package/dist/cli.js

@@ -36,6 +36,7 @@ const program = new Command()
     .addHelpText("after", `
 Examples:
   $ 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
@@ -56,12 +57,12 @@ Supported installers:
 // 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/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

@@ -30,7 +30,7 @@ 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 rawInstallerInput = options.with ?? process.env["AXINSTALL_WITH"];
@@ -40,12 +40,12 @@ export function handleInstall(agentCli, options) {
         console.error(`Available: ${INSTALLER_IDS.join(", ")}`);
         console.error("Try 'axinstall --help' for usage information.");
         process.exitCode = 1;
-        return;
+        return false;
     }
     const installer = getInstaller(requestedInstaller);
     if (!isInstallerAvailable(requestedInstaller)) {
         reportMissingInstaller(installer);
-        return;
+        return false;
     }
     // Validate local installation support
     if (options.local && !installer.localInstallArgs) {
@@ -56,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,
@@ -66,7 +66,7 @@ export function handleInstall(agentCli, options) {
     });
     if (options.dryRun) {
         console.log(result.command);
-        return;
+        return true;
     }
     if (result.ok) {
         if (options.verbose) {
@@ -86,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}`);
@@ -94,4 +94,5 @@ export function handleInstall(agentCli, options) {
         console.error(`Details: ${result.error.message}`);
     }
     process.exitCode = 1;
+    return false;
 }

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;
@@ -31,9 +31,14 @@ export function runCommand(agentCli, options) {
         printStatus(scopeInput);
         return;
     }
-    if (!agentCli) {
-        reportUsageError("Missing required argument 'agent' (or use --list-agents/--status).");
+    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,7 +2,7 @@
   "name": "axinstall",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Universal installer for AI CLI agents (defaults to npm)",
   "repository": {
     "type": "git",
@@ -69,21 +69,21 @@
   },
   "dependencies": {
     "@commander-js/extra-typings": "^14.0.0",
-    "axshared": "^4.0.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.10",
-    "@vitest/coverage-v8": "^4.0.17",
-    "eslint": "^9.39.2",
-    "eslint-config-axkit": "^1.1.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.82.1",
+    "knip": "^5.85.0",
     "prettier": "3.8.1",
-    "semantic-release": "^25.0.2",
+    "semantic-release": "^25.0.3",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.17"
+    "vitest": "^4.0.18"
   }
 }