Natively v2.0.8

[evinjohnn]

Summary

Version 2.08 introduces major advancements in stealth routing, Mouse Passthrough Mode, Multimodal Groq support, and resolves critical bugs to ensure a seamless workflow.

What's New

• Multimodal Groq Support: Integrated meta-llama/llama-4-scout-17b-16e-instruct into the ecosystem for high-speed screenshot analysis capability.
• Mouse Passthrough Mode: Merged backend Electron mouse event management with full state-sync between the global keybind manager and the React renderer interface.
• Updated Baseline Model Roster: Updated default architecture models to utilize the latest generation gpt-5.4-chat, gemini-3.1, and claude-sonnet-4-6.

Improvements

• Instant Stealth Boot: Refactored the app initialization sequence to immediately read cached isUndetectable states on boot for an instant stealth startup.
• Windows Opacity Shield: Implemented an opacity shield on protected windows to eliminate a 1-frame screen flash when showing protected UI elements.
• Expanded Token Limits: Increased Groq max completion tokens to 8192 (the API maximum) to better support full code generation without hitting API constraints.
• Stronger Model Rotation Engine: Fortified the 3-tier fallback mechanisms and auto-upgrade logic across Gemini, Claude, GPT, and Groq models.

Fixes

• Permanent Hide & Visibility Flaw: Repaired a critical IPC routing bug where hiding the session UI dynamically misrouted Cmd+B unhide commands to the background Launcher, eliminating the "invisible interface" trap that often forced application restarts.
• SQLite-Vec Corruptions: Fixed a critical silent data-corruption bug caused by tight strict dimensionality constraints (float[1536]), writing a multi-table database manager to ensure 100% of generated embeddings are retained and searchable.
• Groq Multimedia Drop: Resolved a "Front Door" routing bug where image attachments bypassed the Groq engine completely and triggered false LLM connection errors.
• Critical Race Conditions: Eliminated dangerous global state mutations during LLM fallback loops and patched SettingsManager early-initialization fatal crashes.
• Memory & Resource Leaks: Hardened native audio listener destruction to prevent zombie callbacks, and cleared dangling floating timeout IDs on opacity shields and disguise timers.
• Cross-Platform Compatibility: Rectified hardcoded natively.icns dependencies causing missing-icon errors on Windows/Linux environments.

Technical

• Native Module Loader Pipeline: Integrated a custom NAPI-RS absolute binary loader (nativeModuleLoader.ts) to entirely bypass POSIX-symlink require failures on Windows Git Bash.
• Safe Worker Instantiation: Relocated electron-specific module imports into execution-time lazy requires, neutralizing cross-boundary crashes.
• PR Code Integrations: Cleanly integrated complex changes from PR Fix: Stealth Invisibility, Overlay Cutoff, and Settings Persistence on Windows #64, PR Feat: add github issue and pull request templates #71, PR feat(overlay): add mouse passthrough mode for the meeting overlay #113, PR fix(native-audio): load .node binary directly, bypass broken Windows symlink #115.

⚠️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.8-arm64.dmg
     # Or for Intel Macs:
     xattr -cr ~/Downloads/Natively-2.0.8-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.

---

This discussion was created from the release Natively v2.0.8.