Quick Start

1. Install Bun

# macOS / Linux
curl -fsSL https://bun.sh/install | bash

# macOS (Homebrew)
brew install bun

# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

On minimal Linux images, if you see unzip is required, run apt update && apt install -y unzip first.

2. Install Dependencies and Configure

bun install
cp .env.example .env
# Edit .env with your API key

See Environment Variables for the full reference.

3. Start

macOS / Linux

./bin/autoabm                          # Interactive TUI mode
./bin/autoabm -p "your prompt here"    # Headless mode
./bin/autoabm --help                   # Show all options

Windows

Prerequisite: Git for Windows must be installed.

# PowerShell / cmd — call Bun directly
bun --env-file=.env ./src/entrypoints/cli.tsx

# Or run inside Git Bash
./bin/autoabm

4. Global Usage (Optional)

Add bin/ to your PATH to run from any directory. See Global Usage Guide:

export PATH="$HOME/path/to/autoabm/bin:$PATH"

5. Recovery Mode

If the Ink TUI has issues, use the fallback Recovery CLI mode:

CLAUDE_CODE_FORCE_RECOVERY_CLI=1 ./bin/autoabm