# Changelog

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.3.0] - 2026-04-06

### Added
- Two-line compact header with live session state: version, history count, filter state, hidden/files toggles, and development summary
- Persistent history storage between sessions with configurable state path and bounded history size
- History list rendering in most-recent-first order
- History filter mode (`/` inside history) with dedicated query and navigation behavior
- Development info panel (`i`) with git context, detected stack, and suggested commands
- Configurable open-with menu order via `config.toml`:
  - `open_with.files`
  - `open_with.directories`
- Automatic creation of opener config template when `config.toml` is missing
- New `opencode` opener support for directory actions

### Improved
- Filter label highlighting now works consistently in both tree and history filter modes
- UI color behavior is now explicitly normalized to avoid terminal color bleeding
- History selection and filtering logic aligned with reversed (most-recent-first) history rendering

## [0.2.6] - 2026-04-04

### Added
- Incremental filter workflow (`/`) with contextual Enter behavior:
  - Directories navigate in-place
  - Files open the app menu
- File visibility toggle (`a`) to switch between directories-only and mixed view
- Open-with app menu (`o`) with arrow-key selection (`↑`/`↓`, `Enter`, `Esc`)
- New opener support for `nano`, `less`, and `bat` for file actions
- Blocking terminal app execution with UI state restore after exit

### Improved
- Open-with options are now context-aware (GUI/headless, file/directory) and only shown when executables are available
- Better handling of paths containing spaces when launching openers
- Extended README with full controls reference and platform compatibility guidance

## [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
- Include `cd_browser_post_install.py` in wheel/sdist so `cd_browser_post_install` works after `pip install`

## [0.2.1] - 2026-04-02

### Fixed
- Prevent crashes when scanning directories with restricted permissions
- Handle non-interactive post-install runs without failing on EOF
- Fix shell reload message interpolation in post-install output

### Improved
- Make post-install shell integration idempotent (avoid duplicate `cd_()` entries)
- Add test coverage for permission errors and post-install flows
- Update default application name to `cd-browser`

## [0.2.0] - 2026-04-02

### Added
- Interactive post-install script (`cd_browser_post_install`) for automatic shell integration
- Option to automatically add `cd_()` function to ~/.bashrc or ~/.zshrc during installation
- Improved uninstall instructions in README

### Improved
- Installation UX: clearer setup process with user prompts
- Shell integration: better guidance for enabling `cd_` command

### Added
- Initial release of **cd-browser**
- Terminal-based directory navigation
- Interactive directory tree navigation
- History navigation mode