axinstall

Install AI CLI agents (Claude Code, Codex, Gemini, etc.) in any environment.

Quick Start

# Install Claude Code globally
npx axinstall claude

# Install with a specific package manager
npx axinstall claude --with npm

# Preview what would be installed (dry run)
npx axinstall claude --dry-run

# List supported agents
npx axinstall --list-agents

# Check installed agents and available package managers
npx axinstall --status

Requirements

axinstall needs at least one supported package manager available:

npm
pnpm
bun
yarn
Homebrew (brew)

Custom Paths

Override the default binary lookup by setting environment variables:

export AXINSTALL_NPM_PATH=/path/to/npm
export AXINSTALL_PNPM_PATH=/path/to/pnpm
export AXINSTALL_BUN_PATH=/path/to/bun
export AXINSTALL_YARN_PATH=/path/to/yarn
export AXINSTALL_BREW_PATH=/path/to/brew

Examples

Install agents

# Install using auto-detected package manager (pnpm > bun > yarn > npm > brew)
axinstall claude
axinstall codex
axinstall gemini

# Force a specific package manager
axinstall claude --with npm
axinstall opencode --with brew

# Install locally (not globally)
axinstall claude --local

Pipeline examples

# Get list of agent CLI names
axinstall --list-agents | tail -n +2 | cut -f1

# Find agents from a specific provider
axinstall --list-agents | tail -n +2 | awk -F'\t' '$4 == "Anthropic" {print $1}'

# Get available installers only
axinstall --status --only installers | tail -n +2 | awk -F'\t' '$4 == "available" {print $2}'

# Count installed vs not found agents
axinstall --status --only agents | tail -n +2 | cut -f4 | sort | uniq -c

Agent Rule

Add to your CLAUDE.md or AGENTS.md:

# Rule: `axinstall` Usage

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 installation with a single command.

License

MIT