Files
waggle-os/CHANGELOG.md
shumeiko.it b8a4134b0a docs: add a changelog entry for the first community edition (P2.4)
List what changed for users compared with the commercial product:
removed (billing, KVARK, compliance, self-learning, team mode, old
memory engine features), changed (mem0 memory, waggle.db, opt-in
analytics, whatsapp-web.js, the server installer, the pinned Node
runtime, the built-in proxy), added and fixed, based on the ADRs and
the branch history.
2026-11-01 01:55:25 +01:00

5.8 KiB

Changelog

All notable changes to the Waggle community edition are listed here. The format follows Keep a Changelog.

Unreleased: first community edition

The first open-source release of Waggle, made from the commercial Waggle OS product. This entry lists what changed for users compared with that product. The reasons are recorded in the decision records.

Removed

  • Billing and plans. Trial, Solo, Teams and Enterprise plans, Stripe checkout, license checks, trial banners and upgrade prompts. Everything a plan used to unlock is available (ADR-0001).
  • KVARK enterprise retrieval, its agent tools, and the enterprise capability packs.
  • Compliance reports and the compliance subsystem.
  • Self-learning (ADR-0004): behavior evolution and prompt optimization (the optimizer package), learning from corrections, the Evolution screen (Memory → Improvements), the nightly prompt-optimization and monthly-assessment jobs, and the idle-session reviewer. Thumbs up and down are still stored, and corrections you make are saved as ordinary memories.
  • Team mode (ADR-0003): connecting to a team server, team workspaces and shared memory, WaggleDance, the team screens, and S3 file storage for workspaces. The code stays in the repository but is not built or shipped.
  • Features of the old memory engine (ADR-0002): the knowledge graph, the wiki, importing chat history from ChatGPT and Claude exports, memory consolidation, the memory server for external tools (MCP), and the memory hooks for Claude Code, Codex and other coding agents.
  • install.sh and scripts/waggle-server.sh, replaced by the server installer.
  • The automatic start of a LiteLLM proxy, which needed Python. It is now opt-in (see Changed).

Changed

  • Memory runs on local mem0 behind a memory contract (ADR-0002, ADR-0007). Memories are kept in ~/.waggle/memory/, embedded by a model that runs on your computer, and searched with mem0's combined vector and keyword search. Nothing goes to a cloud memory service. Memories from the old .mind files are not carried over. See docs/memory.md.
  • Waggle's own data (automations, notifications, cost tracking, your profile card and task list) moved to a separate waggle.db, apart from memory.
  • Analytics are opt-in (ADR-0006). Waggle asks once; nothing is sent until you choose Allow, and Settings → General → Privacy & Telemetry turns it off again. When allowed, Waggle sends one event at the end of setup with the template, persona and model you chose.
  • WhatsApp uses whatsapp-web.js instead of Baileys (ADR-0005). Pair your phone again with the QR code. The session is kept in the data directory as a browser profile, protected by file permissions rather than the vault. If no Chrome, Edge or Chromium is installed, Waggle downloads Chrome for Testing (about 170 MB) the first time you start WhatsApp. The channel handles text messages only.
  • npx @waggle-ai/waggle installs a prebuilt server (ADR-0009) instead of running the server from npm. It adds the waggle-server command with run, doctor, update and uninstall, and the installed server serves the web UI. The package and command names are temporary.
  • Desktop app and server archives carry their own Node.js (22.23.2) with matching native modules, so no Python or compiler is needed to install (ADR-0008).
  • Model calls go through the built-in provider proxy by default. LiteLLM runs only when config.json contains "litellm": { "enabled": true }, on your own Python.
  • The Waggle-managed Ollama runtime works on Linux, and installs no longer download CUDA libraries.
  • The recall reranker is off by default; WAGGLE_RERANKER=1 turns it on.
  • The license is MIT for the whole repository. Notices for shipped third-party components are in THIRD_PARTY_NOTICES.md.
  • UI text no longer uses decorative emoji or em dashes, and generic AI icons were replaced.

Added

  • Background fact extraction. While you chat, Waggle can save facts about you to personal memory, every six messages or after a two-minute pause, with the model you chat with. Turn it off in Settings → General → Memory.
  • Memory capabilities. The UI hides memory features the store does not support.
  • The server installer (packages/launcher): install, run, doctor, update and uninstall, with SHA-256 checks of the downloaded archive.
  • A license check for shipped npm packages and Rust crates.
  • A new design, off by default, switched on with "New design" at the bottom of the sidebar.
  • A bottom navigation bar on phones, instead of the sidebar rail.

Fixed

Fixes made while preparing this edition. Each is recorded in docs/oss/upstream-fixes.md.

  • The packaged macOS app could not find its bundled server and stayed on "Starting Waggle…" (UF-004).
  • On macOS and Linux the desktop app stopped its server without letting it shut down (UF-046).
  • Local model downloads were cancelled after five minutes (UF-008).
  • A working API key showed as not responding, and other internal model calls failed (UF-044).
  • A memory saved to an unknown workspace landed in personal memory (UF-039).
  • Memory searches from Timeline and the chat recall toast used the wrong scope (UF-035), and the command palette searched the wrong workspace (UF-033).
  • The web client showed "important" and "temporary" memories as normal (UF-036).
  • Generating a persona from a description failed (UF-045).
  • The onboarding Industry dropdown opened under the dialog (UF-007), and startup text was invisible in the light theme (UF-017).
  • Brand fonts did not load under the content security policy.
  • Smaller interface fixes: UF-042, UF-043, UF-047 to UF-057.