release: 0.2.5 add repository link for PyPI users

release: 0.2.4 fix PyPI README gif rendering
merge: bring 0.2.x releases into main
2026-04-03 22:51:08 +02:00 · 2026-04-03 21:30:40 +02:00 · 2026-04-03 21:14:23 +02:00 · 2026-04-02 22:38:42 +02:00
4 changed files with 26 additions and 8 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,22 @@ 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
+- Add project demo GIF at `docs/demo.gif`
+- Show GIF demo in README
+
 ## [0.2.2] - 2026-04-02

 ### Fixed
--- a/README.md
+++ b/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

--- a/docs/demo.gif
+++ b/docs/demo.gif
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"

 [project]
 name = "cd-browser"
-version = "0.2.2"
+version = "0.2.5"
 description = "A fast keyboard-driven directory navigator for the terminal."
 readme = "README.md"
 requires-python = ">=3.8"
Author	SHA1	Message	Date
Saky	8259b2e132	release: 0.2.5 add repository link for PyPI users	2026-04-03 22:51:08 +02:00
Saky	4052c6f71f	release: 0.2.4 fix PyPI README gif rendering	2026-04-03 21:30:40 +02:00
Saky	0e94895349	merge: bring 0.2.x releases into main	2026-04-03 21:14:23 +02:00
Saky	d9cf164b2c	release: 0.2.3 add demo gif	2026-04-02 22:38:42 +02:00