diff --git a/CHANGELOG.md b/CHANGELOG.md
index fd2f135..65f082a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,10 @@ All notable changes to Reflex Control are documented here.
 
 ## Unreleased
 
+## 0.5.0 - 2026-10-02
+
+- Added `reflex demo agent`: a styled walkthrough of six simulated agent steps (an edit, two protected writes, a force push, failing and then passing tests) with each decision taken by the real hook engine; no API key needed.
+
 - Fixed shell protected-path checks to resolve relative write targets against the agent's working directory across all shell adapters, falling back to the project root when unknown.
 
 - Added agent hooks for OpenCode, Kilo Code, Cline and pi. OpenCode, Kilo Code and pi get a small plugin or extension file (embedded in `reflex`, source in `integrations/`) that relays tool calls and finished turns to `reflex hook`; Cline gets a `PreToolUse` script. Cline has no hook that can send the agent back, so it is guarded before tool calls only; OpenCode, Kilo Code and Cline cannot ask for confirmation, so a risky command is refused (OpenCode and Kilo let the same call through when the agent repeats it). See `docs/agent-hooks.md`.
diff --git a/Cargo.lock b/Cargo.lock
index 34f9aab..ad2e928 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -317,7 +317,7 @@ dependencies = [
 
 [[package]]
 name = "example-agent-runtime-gate"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "reflex-core",
  "reflex-policy",
@@ -327,7 +327,7 @@ dependencies = [
 
 [[package]]
 name = "example-shadow-mode"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "reflex-core",
@@ -341,7 +341,7 @@ dependencies = [
 
 [[package]]
 name = "example-verifier-gate"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "reflex-core",
  "reflex-policy",
@@ -1143,7 +1143,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-calibration"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "reflex-core",
  "reflex-telemetry",
@@ -1154,7 +1154,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-cli"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "clap",
@@ -1177,7 +1177,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-core"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "serde",
@@ -1188,7 +1188,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-hooks"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "dirs",
  "globset",
@@ -1203,7 +1203,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-jev"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "async-trait",
  "reflex-core",
@@ -1217,7 +1217,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-policy"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "reflex-core",
  "serde",
@@ -1227,7 +1227,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-provider"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "async-trait",
  "rand 0.8.8",
@@ -1240,7 +1240,7 @@ dependencies = [
 
 [[package]]
 name = "reflex-telemetry"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "chrono",
  "reflex-core",
diff --git a/Cargo.toml b/Cargo.toml
index babb41a..c90ad18 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -15,7 +15,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.4.0"
+version = "0.5.0"
 edition = "2021"
 rust-version = "1.88"
 authors = ["Reflex Control Authors"]
diff --git a/README.md b/README.md
index 7f100b8..55d8a75 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ Reflex Control decides whether an AI task can finish on its own, retry, or escal
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
 > [!NOTE]
-> **Status:** Research prototype (v0.4.0). Tested on synthetic fixtures; not production-validated.
+> **Status:** Research prototype (v0.5.0). Tested on synthetic fixtures; not production-validated.
 
 ![Reflex Control guarding a simulated coding agent: two protected files, a force push and failing tests](docs/demo/agent.gif)