BioRouter v1.88.1

BioRouter v1.88.1 Release Notes

Release date: July 15, 2026

Repository: github.com/BaranziniLab/biorouter

BioRouter v1.88.1 is a focused reliability and control release. It adds a
selective factory-reset surface, makes the Home activity view appear
immediately from bounded caches, hardens bundled local-model startup and
warm-up, fixes theme-pack persistence, and normalizes tooltip layout across the
desktop and generated visualizations. The production desktop dependency graph
also moves to patched, semver-compatible releases and passes its production
security audit with no known vulnerabilities.

There are no required migrations. Existing settings, sessions, extensions,
skills, workflows, applications, knowledge bases, and usage history remain
untouched unless the user explicitly selects them in the new reset panel.

Downloads

Platform	File	Install
macOS Apple Silicon	BioRouter-1.88.1-arm64.dmg	Open the DMG and drag BioRouter.app to /Applications
macOS Intel	BioRouter-1.88.1-x64.dmg	Open the DMG and drag BioRouter.app to /Applications
Windows x64	BioRouter-win32-x64-1.88.1.zip	Unzip and run BioRouter.exe
Linux desktop Debian / Ubuntu	biorouter_1.88.1_amd64.deb	sudo apt install ./biorouter_1.88.1_amd64.deb
Linux desktop Fedora / RHEL	BioRouter-1.88.1-1.x86_64.rpm	sudo dnf install ./BioRouter-1.88.1-1.x86_64.rpm
Linux CLI only Debian / Ubuntu	biorouter-cli_1.88.1_amd64.deb	sudo apt install ./biorouter-cli_1.88.1_amd64.deb
Linux CLI only Fedora / RHEL	biorouter-cli-1.88.1-1.x86_64.rpm	sudo dnf install ./biorouter-cli-1.88.1-1.x86_64.rpm
Headless Linux x64	biorouter-headless-linux-x64.tar.gz	Extract and follow docs/headless-linux.md

The macOS builds are signed, notarized, and stapled with the UCSF Developer ID.
Signed updater ZIPs for both architectures and latest-mac.yml are included for
in-app updates.

Highlights

Selective reset controls

Settings → App now includes a reset panel that previews affected item counts
before any deletion and requires explicit confirmation. Users can reset one or
more independent categories:

• Agent Drafter applications;
• knowledge bases and Soul memory;
• user-installed skills;
• custom extensions while retaining bundled capabilities;
• schedules while restoring Daily Meditation;
• workflows while restoring the Meditation workflow; and
• conversation, usage, cost, and checkpoint history.

Resetting everything uses the same category-specific operations rather than an
opaque directory wipe. Active agent turns block the operation, cached agents
and renderer caches are cleared safely, built-in content is restored, and the
desktop refreshes affected usage and navigation state after completion.

Immediate Home activity

• Home activity and recent sessions use short-lived, bounded caches so the
  dashboard can paint useful data immediately and reconcile in the background.
• Hovering or focusing Home in the sidebar preloads both activity and recent
  session data.
• The activity heatmap identifies cells in the current streak in its accessible
  label, tooltip, and legend.
• Failed refreshes preserve usable cached data instead of replacing it with an
  empty surface.

More dependable local models

• Bundled llama.cpp startup detects and terminates stale listeners before
  retrying, reducing false “address already in use” failures after an
  interrupted launch.
• The LLAMACPP_ENABLE_THINKING setting accepts both typed booleans and string
  environment values.
• Warm-up requests allow thinking-capable models enough output budget to reach
  their readiness response.
• Gemma 4 E2B download-size guidance now reflects the curated artifact.
• Repetition-loop signatures canonicalize nested JSON object keys, keeping
  equivalent tool calls equivalent in both standalone and full-server builds.

Desktop polish and theme reliability

• Imported theme packs retain their selected values and present consistently
  after restart.
• Built-in, model, network, and generated-visualization tooltips share bounded
  wrapping and viewport-aware placement.
• Short labels stay on one line where space permits; long diagnostic content
  wraps without escaping its canvas.
• The original BioRouter identity and platform icons remain unchanged in this
  release.

Production dependency hardening

• Patched releases of the desktop routing, request-throttling, URL parsing,
  shell quoting, and utility dependencies replace their vulnerable revisions.
• npm audit --omit=dev reports zero vulnerabilities for the dependency graph
  shipped inside the desktop and headless packages.
• The complete 886-test desktop suite passes against the refreshed lockfile.

Documentation

• The design, theme, and agentic-system references now document the current
  desktop tokens, theme contract, runtime loop, session boundaries, tools,
  permissions, checkpoints, interrupts, vault binding, and completion gates.
• The landing documentation and download matrix cover every v1.88.1 desktop,
  CLI-only, and headless artifact.

CLI, TUI, server, and headless parity

The biorouter CLI and terminal UI, biorouterd daemon, desktop-bundled
binaries, Linux CLI packages, and headless browser/server archive all report
1.88.1. The CLI/TUI continues to expose terminal chat, provider and model
selection, workflows, scheduling, knowledge, extensions, skills, diagnostics,
web mode, and biorouter doctor without requiring Electron.

Release verification

Publication is gated on the repository release pipeline:

• Rust formatting, linting, workspace tests, generated API consistency, and the
  complete desktop test suite;
• signed, notarized, and stapled Apple Silicon and Intel applications, mounted
  from their DMGs and launched with packaged biorouter and biorouterd;
• Linux desktop DEB and RPM installation and startup in clean containers;
• CLI-only DEB and RPM installation plus terminal entry-point and version
  checks;
• headless archive integrity, daemon health, browser startup, and HTTP fetch;
• Windows CLI, daemon, terminal entry point, and desktop startup on a native
  Windows GitHub-hosted runner; and
• artifact architecture, updater-manifest, checksum, and release-name checks.

Upgrade notes

No configuration changes are required. macOS users on v1.86.0 or later can use
the in-app Restart & Update action. Everyone else can install the package for
their platform over the current version.