v1.8

Agent Zero – Release Notes

Key highlights: skill selector UI, memory hardening, and tool-arg validation fixes.

• Built-in Skills Selector – A new plugin accessible from the chat input + menu lets you browse and activate available skills directly in the current context or project. Default configs now allow skills to be active from the start, saving time and tokens on setup.

• Memory hardening – FAISS index integrity is now verified via a SHA-256 sidecar file (index.faiss.sha256), written on every save. Filter evaluation in memory_load is hardened with an allowlist, length cap, and restricted simple_eval execution. Consolidation scoring now uses real relevance scores with best-score deduplication by memory ID. Input history is truncated before sending to the utility model to prevent context overflows.

• Tool argument validation fix – validate_tool_request previously crashed on any tool call that passed an empty tool_args dict (e.g. scheduler list_tasks, health checks) because an empty dict is falsy. The check is now a proper key-existence test, restoring correct behaviour for all no-argument tool calls.

v1.7

Agent Zero – Release Notes

Prompt & Model Guidance Overhaul

• Adopted compact default prompts across the core stack, plugin-owned prompts, and the agent0 overlay — default assembled prompt now sits under ~3 000 tokens while retaining all key guardrails
• Restored essential tool-call JSON examples, communication/solving/tips guidance, and the agent0 profile after earlier over-aggressive trimming caused regressions with frontier models
• Added strict JSON guidance to steer models toward treating the closing brace as an end-of-sequence signal, and defaulted response style to concise with expansion on demand
• Removed the obsolete a0_small profile; tool-call knowledge reference renamed to a generic framework file
• Added a regression test that verifies the assembled default prompt stays within the token budget and retains critical guardrails

Early Tool Dispatch via Streaming JSON Detection

• Tool calls are now dispatched as soon as the first fully closed top-level JSON object is detected in the model stream — the stream is stopped at that point rather than waiting for all remaining tokens
• DirtyJson parser gains a completed flag that signals when the root structure is explicitly closed (not merely at end-of-file), enabling safe early extraction
• Extraction is restricted to brace-delimited objects, matching the shape of all tool calls

Plugin Discovery Cards on Welcome Screen & Onboarding

• A new always-enabled _discovery plugin adds a discovery surface to the welcome/dashboard screen, surfacing the Plugin Hub and integrations (Telegram, Email, WhatsApp) via feature cards
• Cards include persistent dismiss/restore state and CTA routing to the relevant plugin config screens
• Discovery cards are integrated into the final onboarding step so new users see integration opportunities immediately after setup
• Cards are hidden while the missing-API-key onboarding banner is visible to reduce noise during initial configuration
• Implemented entirely through the existing WebUI extension mechanism with no core welcome-screen changes

Bug Fixes

• Fixed a crash during config retrieval when a plugin directory cannot be found — get_plugin_config and get_default_plugin_config now return early instead of passing a None path to the filesystem layer

v1.6

• WhatsApp integration plugin — New plugin connecting Agent Zero to WhatsApp via a Baileys JS bridge with QR/pairing-code setup. Supports self-chat and dedicated (bot account) modes, group chat with mention detection, quoted replies, media/attachment handling, typing indicators, Markdown-to-WhatsApp formatting, and account disconnect/switch.
• WhatsApp: self-chat is now the default mode — Default changed from dedicated to self-chat; a warning banner is shown when allowed_numbers is empty in this mode.
• WhatsApp: allowed-numbers filtering moved to Python — Phone number filtering now happens in the Python poll handler (reading config fresh each cycle) rather than the JS bridge, fixing a bug where LID-based matching never worked.
• WhatsApp: improved bridge reliability — Corrupt or missing node_modules are detected and automatically reinstalled; the poll loop stops after 5 consecutive bridge failures instead of spamming errors; Node.js absence halts the loop immediately; bridge restarts automatically when configuration changes.
• WhatsApp: storage paths centralized — Session and media files moved from usr/whatsapp to tmp/whatsapp via a new storage_paths.py helper; paths are now consistent across all modules.
• Settings: API keys no longer overwritten on save — Saving general settings no longer clobbers API keys that were set via the Configure Models dialog.
• Settings: model config UI fixes — Restored provider fallback and empty option for utility preset; extracted a reusable model-field component and unified API key lifecycle handling.
• UI server restructuring — Server setup extracted into a UiServerRuntime class with modular initialization; environment config, route registration, and transport handlers moved to helpers/ui_server.py.
• Update system enhancements — Added released_at timestamp tracking for git tags and branch heads; new get_current_major_main_latest_info finds the latest same-major version on the main branch; major_upgrade_versions and main_branch_latest fields added to the update info payload.

