Enhanced testing section to showcase the robust AI test suite:
New Testing Documentation:
• Highlighted 8 comprehensive AI vision analysis tests
• Added specific test mode examples (ai, advanced, basic, quick)
• Detailed AI test coverage breakdown
• Clear command examples for different testing scenarios
AI Test Coverage Highlights:
• One-step: Screenshot + AI analysis workflow
• Two-step: Analyze existing images separately
• Custom model specification and auto-detection
• Error handling: Invalid models, missing files, malformed commands
• Graceful degradation when Ollama/models unavailable
Testing Commands:
./test_peekaboo.sh ai # AI tests only
./test_peekaboo.sh advanced # Multi-window, discovery, AI
./test_peekaboo.sh all # Comprehensive suite
Perfect for developers wanting to validate AI functionality\!
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major new feature: Local AI vision analysis with Ollama integration
Features:
• One-step: Screenshot + AI analysis in single command
• Two-step: Analyze existing images separately
• Smart model auto-detection with priority ranking
• Simplified ollama run commands (no complex API calls)
• Comprehensive error handling and setup instructions
Priority models: qwen2.5vl:7b > llava:7b > llava-phi3:3.8b > minicpm-v:8b
Examples:
osascript peekaboo.scpt "Safari" --ask "What's on this page?"
osascript peekaboo.scpt analyze "/tmp/shot.png" "Any errors?"
Perfect for automated testing, QA, and visual verification\!
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Enhanced documentation to highlight new features:
• Added dedicated Smart Filenames section with examples
• Updated feature list with model-friendly naming & speed
• Enhanced examples throughout showing actual output filenames
• Updated "Why Peekaboo Rocks" with performance improvements
• Added specific timing details (0.3s, 0.2s, 0.1s delays)
• Emphasized automation and AI model compatibility
Now clearly communicates the value of recent optimizations\!
🤖 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>
👀 → 📸 → 💾 — 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>
