Repository navigation
APM Framework v4.0.3 - Critical Installer TTY Fix
🔧 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/ttyfor piped installations - Main installer's
safe_read()function was trying to access/dev/ttydirectly 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 --defaultsManual 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.