release: 0.2.5 add repository link for PyPI users

CHANGELOG.md

@@ -4,6 +4,16 @@ 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
+- Use absolute demo GIF URL in README so image renders correctly on PyPI
+
 ## [0.2.3] - 2026-04-02
 
 ### Added

README.md

@@ -5,7 +5,9 @@
 `cd-browser` is a fast keyboard-driven directory navigator for the terminal.
 It lets you explore directory trees visually and jump to any folder instantly.
 
-![cd-browser demo](docs/demo.gif)
+![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?
 
@@ -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
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cd-browser"
-version = "0.2.3"
+version = "0.2.5"
 description = "A fast keyboard-driven directory navigator for the terminal."
 readme = "README.md"
 requires-python = ">=3.8"