axinstall 1.0.0 → 1.2.0

package/dist/cli.js

@@ -35,7 +35,8 @@ const program = new Command()
     .option("-v, --verbose", "Enable verbose output")
     .addHelpText("after", `
 Examples:
-  $ axinstall claude                              Install Claude Code
+  $ 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 --list-agents | tail -n +2 | cut -f1   List agent CLI names
@@ -53,8 +54,8 @@ Requirements:
 program
     .argument("[agent]", `Agent 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)
-    .option("--local", "Install locally instead of globally", false)
     .action((agentCli, cliOptions) => {
     runCommand(agentCli, cliOptions);
 });

package/dist/detect-installer.d.ts

@@ -19,7 +19,7 @@ declare function getAvailableInstallers(): Installer[];
 /**
  * Auto-detect the best available installer based on priority.
  *
- * Priority order: pnpm > bun > yarn > npm > brew
+ * Priority order: npm > pnpm > bun > yarn > brew
  */
 declare function detectBestInstaller(): Installer | undefined;
 /**

package/dist/detect-installer.js

@@ -48,7 +48,7 @@ function getAvailableInstallers() {
 /**
  * Auto-detect the best available installer based on priority.
  *
- * Priority order: pnpm > bun > yarn > npm > brew
+ * Priority order: npm > pnpm > bun > yarn > brew
  */
 function detectBestInstaller() {
     const available = new Set(getAvailableInstallers().map((installer) => installer.id));

package/dist/execute-install.d.ts

@@ -6,7 +6,8 @@ import type { Installer } from "./types.js";
 interface InstallOptions {
     agent: Agent;
     installer: Installer;
-    global: boolean;
+    /** Install locally instead of globally. Defaults to false. */
+    local?: boolean;
     dryRun: boolean;
 }
 interface InstallResult {

package/dist/execute-install.js

@@ -5,15 +5,22 @@ import { execFileSync } from "node:child_process";
 import { resolveInstallerCommand } from "./resolve-installer-command.js";
 /**
  * Build the installation arguments for an agent.
+ *
+ * @throws {Error} If local install is requested but the installer doesn't support it.
  */
 function buildInstallArguments(options) {
-    const { agent, installer, global: isGlobal } = options;
+    const { agent, installer, local } = options;
     // For brew, use the CLI name as the package name (formula name)
     // For npm-based installers, use the npm package name
     const packageName = installer.id === "brew" ? agent.cli : agent.package;
-    const installArguments = isGlobal
-        ? installer.globalInstallArgs
-        : installer.localInstallArgs;
+    // Reject local installs when the installer doesn't support them
+    if (local) {
+        if (!installer.localInstallArgs) {
+            throw new Error(`Installer '${installer.id}' does not support local installation`);
+        }
+        return installer.localInstallArgs.map((argument) => argument.replace("{package}", packageName));
+    }
+    const installArguments = installer.installArgs;
     return installArguments.map((argument) => argument.replace("{package}", packageName));
 }
 function formatCommand(command, arguments_) {
@@ -32,7 +39,19 @@ function buildInstallCommand(options) {
  */
 function executeInstall(options) {
     const command = resolveInstallerCommand(options.installer);
-    const arguments_ = buildInstallArguments(options);
+    // Wrap argument building to catch validation errors and return InstallOutcome
+    let arguments_;
+    try {
+        arguments_ = buildInstallArguments(options);
+    }
+    catch (error) {
+        const localFlag = options.local ? " (local)" : "";
+        return {
+            ok: false,
+            command: `${options.installer.id}${localFlag}: ${command} ...`,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
     const displayCommand = formatCommand(command, arguments_);
     if (options.dryRun) {
         return { ok: true, command: displayCommand };

package/dist/handle-install.d.ts

@@ -3,8 +3,8 @@
  */
 interface InstallOptions {
     with?: string;
-    dryRun: boolean;
     local: boolean;
+    dryRun: boolean;
     verbose?: boolean;
 }
 export declare function handleInstall(agentCli: string, options: InstallOptions): void;

package/dist/handle-install.js

@@ -4,7 +4,7 @@
 import { AGENT_CLIS, getAgent, isValidAgentCli } from "axshared";
 import { detectBestInstaller, isInstallerAvailable, } from "./detect-installer.js";
 import { executeInstall } from "./execute-install.js";
-import { getInstaller } from "./installer-data.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);
@@ -58,11 +58,21 @@ export function handleInstall(agentCli, options) {
             return;
         }
     }
-    const isGlobal = !options.local;
+    // Validate local installation support
+    if (options.local && !installer.localInstallArgs) {
+        const localInstallers = getAllInstallers()
+            .filter((installer_) => installer_.localInstallArgs)
+            .map((installer_) => installer_.id)
+            .join(", ");
+        console.error(`Error: Installer '${installer.id}' does not support local installation`);
+        console.error(`Use a different installer: ${localInstallers}`);
+        process.exitCode = 1;
+        return;
+    }
     const result = executeInstall({
         agent,
         installer,
-        global: isGlobal,
+        local: options.local,
         dryRun: options.dryRun,
     });
     if (options.dryRun) {
@@ -72,11 +82,27 @@ export function handleInstall(agentCli, options) {
     if (result.ok) {
         if (options.verbose) {
             console.error(`Successfully installed ${agent.name}.`);
-            console.error(`Run '${agent.cli}' to get started.`);
+            if (options.local) {
+                // Suggest the appropriate runner for the installer used
+                const runnerCommands = {
+                    npm: `npx ${agent.cli}`,
+                    pnpm: `pnpm exec ${agent.cli}`,
+                    bun: `bunx ${agent.cli}`,
+                    yarn: `yarn run ${agent.cli}`,
+                    brew: agent.cli, // brew installs globally
+                };
+                console.error(`Run '${runnerCommands[installer.id]}' to get started.`);
+            }
+            else {
+                console.error(`Run '${agent.cli}' to get started.`);
+            }
         }
         return;
     }
     console.error(`Error: Failed to install ${agent.name}`);
     console.error(`Command: ${result.command}`);
+    if (result.error.message) {
+        console.error(`Details: ${result.error.message}`);
+    }
     process.exitCode = 1;
 }

package/dist/installer-data.js

@@ -7,7 +7,7 @@ const npm = {
     command: "npm",
     envVar: "AXINSTALL_NPM_PATH",
     checkArgs: ["--version"],
-    globalInstallArgs: ["install", "-g", "{package}"],
+    installArgs: ["install", "-g", "{package}"],
     localInstallArgs: ["install", "{package}"],
 };
 const pnpm = {
@@ -16,7 +16,7 @@ const pnpm = {
     command: "pnpm",
     envVar: "AXINSTALL_PNPM_PATH",
     checkArgs: ["--version"],
-    globalInstallArgs: ["add", "-g", "{package}"],
+    installArgs: ["add", "-g", "{package}"],
     localInstallArgs: ["add", "{package}"],
 };
 const bun = {
@@ -25,7 +25,7 @@ const bun = {
     command: "bun",
     envVar: "AXINSTALL_BUN_PATH",
     checkArgs: ["--version"],
-    globalInstallArgs: ["add", "-g", "{package}"],
+    installArgs: ["add", "-g", "{package}"],
     localInstallArgs: ["add", "{package}"],
 };
 const yarn = {
@@ -34,7 +34,7 @@ const yarn = {
     command: "yarn",
     envVar: "AXINSTALL_YARN_PATH",
     checkArgs: ["--version"],
-    globalInstallArgs: ["global", "add", "{package}"],
+    installArgs: ["global", "add", "{package}"],
     localInstallArgs: ["add", "{package}"],
 };
 const brew = {
@@ -43,8 +43,8 @@ const brew = {
     command: "brew",
     envVar: "AXINSTALL_BREW_PATH",
     checkArgs: ["--version"],
-    globalInstallArgs: ["install", "{package}"],
-    localInstallArgs: ["install", "{package}"],
+    installArgs: ["install", "{package}"],
+    // No localInstallArgs - brew only installs globally
 };
 /** All installers indexed by ID */
 const INSTALLERS = {
@@ -56,10 +56,10 @@ const INSTALLERS = {
 };
 /** Default priority order for auto-detection */
 const INSTALLER_PRIORITY = [
+    "npm",
     "pnpm",
     "bun",
     "yarn",
-    "npm",
     "brew",
 ];
 function getInstaller(id) {

package/dist/run-command.d.ts

@@ -7,7 +7,7 @@ export interface CliOptions {
     only?: string;
     verbose?: boolean;
     with?: string;
-    dryRun: boolean;
     local: boolean;
+    dryRun: boolean;
 }
 export declare function runCommand(agentCli: string | undefined, options: CliOptions): void;

package/dist/types.d.ts

@@ -15,9 +15,9 @@ interface Installer {
     /** Args for a version check. */
     checkArgs: readonly string[];
     /** Args for global install. Use {package} as placeholder. */
-    globalInstallArgs: readonly string[];
-    /** Args for local install. Use {package} as placeholder. */
-    localInstallArgs: readonly string[];
+    installArgs: readonly string[];
+    /** Args for local install. Use {package} as placeholder. Undefined if not supported. */
+    localInstallArgs?: readonly string[];
 }
 /** Result of checking installer availability */
 interface InstallerCheckResult {

package/dist/validate-cli-options.js

@@ -20,16 +20,16 @@ export function validateOptions(agentCli, options) {
             message: "--with is only valid when installing an agent.",
         };
     }
-    if ((options.listAgents || options.status) && options.local) {
+    if ((options.listAgents || options.status) && options.dryRun) {
         return {
             valid: false,
-            message: "--local is only valid when installing an agent.",
+            message: "--dry-run is only valid when installing an agent.",
         };
     }
-    if ((options.listAgents || options.status) && options.dryRun) {
+    if ((options.listAgents || options.status) && options.local) {
         return {
             valid: false,
-            message: "--dry-run is only valid when installing an agent.",
+            message: "--local is only valid when installing an agent.",
         };
     }
     if (options.only && !options.status) {

package/package.json

@@ -2,7 +2,7 @@
   "name": "axinstall",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Universal installer for AI CLI agents with automatic package manager detection",
   "repository": {
     "type": "git",
@@ -43,9 +43,9 @@
     "rebuild": "pnpm run clean && pnpm run build",
     "start": "pnpm -s run rebuild && node bin/axinstall",
     "test": "vitest run --exclude '**/*.integration.test.ts'",
+    "test:all": "vitest run --testTimeout=300000",
     "test:coverage": "vitest run --coverage --exclude '**/*.integration.test.ts'",
     "test:integration": "vitest run --testTimeout=300000 src/docker-install.integration.test.ts",
-    "test:all": "vitest run --testTimeout=300000",
     "test:watch": "vitest --exclude '**/*.integration.test.ts'",
     "typecheck": "tsc -b --noEmit"
   },
@@ -63,33 +63,27 @@
     "automation",
     "coding-assistant"
   ],
-  "packageManager": "pnpm@10.26.1",
+  "packageManager": "pnpm@10.27.0",
   "engines": {
     "node": ">=22.14.0"
   },
   "dependencies": {
     "@commander-js/extra-typings": "^14.0.0",
-    "axshared": "^1.1.0",
+    "axshared": "^1.8.0",
     "commander": "^14.0.2"
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.0",
-    "@eslint/js": "^9.39.2",
     "@total-typescript/ts-reset": "^0.6.1",
     "@types/node": "^25.0.3",
     "@vitest/coverage-v8": "^4.0.16",
-    "@vitest/eslint-plugin": "^1.5.4",
     "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-unicorn": "^62.0.0",
+    "eslint-config-axkit": "^1.0.0",
     "fta-check": "^1.5.1",
     "fta-cli": "^3.0.0",
-    "globals": "^16.5.0",
-    "knip": "^5.76.1",
+    "knip": "^5.80.0",
     "prettier": "3.7.4",
     "semantic-release": "^25.0.2",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.0",
     "vitest": "^4.0.16"
   }
 }