evinjohnn/natively-cluely-ai-assistant v2.0.7

Natively v2.0.7

on GitHub

Summary

Version 2.0.7 is a substantial update focusing on deep stability, memory management, critical fallback mechanics, and brand-new stealth and pass-through capabilities.

What's New

• Multimodal Groq Support: Integrated meta-llama/llama-4-scout-17b-16e-instruct into the ecosystem to enable native, blazing-fast screenshot analysis capability.
• Mouse Passthrough Mode: Added a system-level global hotkey to seamlessly toggle mouse pass-through, allowing direct click-through interactions with any background window beneath the assistant.

Improvements

• Upgraded Model Roster: The baseline AI architecture now defaults to the leading-edge gpt-5.4-chat, gemini-3.1, and claude-sonnet-4-6.
• Model Rotation Engine: Fortified the 3-tier fallback mechanisms and auto-upgrade logic across all providers (Gemini, Claude, GPT, Groq) to guarantee absolute response generation reliability.
• Groq Token Expansion: Increased max completion tokens to 8192 (the API physical limit) to drastically improve full code generation output and prevent BadRequestError drops.
• Process Disguise Mapping: Enhanced stealth logic on Windows by contextually mapping macOS disguise names (e.g., automatically matching "Terminal" to "Command Prompt").
• SEO & Documentation: Deeply optimized the project README.md for search engines, injecting targeted keywords and detailed solution guides.

Fixes

• Permanent Hide Trap & Data Loss: Repaired a critical IPC routing vulnerability where hiding the UI permanently trapped the app in the background. This previously frustrated users into Force-Quitting, which triggered data corruption and wiped out stored API keys.
• Vector Database Corruption: Fixed a silent indexing failure in sqlite-vec where using mixed embeddings (like local Ollama 768-dim alongside OpenAI 1536-dim) would permanently drop data. We've provisioned strict, dimension-specific tables (vec_chunks_768, 1536, 3072).
• Punctured Fallbacks: Corrected Gemini generateWithVisionFallback chains to properly execute tier downgrades instead of silently failing.
• Groq Multimedia Drops: Fixed a frontend routing defect that was preventing Groq from handling image attachments.
• Opacity Flash Bug: Implemented a Windows "opacity shield" to resolve a 1-frame visual screen flash when pulling up stealth/protected windows.
• Passthrough & Shortcut Dead Zones: Fixed bugs where the passthrough hotkey became temporarily unresponsive when the main app "stole" OS focus, and ensured the transparent overlay securely resets itself after ending a meeting.

Technical

• Native Audio Loader: Bypassed restrictive POSIX-symlink resolutions by mapping absolute paths directly to .node binaries, successfully repairing persistent start-up crashes—especially on Windows Git Bash.
• Memory & Listener Leaks: Eradicated massive runtime memory leaks by clearing unbounded array loops in the disguise engine, aggressively detaching Rust/C++ libuv event emitters on audio stops, and cleanly destroying opacity timers upon window focus shifts.
• Boot Race Conditions: Patched application boot order crashes involving userData lookups resolving before Electron was explicitly ready.
• Complete Thread-Safety: Eliminated dangerous global variable mutations in fallback chains by migrating to strictly localized modelIdOverride parameters, securing API loops.
• Settings State Persistence: Installed fail-safes into the SettingsManager parser so invalid or manually corrupted configurations default gracefully rather than immediately crashing the boot sequence.
• Dynamic OS Icon Binding: Ensured .icns, .ico, and .png icons dynamically bind to their respective Darwin, win32, and Linux target platform payloads.

⚠️macOS Installation (Unsigned Build)

Download the correct architecture .zip or .dmg file for your device (Apple Silicon or Intel).

If you see "App is damaged":

• For .zip downloads:

  1. Move the app to your Applications folder.
  2. Open Terminal and run: xattr -cr /Applications/Natively.app

• For .dmg downloads:

  1. Open Terminal and run:

     xattr -cr ~/Downloads/Natively-2.0.7-arm64.dmg
     # Or for Intel Macs:
     xattr -cr ~/Downloads/Natively-2.0.7-x64.dmg

  2. Install the natively.dmg
  3. Open Terminal and run: xattr -cr /Applications/Natively.app

⚠️Windows Installation (Unsigned Build)

When running the installer on Windows, you might see a "Windows protected your PC" warning from Microsoft Defender SmartScreen saying it prevented an unrecognized app from starting.

Since this is an unsigned build, this is expected. You can safely ignore it by clicking More info and then Run anyway.