diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2ff6dca..05d44a4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,8 @@ All notable changes to lcode are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-10-01
+
 ### Added
 
 - An optional sandbox for shell commands: with `lcode --sandbox` (or `sandbox = "docker"` /
@@ -184,7 +186,8 @@ First public release.
 - `AGENTS.md` project instructions and `/init` to generate them.
 - One-line installer for Linux and macOS.
 
-[Unreleased]: https://github.com/nasser1941/lcode/compare/v0.4.1...HEAD
+[Unreleased]: https://github.com/nasser1941/lcode/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/nasser1941/lcode/compare/v0.4.1...v0.5.0
 [0.4.1]: https://github.com/nasser1941/lcode/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/nasser1941/lcode/compare/v0.3.1...v0.4.0
 [0.3.1]: https://github.com/nasser1941/lcode/compare/v0.3.0...v0.3.1
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 5fc1b5c..ee03c69 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -12,7 +12,7 @@ lcode
 
 ```text
 ╭──────────────────────────────────────────────╮
-│ lcode v0.4.1 — local coding agent            │
+│ lcode v0.5.0 — local coding agent            │
 │                                              │
 │ model    lcode-qwen3.6-35b                   │
 │ context  256K tokens                         │
diff --git a/src/lcode/__init__.py b/src/lcode/__init__.py
index 66f2aa3..89f574b 100644
--- a/src/lcode/__init__.py
+++ b/src/lcode/__init__.py
@@ -1,3 +1,3 @@
 """lcode — a local-first terminal coding agent powered by open-weight models via Ollama."""
 
-__version__ = "0.4.1"
+__version__ = "0.5.0"