diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7abf00c..b853e29 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
 
 The format is based on Keep a Changelog, and this project follows Semantic Versioning.
 
+## [0.2.5] - 2026-04-03
+
+### Improved
+- Add explicit repository link in README for PyPI users to access the full demo and documentation
+
 ## [0.2.4] - 2026-04-03
 
 ### Fixed
diff --git a/README.md b/README.md
index d1cb30e..e538961 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,8 @@ It lets you explore directory trees visually and jump to any folder instantly.
 
 ![cd-browser demo](https://gitea.sakydogalo.es/saky/cd-browser/raw/branch/main/docs/demo.gif)
 
+Repository (full demo + docs): https://gitea.sakydogalo.es/saky/cd-browser
+
 ## Why cd-browser?
 
 Working in the terminal often means:
@@ -19,14 +21,14 @@ Working in the terminal often means:
 
 ## Features
 
-- 🚀 Fast visual navigation of directory trees
-- ⌨️ Fully keyboard-driven workflow
-- 🌲 Expand and collapse directories
-- 📜 Navigation history inside the session
+- ⌨️ Fully keyboard-driven workflow (`↑` / `↓` / `←` / `→`)
+- 🌲 Expand and collapse directories (`→` to expand/enter, `←` to collapse/back)
+- 📜 Navigation history inside the session (`h` history mode, `b` back, `f` forward)
+- ⚡ Returns the selected path to the shell (`Enter` to confirm, `Esc` to cancel)
+- 🔎 Press `.` to toggle hidden directories
 - 🖥 Native terminal interface
 - 🔁 Works with Bash, Zsh and other shells
-- ⚡ Returns the selected path to the shell
-- 🔎 Press `.` to toggle hidden directories
+- 🚀 Fast visual navigation of directory trees
 
 ## Quick Demo
 
diff --git a/pyproject.toml b/pyproject.toml
index 99ef5ec..bea9776 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cd-browser"
-version = "0.2.4"
+version = "0.2.5"
 description = "A fast keyboard-driven directory navigator for the terminal."
 readme = "README.md"
 requires-python = ">=3.8"