Skip to content

APM Framework v4.0.3 - Critical Installer TTY Fix

Choose a tag to compare

@omayhemo omayhemo released this 13 Aug 21:48
· 34 commits to master since this release

🔧 APM Framework v4.0.3 - Critical Installer TTY Fix

Critical Hotfix: Fixed installer hanging at Step 2 (Project Configuration) when installed via curl | bash.

🚨 What Was Fixed

The Problem: When running the interactive installer via curl | bash (without --defaults), the installer would hang at Step 2 waiting for project name input.

The Root Cause:

  • Universal installer redirects stdin from /dev/tty for piped installations
  • Main installer's safe_read() function was trying to access /dev/tty directly again
  • This created a conflict causing the installer to hang when requesting user input

The Solution: Enhanced TTY detection logic to check if stdin is already redirected before accessing /dev/tty.

🔧 Fixed

  • CRITICAL: Fixed installer hanging at Step 2 when piped through curl
  • Fixed TTY detection logic causing conflicts between universal installer and main installer
  • Installer now properly handles stdin redirection from /dev/tty
  • Fixed safe_read() function to use stdin when already redirected by universal installer

🚀 Improved

  • Enhanced TTY detection to prevent hanging when piped through curl
  • Better handling of interactive vs non-interactive installation modes
  • Improved installer reliability in various shell environments

🎯 Impact for Users

✅ Now Working (v4.0.3):

Interactive installation proceeds smoothly:

curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash
  • Prompts for project name ✅
  • Continues through all installation steps ✅
  • No hanging at project configuration ✅

❌ Previously Broken (v4.0.2):

Step 2: Project Configuration
-----------------------------
[HANGS INDEFINITELY]

🚀 Installation

Quick Install (30 seconds)

# Interactive installation (NOW WORKS!)
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash

# Non-interactive installation with defaults
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --defaults

# With TTS voice notifications
curl -fsSL https://raw.githubusercontent.com/omayhemo/APM/master/install.sh | bash -s -- --with-tts --defaults

Manual Installation

# Download and extract
wget https://github.com/omayhemo/APM/releases/download/v4.0.3/apm-v4.0.3.tar.gz
tar -xzf apm-v4.0.3.tar.gz
cd apm-v4.0.3

# Install
./installer/install.sh

🛠️ Requirements

  • Claude Code (Claude Desktop CLI) - Required
  • Linux, macOS, or WSL
  • 2GB free space
  • Git (optional, for version control)

📚 Documentation

After installation, comprehensive documentation is available at:

  • .apm/README.md - Complete documentation index
  • .apm/documentation/ - All guides and references

⚡ Key Features

  • 4-8x Faster Development - Native parallel execution
  • 9 Expert AI Agents - Each specialized in their domain
  • 85+ Commands - Complete development lifecycle coverage
  • Zero Setup Time - Working team in under 5 minutes
  • Production Ready - Used by teams shipping real products
  • ✅ Reliable Installation - Both interactive and non-interactive modes work flawlessly

Ready to revolutionize your development workflow? Install APM and experience the power of parallel AI agents working as your team.