v1.5

WebSocket System Rework & General Improvements

• WebSocket architecture rewrite — New WsHandler base class, WsManager for connection tracking, event routing, and buffering; reduces WebSocket init from ~170 lines to ~10. Frontend adapter updated with exponential backoff, envelope validation, 50 MB cap, and improved handler registration.
• WebSocket security fix — dispatch_to_all_sids snapshot now taken inside the lock to prevent security check bypass during concurrent disconnects.
• WebSocket memory leak fixes — Resolved SID retention after disconnection and cleaned up unreferenced broadcast tasks.
• API/WebSocket caching — WebSocket and API caching parameters are now enabled.
• a0_small prompt set — New compact prompt set for small models, reducing initial token usage from ~10k to ~2.5k tokens. Includes stricter tool-call guardrails, canonical JSON examples, exact tool-name matching, and memory usage hints.
• Fix: non-ASCII filename uploads — Resolved a 500 error when uploading images with non-ASCII filenames via /api/image_get; adds graceful fallback for path handling in both development and Docker environments.
• Fix: agents self-correct tool call format — Agents now attempt to fix their own malformed tool calls instead of immediately erroring.
• UI: chat navigation buttons — Repositioned as a floating overlay in the bottom-right of the chat area.
• Log sanitization — Printed output and HTML logs are now sanitized to handle invalid Unicode (including lone surrogates); log files opened with utf-8 and errors='replace'.
• Plugin installer — Centralized popularity checking with a configurable POPULAR_PLUGIN_MIN_STARS threshold.
• Onboarding plugin — Added generated thumbnail.

v1.4

Agent Zero – Release Notes

Onboarding, plugin hub improvements, and model config enhancements

• Onboarding flow for missing API keys – A new onboarding experience guides users when no API key is configured. A banner in the chat composer surfaces the missing-key status directly, replacing a dedicated backend status endpoint.
• Model config presets – A model switcher component is now available in the chat input area, with support for active preset/model retrieval from the model config store.
• Agent progress in chat input – Agent progress is shown as ghost text in the chat input placeholder for better at-a-glance awareness.
• Parallel plugin scans – The serialized scan queue has been removed; plugin scans now run in parallel, each in its own temporary chat context. The "queued" state has been removed from the UI and store.
• Sanitized plugin markdown rendering – Plugin READMEs and docs are now rendered through a shared safe-markdown pipeline using DOMPurify, preventing unsafe HTML from reaching the page. GitHub README link and image rebasing (including releases routes) is now centralized and applied consistently across the Plugin Hub, installed plugin README, and markdown modal docs.
• Fixed plugin README image paths – README images and links are correctly rebased to GitHub blob/raw paths, fixing broken images in plugin documentation.

v1.3

Agent Zero – Release Notes

• Chat compaction plugin: New built-in plugin that compacts chat history, helping manage long conversations and context window usage. Includes plugin thumbnail.
• WebUI page-head extension point: Plugins can now inject <script> and <link> tags directly into <head> via a new x-extension injection point in index.html, enabling cleaner loading of vendor libraries (e.g. mermaid.js, custom fonts) without DOM manipulation hacks.
• Plugin index fetch cleanup: Removed redundant force parameter from the server-side plugin index fetch handler; cache-busting is now handled entirely client-side.
• Updated a0-development skill.
• Release workflow improvements: Added fallback environment variable support (OPENROUTER_MODEL_NAME / OPENROUTER_MODEL), improved error handling with graceful fallback messaging, and relaxed branch/tag constraints in the Docker publish workflow.

