release: 0.3.0 persistent history, configurable openers, and dev info panel

README.md

@@ -23,12 +23,15 @@ Working in the terminal often means:
 
 - ⌨️ 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)
+- 📜 Persistent history between sessions (`h` history mode, `b` back, `f` forward)
 - 🔎 Incremental filter mode (`/`, type to filter, `Backspace`, `Esc`)
+- 🧭 History filter mode (`/` inside history) with most-recent-first ordering
 - 📄 Toggle file visibility (`a`) to switch between directories-only and mixed view
 - ⚡ Fast jumps in large lists (`PgUp`/`PgDn`, `Home`/`End`, `g`/`G` in normal mode)
 - 🚀 Contextual `open with` menu (`o`) with app detection based on your environment
 - 🔁 Blocking terminal editors restore the UI state when they exit (`nvim`, `nano`, `less`, `bat`)
+- 🧩 Configurable app menu via `config.toml` with automatic template creation
+- 🛠 Development snapshot in header + detailed info panel (`i`)
 - 👀 Toggle hidden entries with `.`
 - 🖥 Native terminal interface
 - 🔁 Works with Bash, Zsh and other shells
@@ -49,6 +52,7 @@ Normal mode:
 - `a`: Toggle file visibility
 - `/`: Enter filter mode
 - `o`: Open selected entry with an app
+- `i`: Toggle development info panel
 - `PgUp` / `PgDn`: Page jump
 - `Home` / `End`: Jump to first/last entry
 - `g` / `G`: Jump to first/last entry
@@ -65,10 +69,19 @@ Filter mode:
 
 History mode:
 
-- `↑` / `↓`: Move through history entries
+- `↑` / `↓`: Move through history entries (most recent at top)
 - `Enter`: Jump to selected history path
 - `Esc` or `h`: Exit history mode
 - `PgUp` / `PgDn`, `Home` / `End`: Fast history navigation
+- `/`: Enter history filter mode
+
+History filter mode:
+
+- Type text: Filter history entries in real time (case-insensitive)
+- `↑` / `↓`: Move inside filtered history results
+- `Enter`: Jump to selected history path
+- `Esc`: Exit history filter mode and clear query
+- `Backspace`: Remove last filter character
 
 Open with menu (`o`):
 
@@ -79,7 +92,26 @@ Open with menu (`o`):
 The menu only shows apps available in your system (`PATH`) and context:
 
 - GUI options (when GUI is available): `code`, system `open`/`xdg-open`
-- Terminal options: `antigravity`, `nvim`, `nano`, `less`, `bat` (as applicable)
+- Terminal options: `antigravity`, `opencode`, `nvim`, `nano`, `less`, `bat` (as applicable)
+
+## Opener Configuration
+
+`cd-browser` reads opener settings from:
+
+- macOS/Linux: `~/.config/cd-browser/config.toml`
+- Windows: `%APPDATA%/cd-browser/config.toml`
+
+If the file does not exist, `cd-browser` creates it automatically with defaults.
+
+Example:
+
+```toml
+[open_with]
+files = ["code", "open", "antigravity", "nvim", "nano", "less", "bat"]
+directories = ["code", "opencode", "antigravity", "nvim"]
+```
+
+You can reorder or remove entries to customize app priority.
 
 ## Quick Demo