We're thrilled to announce Clueless v1.0.0, our first stable release! This major milestone brings a complete architectural overhaul, enhanced performance, and production-ready features for AI-powered meeting assistance.
🌟 Highlights
- Production-Ready Architecture: Complete rewrite with modular component architecture and state management
- Official OpenAI SDK Integration: Migrated to OpenAI Agents SDK for improved reliability
- Enhanced macOS Support: Native permissions handling for microphone and screen recording
- Real-time Data Persistence: Automatic conversation saving with live transcription storage
- Improved User Experience: Streamlined onboarding and cleaner interface
✨ New Features
OpenAI Agents SDK Integration
- Replaced custom WebSocket implementation with official
@openai/agents
and@openai/agents-realtime
SDKs - Improved connection stability and error handling
- Better TypeScript support with official type definitions
- Maintained dual-agent architecture (salesperson + customer coach)
macOS Permissions System
- Integrated
node-mac-permissions
for proper permission handling - Added microphone, screen recording, and camera permission management
- Context-isolated Electron implementation for enhanced security
- Visual permission status indicators in the UI
System Audio Capture
- Integrated
electron-audio-loopback
for reliable system audio capture - Eliminated dependency on Swift-based audio capture
- Cross-platform compatibility improvements
- Real-time audio level monitoring for both microphone and system audio
Data Persistence
- Automatic conversation session creation on call start
- Real-time transcript saving with 5-second intervals
- Comprehensive insight, topic, commitment, and action item tracking
- Call history with detailed conversation analysis
Developer Experience
- Mock data system for UI testing without API calls
- Comprehensive error handling and logging
- Build system improvements for NativePHP distribution
- GitHub Actions CI/CD pipeline fixes
🔧 Improvements
Architecture & Performance
- Component-Based Architecture: Migrated from monolithic
Main.vue
(1,558 lines) to 14+ modular components - State Management: Implemented 3 Pinia stores for business logic, settings, and OpenAI SDK management
- Memory Optimization: Fixed memory leaks in audio capture and WebSocket connections
- Build Performance: Optimized frontend asset building for production
User Interface
- Streamlined Navigation: Removed redundant navigation items and badges
- Modal Onboarding: Replaced dedicated onboarding page with inline modal
- Connection Status: Improved visual feedback with color-coded states
- Responsive Design: Enhanced mobile layout with proper card sizing
- Dark Mode: Consistent theming across all components
Security & Permissions
- Context Isolation: Implemented secure IPC communication for Electron
- Permission Handling: Graceful degradation when permissions are denied
- API Key Management: Secure storage with cache-based implementation
🐛 Bug Fixes
- Fixed duplicate template seeding on app startup
- Resolved npm optional dependencies issue in CI/CD pipeline
- Fixed conversation saving in RealtimeAgent v2
- Eliminated double scrollbar in main interface
- Fixed dropdown z-index issues with Teleport solution
- Resolved ESLint errors across the codebase
- Fixed Vite hot reload issues in production builds
- Corrected WebSocket parameter names for OpenAI API
💔 Breaking Changes
- Removed standalone
Onboarding.vue
page component (replaced with modal) - Removed
CheckOnboarding
middleware - Updated navigation routes to point to
/realtime-agent-v2
- Minimum macOS version requirement for system audio features
📦 Dependencies
- Added:
@openai/agents
(^0.0.12),@openai/agents-realtime
(^0.0.12) - Added:
electron-audio-loopback
(^1.0.5) - Added:
node-mac-permissions
(^2.5.0) - optional dependency - Updated: Vue to 3.5.13, Vite to 6.2.0, TypeScript to 5.2.2
🔄 Migration Guide
For users upgrading from pre-release versions:
- Clear application cache to ensure clean state
- Re-grant permissions for microphone and screen recording
- Update API keys through Settings if needed
- Existing conversations are preserved and compatible
🙏 Acknowledgments
Special thanks to all contributors and testers who helped make this stable release possible. This release includes contributions from both human developers and AI assistance through Claude.
📋 Technical Details
- 63 files changed with 9,445 additions and 2,296 deletions
- 30+ commits addressing various features and fixes
- Comprehensive test coverage for critical functionality
- Production-ready build pipeline with NativePHP
Download: Available for macOS (Intel and Apple Silicon)
Requirements: macOS 10.15+, 4GB RAM minimum
License: MIT with Commons Clause