v1.2

• Plugin installer: Added force-refresh support with cache-busting headers and request sequence tracking to prevent race conditions during concurrent index loads. New openIndexView and reloadIndex store methods enable explicit refresh control.
• Model config: Moved models summary state from component into the store, with loading and caching support. Added refreshModelsSummary and ensureModelsSummaryLoaded helpers.
• Docker publish workflow: Release notes are now generated dynamically via OpenRouter instead of being read from static markdown files. The docs/release_notes/ directory and its versioned files have been removed; the workflow now requires OPENROUTER_API_KEY and OPENROUTER_MODEL environment variables and uses a system prompt template at scripts/openrouter_release_notes_system_prompt.md.

Breaking changes

• The docs/release_notes/ directory and its static release note files (v1.0, v1.1) have been removed. Any external tooling or workflows that referenced RELEASE_NOTES_DIR or those files must be updated to use the new dynamic generation approach.

v1.1

v1.1

Covers changes from the v0.9.8 series through the current v1.5 state, including the v0.9.9 work that landed along the way.

• Agent Zero now has a real plugin platform: developers can build and ship functionality independently of the core, with a large refactor that makes more of the framework extensible through plugins, hooks, and user-side development instead of core-only changes.
• The new Plugin Hub brings an app-store-like workflow for discovery, installation, configuration, validation, scanning, README viewing, thumbnails, scoped toggles, and safer plugin management.
• Core extensibility was expanded across prompts, tools, secrets, APIs, model providers, lifecycle hooks, file watching, and other internal systems, making custom integrations and deeper framework extensions much easier to build and maintain.
• New communication integrations: built-in Email and Telegram plugins with config UIs, attachment handling, dispatcher and model routing, notifications, group-chat support, and a long round of reliability fixes.
• Model and prompt architecture upgrades: model presets and search, per-chat model switching, browser-agent model simplification, OpenRouter and provider fixes, the PromptInclude plugin, and related configuration improvements.
• Self-update and release-flow improvements: native Git-based self-update, stronger tag validation and remote tag fetching, better disconnect handling in the update UI, and the simplified release tag format from vX.Y.Z to vX.Y.
• UI and chat improvements: chat-branching fixes, expanded ALL-mode responses, taller chat input, sidebar and header cleanup, quick-action redesign, plugin and settings modal polish, and more stable WebSocket and frontend cache behavior.
• Security and reliability hardening: CSRF fixes for HTTPS and Chromium, dependency security pins, secret masking in code-execution output, safer plugin warnings, cross-device file move fixes, improved email whitelist handling, and cleaner retry and exception handling.
• Core framework refactors: broad Python, API, and helper cleanup, extension-system rework, routing and caching improvements, generic tool-output update hooks, and extraction of more capabilities into built-in plugins.
• Ongoing polish across the project: welcome-banner and default-preset cleanup, browse and extract improvements, built-in plugin branding and docs refreshes, project-doc fixes, and a fix for skills_tool loading when loaded_skills is uninitialized.

v0.9.8.3 - Improved chatbox expansion

v0.9.8.3 - Improved chatbox expansion

v0.9.8.2 - Bugfix - skills loading

v0.9.8.1 - Caching, context optimization, error handling...

• improved caching for anthropic models
• improved context window optimimization
• fixed retry on critical error counter
• load up to 5 skills at a time
• default chat model is now Sonnet 4.6

v0.9.8 - Skills, UI Redesign & Git projects

Release video

• Skills
  • Skills System replacing the legacy Instruments with a new SKILL.md standard for structured, portable agent capabilities.
  • Built-in skills, and UI support for importing and listing skills
