diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 8a47d03..2537c1f 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.4.0-b.3"
+  ".": "0.4.0"
 }
diff --git a/.release-please-manifest.stable.json b/.release-please-manifest.stable.json
index 0ee8c01..2537c1f 100644
--- a/.release-please-manifest.stable.json
+++ b/.release-please-manifest.stable.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.3.0"
+  ".": "0.4.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 03ab060..35954c2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,23 @@
 # CHANGELOG
 
+## [0.4.0](https://github.com/grayhatdevelopers/vidxp/compare/v0.3.0...v0.4.0) (2026-08-17)
+
+
+### Features
+
+* **codex:** install guided workflows for VidXP setup, video ingestion, evidence search, and connection to the selected local installation ([5c6552e](https://github.com/grayhatdevelopers/vidxp/commit/5c6552e4768e325a580abcffc62983d4e264bc33))
+* **desktop:** set up an existing installation or create a Desktop-managed one, choose its features, verify readiness, and control local services from the app ([8e779a3](https://github.com/grayhatdevelopers/vidxp/commit/8e779a3364670aab833668956a289415eac8652b))
+* **desktop:** ship signed, notarized, and stapled macOS installers that launch without unsigned-app Gatekeeper warnings ([4074332](https://github.com/grayhatdevelopers/vidxp/commit/40743321907c5393dc66a7e7d21a95e8dc3e602e))
+* **mcp:** upload or import videos, follow ingestion and indexing progress, and receive visual boards, keyframes, and clips with search results ([9a5a911](https://github.com/grayhatdevelopers/vidxp/commit/9a5a911bef79474e55152c62e9289023fcf10c5a))
+* **media:** show pending, ready, and failed imports across CLI, API, and MCP instead of hiding failed ingestion behind generic errors ([aa1f61e](https://github.com/grayhatdevelopers/vidxp/commit/aa1f61e4a79dcc7b08ee4a5fabc852b02b36d85e))
+* **networking:** share browser, API, and MCP services on trusted networks; API and MCP use bearer-token authentication while browser sharing remains unauthenticated ([37f3a84](https://github.com/grayhatdevelopers/vidxp/commit/37f3a84f03dcfc9022d723bac91d970352c3c1e3))
+* **search:** find actions and events across several seconds of video with Action search; enabling it downloads about 0.93 GiB and requires indexing videos with Action search selected ([8922823](https://github.com/grayhatdevelopers/vidxp/commit/89228238e748558d163663c44d331a754c6fdefe))
+
+
+### Bug Fixes
+
+* **models:** resume supported interrupted downloads, verify cached files against pinned checksums, and return actionable preparation errors ([62cb7b1](https://github.com/grayhatdevelopers/vidxp/commit/62cb7b1b2dbdfbc968435bb76101b3199a88c1f8), [69c5e51](https://github.com/grayhatdevelopers/vidxp/commit/69c5e51588c496699fe3a49b8c61a374f1058a98))
+
 ## [0.4.0-b.3](https://github.com/grayhatdevelopers/vidxp/compare/v0.4.0-b.2...v0.4.0-b.3) (2026-08-05)
 
 
diff --git a/desktop/package-lock.json b/desktop/package-lock.json
index d4f6e82..de9ef36 100644
--- a/desktop/package-lock.json
+++ b/desktop/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "vidxp-desktop",
-  "version": "0.4.0-b.3",
+  "version": "0.4.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "vidxp-desktop",
-      "version": "0.4.0-b.3",
+      "version": "0.4.0",
       "dependencies": {
         "@mantine/core": "9.5.0",
         "@tabler/icons-react": "3.46.0",
diff --git a/desktop/package.json b/desktop/package.json
index b64ffd2..f6a3004 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -1,7 +1,7 @@
 {
   "name": "vidxp-desktop",
   "private": true,
-  "version": "0.4.0-b.3",
+  "version": "0.4.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/desktop/runtime-manifest.json b/desktop/runtime-manifest.json
index 8f7d499..ba16d94 100644
--- a/desktop/runtime-manifest.json
+++ b/desktop/runtime-manifest.json
@@ -1,8 +1,8 @@
 {
   "schema_version": 1,
-  "desktop_version": "0.4.0-b.3",
+  "desktop_version": "0.4.0",
   "package_name": "vidxp",
-  "package_version": "0.4.0-b.3",
+  "package_version": "0.4.0",
   "dependency_index": "https://pypi.org/simple",
   "python_version": "3.14.6",
   "uv_version": "0.12.0",
diff --git a/desktop/src-tauri/Cargo.lock b/desktop/src-tauri/Cargo.lock
index 491d135..9665d4e 100644
--- a/desktop/src-tauri/Cargo.lock
+++ b/desktop/src-tauri/Cargo.lock
@@ -4425,7 +4425,7 @@ checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
 
 [[package]]
 name = "vidxp-desktop"
-version = "0.4.0-b.3"
+version = "0.4.0"
 dependencies = [
  "atomic-write-file",
  "hex",
diff --git a/desktop/src-tauri/Cargo.toml b/desktop/src-tauri/Cargo.toml
index 6c85b24..6400d32 100644
--- a/desktop/src-tauri/Cargo.toml
+++ b/desktop/src-tauri/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "vidxp-desktop"
-version = "0.4.0-b.3" # x-release-please-version
+version = "0.4.0" # x-release-please-version
 description = "The VidXP desktop launcher and local runtime supervisor"
 edition = "2024"
 rust-version = "1.97"
diff --git a/desktop/src-tauri/tauri.conf.json b/desktop/src-tauri/tauri.conf.json
index e4d9a19..fe905f2 100644
--- a/desktop/src-tauri/tauri.conf.json
+++ b/desktop/src-tauri/tauri.conf.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "VidXP",
-  "version": "0.4.0-b.3",
+  "version": "0.4.0",
   "identifier": "dev.grayhat.vidxp",
   "build": {
     "beforeDevCommand": "npm run dev",
diff --git a/plugins/vidxp/.codex-plugin/plugin.json b/plugins/vidxp/.codex-plugin/plugin.json
index e845b81..facf598 100644
--- a/plugins/vidxp/.codex-plugin/plugin.json
+++ b/plugins/vidxp/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "vidxp",
-  "version": "0.4.0-b.3",
+  "version": "0.4.0",
   "description": "Ingest, index, search, and inspect video evidence with VidXP.",
   "author": {
     "name": "Grayhat",
@@ -9,7 +9,12 @@
   "homepage": "https://github.com/grayhatdevelopers/vidxp",
   "repository": "https://github.com/grayhatdevelopers/vidxp",
   "license": "MIT",
-  "keywords": ["video", "search", "evidence", "mcp"],
+  "keywords": [
+    "video",
+    "search",
+    "evidence",
+    "mcp"
+  ],
   "skills": "./skills/",
   "interface": {
     "displayName": "VidXP",
@@ -17,7 +22,11 @@
     "longDescription": "Use VidXP to ingest and index videos, search dialogue and scenes, answer grounded questions, and review evidence boards, frames, and clips.",
     "developerName": "Grayhat",
     "category": "Productivity",
-    "capabilities": ["Read", "Write", "Interactive"],
+    "capabilities": [
+      "Read",
+      "Write",
+      "Interactive"
+    ],
     "websiteURL": "https://grayhat.studio/",
     "defaultPrompt": [
       "Find and verify moments in my indexed videos.",
diff --git a/pyproject.toml b/pyproject.toml
index b93c2df..fe2a0df 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "vidxp"
-version = "0.4.0-b.3"
+version = "0.4.0"
 authors = [
   { name = "Muhammad Haroon" },
   { name = "Talha Momin" },
diff --git a/uv.lock b/uv.lock
index 09296c6..f2dcccd 100644
--- a/uv.lock
+++ b/uv.lock
@@ -4172,7 +4172,7 @@ wheels = [
 
 [[package]]
 name = "vidxp"
-version = "0.4.0-b.3" # x-release-please-version
+version = "0.4.0" # x-release-please-version
 source = { editable = "." }
 dependencies = [
     { name = "dbos" },