# Changelog All notable changes to the Waggle community edition are listed here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). ## 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](docs/oss/adr/README.md). ### 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](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](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](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.