• Real-time WebSocket infrastructure replacing the polling-based approach for UI state synchronization
• UI Redesign
  • Process groups to visually group agent actions with expand/collapse support
  • Timestamps, steps count and execution time with tool-specific badges
  • Step detail modals with key-value and raw JSON display
  • Collapsible responses with show more/less and copy buttons on code blocks and tables
  • Message queue system allowing users to queue messages while the agent is still processing
  • In-browser file editor for viewing and editing files without leaving the UI
  • Welcome screen redesign with info and warning banners for connection security, missing API keys, and system resources
  • Scheduler redesign with standalone modal, separate task list, detail and editor components, and project support
  • Smooth response rendering and scroll stabilization across chat, terminals, and image viewer
  • Chat width setting and reworked preferences panel
  • Image viewer improvements with scroll support and expanded viewer
  • Redesigned sidebar with reusable dropdown component and streamlined buttons
  • Inline button confirmations for critical actions
  • Improved login design and new logout button
  • File browser enhanced with rename and file actions dropdown
• Git projects
  • Git-based projects with clone authentication for public and private repositories
• Four new LLM providers: CometAPI, Z.AI, Moonshot AI, and AWS Bedrock
• Microsoft Dev Tunnels integration for secure remote access
• User data migration to /usr directory for cleaner separation of user and system files
• Subagents system with configurable agent profiles for different roles
• Memory operations offloaded to deferred tasks for better performance
• Environment variables can now configure settings via A0_SET_* prefix in .env
• Automatic migration with overwrite support for .env, scheduler, knowledge, and legacy directories
• Projects support extended to MCP, A2A, and external API
• Workdir outside project support for more flexible file organization
• Agent number tracking in backend and responses for multi-agent identification
• Many bug fixes and stability improvements across the UI, MCP tools, scheduler, uploads, and WebSocket handling

v0.9.8.2 - Skills, UI Redesign & Git projects

v0.9.8.2 - Bugfix - skills loading

v0.9.8.1 - Caching, context optimization, error handling...

• improved caching for anthropic models
• improved context window optimimization
• fixed retry on critical error counter
• load up to 5 skills at a time
• default chat model is now Sonnet 4.6

v0.9.8 - Skills, UI Redesign & Git projects

Release video

• Skills
  • Skills System replacing the legacy Instruments with a new SKILL.md standard for structured, portable agent capabilities.
  • Built-in skills, and UI support for importing and listing skills
• Real-time WebSocket infrastructure replacing the polling-based approach for UI state synchronization
• UI Redesign
  • Process groups to visually group agent actions with expand/collapse support
  • Timestamps, steps count and execution time with tool-specific badges
  • Step detail modals with key-value and raw JSON display
  • Collapsible responses with show more/less and copy buttons on code blocks and tables
  • Message queue system allowing users to queue messages while the agent is still processing
  • In-browser file editor for viewing and editing files without leaving the UI
  • Welcome screen redesign with info and warning banners for connection security, missing API keys, and system resources
  • Scheduler redesign with standalone modal, separate task list, detail and editor components, and project support
  • Smooth response rendering and scroll stabilization across chat, terminals, and image viewer
  • Chat width setting and reworked preferences panel
  • Image viewer improvements with scroll support and expanded viewer
  • Redesigned sidebar with reusable dropdown component and streamlined buttons
  • Inline button confirmations for critical actions
  • Improved login design and new logout button
  • File browser enhanced with rename and file actions dropdown
• Git projects
  • Git-based projects with clone authentication for public and private repositories
• Four new LLM providers: CometAPI, Z.AI, Moonshot AI, and AWS Bedrock
• Microsoft Dev Tunnels integration for secure remote access
• User data migration to /usr directory for cleaner separation of user and system files
• Subagents system with configurable agent profiles for different roles
• Memory operations offloaded to deferred tasks for better performance
• Environment variables can now configure settings via A0_SET_* prefix in .env
• Automatic migration with overwrite support for .env, scheduler, knowledge, and legacy directories
• Projects support extended to MCP, A2A, and external API
• Workdir outside project support for more flexible file organization
• Agent number tracking in backend and responses for multi-agent identification
• Many bug fixes and stability improvements across the UI, MCP tools, scheduler, uploads, and WebSocket handling