# Watcher releases Part of the [Watcher docs](https://watcher-docs.apolloresearch.ai/llms.txt). ## Before upgrading Watcher Read the [Releases index](https://watcher-docs.apolloresearch.ai/releases/index.md) before every upgrade. Determine the installed and target versions, then read every release page and linked full changelog with a version greater than the installed version and no greater than the target. Include versions you skip. Read releases even when they list no required actions, to understand behavior and compatibility changes. Apply required steps oldest first, using the self-hosted and Watcher Cloud audience labels. Use [Update Watcher](https://watcher-docs.apolloresearch.ai/self-hosting/updates.md) for the procedure and [Verify an update](https://watcher-docs.apolloresearch.ai/self-hosting/update-verification.md) for self-hosted verification. ## Release pages - [Watcher 0.15.0: Automatically review high-risk coding-agent sessions](https://watcher-docs.apolloresearch.ai/releases/0.15.0/automatically-review-high-risk-coding-agent-sessions.md): Watcher adds automated reviews of high-risk sessions, organization grading limits, clearer usage reporting, and searchable session owners. Required upgrade steps: self-hosted deployments. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.15.0). - [Watcher 0.15.1: Monitor Codex Code Mode permission decisions](https://watcher-docs.apolloresearch.ai/releases/0.15.1/monitor-codex-code-mode-permission-decisions.md): Watcher reliably records Codex permission decisions, changes client log formatting, and limits hosted grading requests to ten grades per request. Required upgrade steps: self-hosted deployments, Watcher Cloud. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.15.1). - [Watcher 0.20.0: Upgrade Watcher Live from older client versions](https://watcher-docs.apolloresearch.ai/releases/0.20.0/upgrade-watcher-live-from-older-client-versions.md): The Watcher installer recognizes an existing client's version and displays the update instructions supported by that version. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.20.0). - [Watcher 0.24.0: Set retention policies for coding-agent session data](https://watcher-docs.apolloresearch.ai/releases/0.24.0/set-retention-policies-for-coding-agent-session-data.md): Watcher adds automatic session-content retention, development-container support, and clearer security-review results in the dashboard. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.24.0). - [Watcher 0.25.0: Filter coding-agent sessions by security severity](https://watcher-docs.apolloresearch.ai/releases/0.25.0/filter-coding-agent-sessions-by-security-severity.md): Analyzer's review list and daily trend chart follow the selected severity threshold, while coverage metrics keep their own scope. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.25.0). - [Watcher 0.26.0: Manage session data retention in Watcher Analyzer](https://watcher-docs.apolloresearch.ai/releases/0.26.0/manage-session-data-retention-in-watcher-analyzer.md): Analyzer administrators can configure a 7 to 365 day session-content retention period and remove individual sessions' content. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.26.0). - [Watcher 0.26.1: Codex sessions now start reliably with Watcher Live](https://watcher-docs.apolloresearch.ai/releases/0.26.1/codex-sessions-now-start-reliably-with-watcher-live.md): Watcher restores Codex startup compatibility, routes enforce-mode approvals through sandbox escalation, and avoids disabling grading for slow reviews. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.26.1). - [Watcher 0.27.0: Sign in to Watcher on headless machines](https://watcher-docs.apolloresearch.ai/releases/0.27.0/sign-in-to-watcher-on-headless-machines.md): Watcher adds headless sign-in, improves Codex and large-session monitoring reliability, and expands self-hosted image availability. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.27.0). - [Watcher 0.29.0: Send structured messages for monitoring](https://watcher-docs.apolloresearch.ai/releases/0.29.0/monitor-claude-code-sessions-in-ci-and-cloud.md): Watcher accepts structured messages from monitoring integrations and adds optional Kubernetes API autoscaling. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.29.0). - [Watcher 0.30.0: Server-managed security monitors for coding agents](https://watcher-docs.apolloresearch.ai/releases/0.30.0/upgrade-watcher-to-server-managed-security-monitors.md): Watcher manages Triage and Gateway prompts, models, and conversation context on the server, while custom graders retain their own configuration. Required upgrade steps: self-hosted deployments, Watcher Cloud. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.30.0). - [Watcher 0.30.1: Fix Watcher permission review escalation failures](https://watcher-docs.apolloresearch.ai/releases/0.30.1/fix-watcher-permission-review-escalation-failures.md): Watcher restores Gateway permission-review decisions by correcting its default model and updates the matching self-hosting documentation. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.30.1). - [Watcher 0.32.3: Watcher Live client stays responsive when a worker stalls](https://watcher-docs.apolloresearch.ai/releases/0.32.3/watcher-live-client-stays-responsive-when-a-worker-stalls.md): Watcher Live now runs two request workers by default and no longer blocks requests during permission checks. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.32.3). - [Watcher 0.33.0: Triage auto-allow threshold rises to 8, reducing Gateway escalations](https://watcher-docs.apolloresearch.ai/releases/0.33.0/triage-auto-allow-threshold-rises-to-8-reducing-gateway-escalations.md): Watcher's Triage monitor auto-allows more low-risk tool calls before escalating, and self-hosted admins can tune that cutoff. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.33.0). - [Watcher 0.37.0: Required updates for Watcher](https://watcher-docs.apolloresearch.ai/releases/0.37.0/choose-rds-version-before-updating.md): Review the changes in this Watcher release and complete the upgrade steps that apply to your deployment. Required upgrade steps: self-hosted deployments, Watcher Cloud. [Full changelog](https://github.com/ApolloResearch/watcher-bin/releases/tag/v0.37.0).