Compozsh 2.0 brings browsing, recent folders, scoped search, and file actions together in one responsive filesystem workspace.
Start from a place
- Type
~/,./,/, or another directory path and press Tab to browse. - Press Option-Tab at the prompt to recall recently visited folders.
- Press Ctrl-F inside the workspace to search beneath the displayed folder.
- Select a file to open its contextual actions: Open with default app, Reveal in Finder, Copy path, or Insert path.
Directory selection returns a quoted, editable path to the prompt. Review it and press Enter to change directory.
Clearer search
Search defaults to Git inside repositories, Spotlight at home/root on macOS, and bounded filesystem discovery elsewhere.
The workspace displays its source, scope, and “Searching…” status before capture. Source failures are reported explicitly. Filtering captured results stays separate from discovery.
A cohesive full-screen experience
- Shared layouts across filesystem navigation, Git branches, history, and tool help.
- Dedicated titles and input rows, primary result lists, and responsive detail panels.
- Scrolling through additional results with visible-number selection.
- Restored filters and selections when navigating back.
- Continuous screen transitions and improved resize cleanup.
- Consistent Control shortcuts and a contextual Ctrl-K keyboard guide.
cpdir also highlights the displayed path while keeping clipboard contents plain.
Migrating from 1.x
This release removes d and f:
- Replace
dwith Option-Tab; use nativedirs -vfor a textual stack. - Replace
fwith path + Tab → Ctrl-F. - Replace scripting uses of
f --listandf --print0with nativefind,git ls-files, ormdfind. gremains the dedicated Git branch workspace.
Enable Use Option as Meta key in your Terminal profile for Option-Tab.
For symlink installations, pull the repository and run exec zsh. Copy installations must also rerun the copy installer. Personal configuration remains separate; update any private aliases that referenced retired commands.
Documentation and verification
The website now demonstrates Browse, Recents, scoped search, and file actions with safe interactive examples. README and contributor guidance document the new workflow.
Verified with 157 native shell tests, 7 website tests, and responsive browser checks.
Still built with native Zsh 5.9 and macOS tools, with no new runtime dependencies.
Full changelog: 1.2.0...2.0.0