Repository navigation
Releases
TrueHalo v0.4.4
TrueHalo v0.4.4
Release date: 2026-11-19 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64 · Linux x64
This is a maintenance release with no functional changes. It refreshes the dependency tree and closes
the one open RustSec advisory.
Security
- SQLite advisory fixed —
libsqlite3-sysmoved to 0.40 through rusqlite 0.42, closing
RUSTSEC-2026-0459 / CVE-2026-119375. - Audits in CI — every push and pull request now runs production
npm auditandcargo audit.
Both report no vulnerabilities; the RustSec scan keeps three warnings for unmaintained or unsound
transitive crates with no fixed release.
Changed
- Dependency refresh — Tauri 2.12.7, Vite 8.3.8, Vitest 5.1.1, ESLint 10.15, TypeScript 5.9.3,
react-markdown 10.1, Lucide 1.76, Tailwind Merge 2.6.2, base64 0.23, ashpd 0.14 (zbus 6) and
security-framework 3.7. - Packaging — release workflow uses
actions/download-artifact@8.
Install
- macOS (arm64):
TrueHalo-0.4.4-Installer.dmg - Windows (x64):
TrueHalo_0.4.4_x64-setup.exe - Linux (x64):
TrueHalo_0.4.4_amd64.deborTrueHalo_0.4.4_amd64.AppImage
Verification
npm run build,npm run lint,npx tsc --noEmit,npm test— 12/12cargo fmt --check,cargo clippy -- -D warnings,cargo test— 15/15npm audit --omit=dev --audit-level=highandcargo audit— no vulnerabilities- CI passed on macOS, Windows and Linux
TrueHalo v0.4.3
TrueHalo v0.4.3
Release date: 2026-11-09 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64 · Linux x64
Fixed
- Windows connection diagnostics — a failed model list or stream now reports the real DNS, TCP, TLS or proxy cause instead of just
Failed to connect. The same chain is written to%LOCALAPPDATA%\TrueHalo\logs\truehalo.log. - Antivirus / corporate TLS — Windows builds now trust the system certificate store in addition to bundled roots, so HTTPS inspection no longer rejects provider requests.
- Credential save verification — the key is read back after saving; if the credential store did not persist it, the app says so instead of claiming success.
- No silent unauthenticated requests — OpenRouter and OpenAI reject keys containing control characters instead of dropping the
Authorizationheader. - Windows log file — logs are written under
%LOCALAPPDATA%\TrueHalo\logsinstead of a macOS-only path.
Changed
- Settings uses platform-neutral credential-store wording on Windows.
Install
- macOS (arm64):
TrueHalo-0.4.3-Installer.dmg - Windows (x64):
TrueHalo_0.4.3_x64-setup.exe - Linux (x64):
TrueHalo_0.4.3_amd64.deborTrueHalo_0.4.3_amd64.AppImage
Verification
npm run build,npm run lint,npm test,npx tsc --noEmitcargo fmt --check,cargo clippy -D warnings,cargo test- CI passed on macOS, Windows and Linux
TrueHalo v0.4.2
TrueHalo v0.4.2
Release date: 2026-11-08 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64 · Linux x64
Fixed
- Long answers keep streaming — cloud requests now use a 120-second inactivity timeout instead of a hard 2-minute total cap, so a long generation is no longer cut off mid-answer. Local servers use 300 seconds.
- Gemini key handling — the API key is sent in the
x-goog-api-keyheader instead of the URL, so it cannot leak through request errors or logs. - Chat switching during generation — selecting another conversation cancels the active stream, and a slow history load can no longer overwrite a newer selection.
- No empty assistant turns — cancelling or hitting a provider error before the first token removes the placeholder instead of saving an empty message. Partial answers are kept.
- AUR
truehalo-bin— the package now extractsdata.tar.*from the downloaded.deb; it previously assumed the payload was already unpacked. - SQLite resilience — history calls recover from a poisoned connection mutex instead of failing for the rest of the session.
- Linux credential fallback — the file store creates keys with
0600permissions from the first byte instead of narrowing permissions after writing. - Update retry — a failed update check is now a real button, not a label that could not be clicked.
- Local DMG name —
scripts/build.shuses the current package version instead of a hardcoded 0.4.0.
Changed
- CI cancels superseded builds on the same branch or pull request.
Install
- macOS (arm64):
TrueHalo-0.4.2-Installer.dmg - Windows (x64):
TrueHalo_0.4.2_x64-setup.exe - Linux (x64):
TrueHalo_0.4.2_amd64.deborTrueHalo_0.4.2_amd64.AppImage
Verification
npm run build,npm run lint,npm testcargo fmt --check,cargo clippy -D warnings,cargo test- macOS app signature verified with
codesign --verify --deep --strict
TrueHalo v0.4.1
TrueHalo v0.4.1
Release date: 2026-11-07 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64 · Linux x64
Added
- Check for updates — the Settings footer compares the running version to the latest GitHub release and links to the download when a newer build exists. Manual install, no auto-download.
- Frontend quality gates — ESLint and Vitest now run in CI on all three platforms, alongside formatting, Clippy and the Rust tests.
Changed
- Update checks time out after 8 seconds and show a failure message instead of doing nothing.
- CI moved to Node 24 LTS; Dependabot keeps npm, Cargo and GitHub Actions current.
- Vite 8, Vitest 5 and ESLint 10;
npm auditis clean.
Fixed
- AUR metadata now points at the v0.4.1 release, so
truehalo-binbuilds again. cargo fmt --checkpasses; the README roadmap and architecture doc match the shipped Linux support.
Install
- macOS (arm64):
TrueHalo-0.4.1-Installer.dmg - Windows (x64):
TrueHalo_0.4.1_x64-setup.exe - Linux (x64):
TrueHalo_0.4.1_amd64.deborTrueHalo_0.4.1_amd64.AppImage
Verification
npm run build,npm run lint,npm test,npx tsc --noEmitcargo fmt --check,cargo clippy -D warnings,cargo test- DMG signature verified with
codesign --verify --deep --strict
TrueHalo v0.4.0
TrueHalo v0.4.0
Release date: 2026-11-02 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64 · Linux x64
Added
- Token budget — a live per-request token estimate under the message box and automatic oldest-first trimming of history beyond the budget (1k–32k, default 8k). System instructions and your newest message always survive.
Changed
- Clear positioning — the README now states plainly that TrueHalo is for documents, code, and translations, must not be used for cheating, and no longer references cheating tools. The comparison table now covers Electron overlays instead.
Install
- macOS (arm64):
TrueHalo-0.4.0-Installer.dmg - Windows (x64):
TrueHalo_0.4.0_x64-setup.exe - Linux (x64):
TrueHalo_0.4.0_amd64.deborTrueHalo_0.4.0_amd64.AppImage
Verification
npm run build,npx tsc --noEmit,cargo clippy -D warnings,cargo test- DMG signature verified with
codesign --verify --deep --strict
TrueHalo v0.3.1
TrueHalo v0.3.1
Release date: 2026-10-31 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64 · Linux x64
Added
- Linux (x64) —
TrueHalo_0.3.1_amd64.debandTrueHalo_0.3.1_amd64.AppImage. Capture via Desktop Portal (X11 and Wayland), keys in Secret Service with a locked-down file fallback. Screen-recording exclusion has no Linux equivalent and stays off; global shortcuts need X11 or a forwarding compositor. AUR package files live inpackaging/aur.
Fixed
- Ephemeral history that means it — chats are deleted the moment the app quits, not on the next start.
- Send guards — requests are blocked when no model is selected, and over-limit profiles stay blocked until Unlimited is on or their files are trimmed.
Install
- macOS (arm64):
TrueHalo-0.3.1-Installer.dmg - Windows (x64):
TrueHalo_0.3.1_x64-setup.exe - Linux (x64):
TrueHalo_0.3.1_amd64.deborTrueHalo_0.3.1_amd64.AppImage
Verification
npm run build,npx tsc --noEmit,cargo clippy -D warnings,cargo teston macOS, Windows and Linux CI- DMG signature verified with
codesign --verify --deep --strict
TrueHalo v0.3.0
TrueHalo v0.3.0
Release date: 2026-10-30 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64
Added
- Assistant profiles — named answering context (instructions plus .txt/.md files), picked in the chat header and sent with every request. Capped at ~200 KB per profile with a token estimate and a per-profile Unlimited switch. Files stay on your device and only leave it inside your own requests to the selected provider.
- Local models — a Local server provider for Ollama (
http://localhost:11434/v1out of the box), LM Studio, llama.cpp or any OpenAI-compatible endpoint, configurable in Settings. No API key needed. - Click-through mode — mouse clicks pass through the overlay; toggle back with the hotkeys or the tray menu.
- History controls — keep screenshots in history on/off (text-only history keeps the database small) and ephemeral mode (delete all chats on quit).
- Stealth — the overlay stays out of Mission Control and the window cycle on macOS, and out of the taskbar, Alt+Tab and Task View on Windows.
- Version in Settings — the app version is shown in the Settings footer.
Install
- macOS (arm64):
TrueHalo-0.3.0-Installer.dmg - Windows (x64):
TrueHalo_0.3.0_x64-setup.exe
Verification
npm run build,npx tsc --noEmit,cargo clippy -D warnings,cargo test- DMG signature verified with
codesign --verify --deep --strict
TrueHalo v0.2.3
TrueHalo v0.2.3
Release date: 2026-10-30 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64
Added
- Per-capture Image / Text choice — every screenshot now keeps both the compressed image and the on-device recognized text. An Image / Text toggle above the preview picks what the next message sends. The default follows Settings → Screenshot input (Auto / Text first / Image first).
Install
- macOS (arm64):
TrueHalo-0.2.3-Installer.dmg - Windows (x64):
TrueHalo_0.2.3_x64-setup.exe
Verification
npm run build,npx tsc --noEmit,cargo clippy -D warnings,cargo test- DMG signature verified with
codesign --verify --deep --strict
TrueHalo v0.2.2
TrueHalo v0.2.2
Release date: 2026-10-29 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64
Fixed
- Settings window — opening Settings, onboarding or the permission dialog no longer makes the window fully transparent on macOS. The full-screen scrim now uses a solid tint instead of
backdrop-filter, which broke compositing of the transparent window and left only the native traffic lights visible.
Install
- macOS (arm64):
TrueHalo-0.2.2-Installer.dmg - Windows (x64):
TrueHalo_0.2.2_x64-setup.exe
Verification
npm run build,npx tsc --noEmit,cargo clippy -D warnings,cargo test- DMG signature verified with
codesign --verify --deep --strict
TrueHalo v0.2.1
TrueHalo v0.2.1
Release date: 2026-10-28 · License: GPL-3.0-only · Platforms: macOS Apple Silicon (arm64) · Windows x64
Fixed
- Installer — the macOS app bundle is re-signed after packaging and the DMG now contains the Applications shortcut, so the app installs and launches.
- External links — OpenAI, OpenRouter and Gemini links open the system browser from the packaged app.
- OpenAI key page —
platform.openai.com/api-keys(the old/account/api-keyspath dead-ends). OpenAI has no OAuth for third-party apps: sign in there, create a key, paste it in Settings. - OpenRouter key page —
openrouter.ai/settings/keys. - Vision guard — screenshots are no longer sent to text-only models; the app explains the problem before the request leaves.
- Hide from Dock — the overlay stays visible after a restart instead of disappearing with no Dock entry.
- Focus — showing the overlay no longer pulls keyboard focus from the app underneath; clicking it focuses normally.
Changed
- One shared provider catalog for Settings and onboarding; one pricing module.
- Removed the placeholder model-compare panel until parallel streaming ships.
Install
- macOS (arm64):
TrueHalo-0.2.1-Installer.dmg - Windows (x64):
TrueHalo_0.2.1_x64-setup.exe
Verification
npm run build,npx tsc --noEmit,cargo clippy -D warnings,cargo test- DMG signature verified with
codesign --verify --deep --strict