OpenSquilla 0.5.0 Preview 4

Overview

OpenSquilla 0.5.0 Preview 4 is an upgrade-safety release for existing Desktop and terminal installations. It protects the active workspace, identity, memory, configuration, and chat history while correcting the profile-layout transition introduced in earlier previews.

Normal version upgrades do not require a data transfer. If the current chats and Agents already appear correctly, continue using the active profile. Data transfer is reserved for an old Windows Portable installation or another explicitly selected OpenSquilla profile.

✨ What’s Improved

Profile recovery and upgrade safety

Desktop now checks the effective profile and workspace before creating an empty workspace, opening a chat database, or writing any profile data. Existing USER.md, SOUL.md, IDENTITY.md, MEMORY.md, and the chat databases under state/ are not silently overwritten, deleted, or merged.

When an older and current workspace both exist but the active data is still valid, OpenSquilla keeps using it and shows a non-blocking recovery notice. If the active profile cannot be verified safely, Desktop offers an isolated, persistent recovery profile instead of writing to an uncertain location. Recovery remains available without deleting the original profile or its backups.

Complete profile transfers use a stable source snapshot and an all-or-nothing target replacement. Existing target data must be backed up first, and the source remains unchanged. Two profiles are never silently merged or kept in automatic sync.

Windows Portable transfer

A fresh Windows Desktop installation can detect retired OpenSquilla Portable data and offer an optional copy during setup. The page identifies the selected Portable data before copying its chats, Agents, settings, and other profile state. Nothing is selected automatically, and choosing Not now continues normal setup without changing the Portable source.

CLI homes and other Desktop profiles are not presented as normal-upgrade data during first-run setup. They remain available through the explicit transfer action in Settings, where a populated Desktop target requires a complete backup before replacement.

Desktop cleanup, credentials, and updates

The RC4 Windows uninstaller preserves Desktop profile data during a normal uninstall. Desktop also separates resetting setup, deleting the current profile, and deleting all user data so each action describes exactly what it will remove.

Provider API-key updates now remain effective after restart instead of being replaced by an older saved value. Update checks can continue across long-running Desktop sessions and can report a later 0.5 preview or the final 0.5.0 release. Windows update notices still lead to a manual installer download; they do not silently replace the running application.

Model Ensemble, providers, and Control UI

Model Ensemble now reports distinct candidate and aggregation progress, handles slow or incomplete streams more reliably, and closes stalled runs without leaving the interface indefinitely busy. Usage no longer applies a misleading single-model savings formula to Ensemble turns.

The Control UI also improves model selection, full tool-result inspection, and chat scroll retention. Provider limits and request budgets have received additional corrections for long-running and multi-model turns.

Requests to the official TokenRhythm and OpenRouter API hosts now include OpenSquilla’s public HTTP-Referer and X-Title application-attribution headers. Custom OpenAI-compatible hosts do not receive these headers.

Runtime and channel reliability

WeCom WebSocket connections no longer run competing heartbeat loops that can cause repeated disconnects. Transport failures, child-process cleanup, SQLite extension handling, and checkpoint recovery also fail more predictably without discarding valid user state.

Downloads and deployment

Release files remain available from GitHub and from the versioned Alibaba Cloud OSS mirror. Users in Mainland China can use the stable download page at:

https://opensquilla-releases.oss-cn-beijing.aliyuncs.com/releases/latest.html

The page points to the latest verified mirrored release; it is not an additional GitHub Release asset.

Downloads

Recommended desktop downloads:

• macOS desktop installer: OpenSquilla-0.5.0-rc4-mac-arm64.dmg
• macOS desktop zip: OpenSquilla-0.5.0-rc4-mac-arm64.zip
• Windows desktop installer: OpenSquilla-0.5.0-rc4-win-x64.exe

The Windows desktop installer is currently unsigned. See the code signing policy before installation.

Terminal and automation downloads:

• Python wheel: opensquilla-0.5.0rc4-py3-none-any.whl
• Checksums: SHA256SUMS

Updater metadata:

• latest-mac.yml
• latest.yml
• *.blockmap

No Windows Portable assets are published for 0.5.0 preview releases. Existing 0.4.x Portable downloads remain on their original release pages only as legacy sources. Do not expect a new 0.5.0rc4 Portable zip or a Portable /releases/latest/download/ alias.

Privacy and third-party attribution are documented in PRIVACY.md and THIRD_PARTY_NOTICES.md.

Container users can pull the multi-architecture gateway image:

docker pull ghcr.io/opensquilla/opensquilla:v0.5.0rc4

The versioned image supports linux/amd64 and linux/arm64. The moving GHCR latest tag follows the most recently verified release tag.

Upgrading from Preview 3, earlier previews, or 0.4.1

Quit the running Desktop app and gateway before upgrading. Back up the active profile first if you may need to recover or roll back.

[!IMPORTANT] On Windows, install RC4 directly over the existing RC3 installation. Do not uninstall Preview 3 first: its uninstaller may delete %APPDATA%\OpenSquilla. Back up that directory before upgrading. RC4 and later installers preserve profile data during a normal uninstall.

On macOS, drag the new app into Applications, eject the DMG, and open the Applications copy. Existing profile data remains in place.

After startup, no action is needed when the existing chats and Agents look correct. The optional Portable transfer is for a different legacy installation, not for the profile that Desktop has just upgraded.

CLI users can reinstall the published wheel over the current tool environment:

uv tool install --python 3.12 --force --reinstall-package opensquilla \
  "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.0rc4/opensquilla-0.5.0rc4-py3-none-any.whl"

Binary downgrade from RC4 to RC3 or an earlier preview is not supported. If a rollback is necessary, restore a complete backup rather than running an older binary against a profile already used by RC4.

Non-user-initiated network observability can be disabled before startup with OPENSQUILLA_PRIVACY_DISABLE_NETWORK_OBSERVABILITY=true or:

[privacy]
disable_network_observability = true

The compatibility variables OPENSQUILLA_TELEMETRY_DISABLED=true and OPENSQUILLA_UPDATE_CHECK_DISABLED=true remain honored.

Acknowledgements

Thanks to the human contributors whose new work is present in Preview 4:

• @HuaXiawithMoon for improving WeCom WebSocket connection stability.
• @ab2ence for restructuring Model Ensemble guidance around clear static and dynamic lineups.
• @nice-code-la for the Alibaba Cloud OSS release mirror and stable download page.
• @nankingjing for transport, process, SQLite, and checkpoint reliability fixes.

See CONTRIBUTORS.md for the attribution ledger and pull-request evidence.