The enhanced version has all features (multi-window, app discovery, etc.)
No need for two separate scripts - one powerful tool is better.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major usability improvement making Peekaboo easier to use:
• Output path now optional - auto-generates timestamped files in /tmp
• Maintains full backward compatibility with existing scripts
• Unified documentation approach (single peekaboo.scpt references)
• Streamlined setup and examples in README
• Enhanced user experience while preserving power user features
Quick usage: osascript peekaboo.scpt "Safari"
Result: /tmp/peekaboo_20250522_143052.png
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
✨ Updated test suite for enhanced error messaging system:
🔍 Enhanced Messaging Tests:
• Validates error messages contain specific troubleshooting guidance
• Checks for "Common issues:" sections in errors
• Verifies bundle ID vs app name specific advice
• Tests structured success message format with emojis
• Validates contextual suggestions and tips
📊 Improved Test Reporting:
• Shows error types for failed tests (e.g., "App Resolution Error:")
• Displays first line of results for context
• Enhanced command test feedback (app counts, help validation)
• Better success/failure detection for new message formats
🎯 New Test Categories:
• Enhanced messaging validation tests
• Window mode error testing
• Bundle ID vs app name error differentiation
• Success message structure validation
📸 README Updates:
• Added banner image (assets/banner.png)
• Visual branding for GitHub display
🎪 Test Coverage Now Includes:
• Error message content validation
• Troubleshooting guidance verification
• Success message structure testing
• Enhanced context reporting
• Multi-window error scenarios
The test suite now validates that AI models receive clear,
actionable error messages with specific guidance for resolution.
🤖💥 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
✨ Comprehensive descriptive error handling for AI model clarity:
🎯 App Resolution Errors:
• Detailed guidance for bundle ID vs app name issues
• Specific suggestions based on identifier type
• Clear troubleshooting steps for common problems
🪟 Window-Specific Errors:
• No windows: Clear explanation + suggestions
• Inaccessible windows: Accessibility permission guidance
• Multi-window failures: Fallback mode suggestions
• Window enumeration context with counts
🔐 Permission Errors:
• Screen Recording permission with exact steps
• File permission issues with alternative paths
• Accessibility permission requirements
📸 Enhanced Success Messages:
• Detailed file information and context
• Mode descriptions (full screen, window, multi-window)
• Clear indication of what was captured
• Helpful context for multi-window results
🎪 Model-Friendly Output:
• Every error explains what went wrong AND how to fix it
• Success messages detail exactly what was accomplished
• Context always provided for AI model understanding
• Structured information for easy parsing
💡 Examples:
Error: "App 'Safari' has 3 window(s) but none are accessible.
This may require accessibility permissions..."
Success: "Multi-window capture successful\! Captured 2 windows...
💡 All windows captured with descriptive filenames."
🤖💥 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
✨ Complete rewrite of test suite with 8 test categories:
• 🎯 Basic functionality (Classic & Pro versions)
• 🎨 Format support (PNG, JPG, PDF)
• 🎪 Advanced Pro features (multi-window, discovery)
• 🔍 App discovery and window enumeration
• ⚠️ Error handling and edge cases
• 💪 Performance and stress testing
• 🔗 Integration workflows
• 🖥 System app compatibility
🎯 Features:
• 70+ individual test cases across all scenarios
• Multiple test modes: all, basic, advanced, errors, stress, quick
• Comprehensive help system with examples
• Detailed success/failure reporting with statistics
• File size validation and directory analysis
• Rapid-fire stress testing
• Integration workflow testing (discovery → screenshot)
• Enhanced error validation for edge cases
📊 Test Coverage:
• Both Peekaboo Classic and Pro versions
• All command-line options and flags
• Bundle ID vs app name resolution
• Multi-window capture with descriptive naming
• Deep directory creation and special characters
• Performance under rapid succession
• Memory and resource usage patterns
🎪 Usage Examples:
./test_peekaboo.sh quick # Essential tests
./test_peekaboo.sh stress --cleanup # Performance + cleanup
./test_peekaboo.sh all # Full comprehensive suite
This makes Peekaboo one of the most thoroughly tested screenshot
automation tools available\! 👀 → 📸 → 💾🤖💥 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
👀 → 📸 → 💾 — Peekaboo—screenshot got you\! Now you see it, now it's saved.
Features:
• 🎯 Two versions: Classic (simple) and Pro (advanced)
• 🚀 Unattended screenshot automation - zero interaction required
• 🎭 Multi-window capture with descriptive filenames
• 🔍 App discovery - list all running apps and windows
• 🎯 Smart app targeting - names OR bundle IDs
• 🎨 Multiple formats: PNG, JPG, PDF
• 🏗 Auto directory creation
• 💥 Enhanced error handling and logging
• 🪟 Window-specific capture modes (front window only)
• 📝 Comprehensive test suite included
Built in the style of terminator.scpt with modern enhancements.
Files:
- peekaboo.scpt: Classic version for simple screenshots
- peekaboo_enhanced.scpt: Pro version with multi-window support
- test_screenshotter.sh: Comprehensive test suite
- README.md: Punchy documentation with real-world examples
🤖💥 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
