Skip to content

Compozsh 1.1.0 — Fuzzy Discovery and Navigation

Choose a tag to compare

View all tags
@bitbemol bitbemol released this 27 Aug 02:10
· 14 commits to main since this release
1.1.0
1b76120
This commit was signed with the committer’s verified signature.
bitbemol Bemol
SSH Key Fingerprint: l80ao9aLxQrNuA9KHXfPXUaqhy8vn5pftIv7d83++Qg
Verified
Learn about vigilant mode.

Highlights

Compozsh now brings its fuzzy, interactive interface to tool discovery, file search, and directory navigation—while remaining native Zsh with no plugins, package managers, or external runtime dependencies.

Added

  • Added hierarchical fuzzy directory completion with interactive drill-down.
  • Added f, a bounded fuzzy finder for files and directories with project, current-directory, custom-root, home, and global Spotlight scopes.
  • Added compozsh, a live tool explorer that automatically discovers public commands from loaded add-ons.
  • Added consistent, side-effect-free --help documentation to every shipped public Compozsh command.
  • Added cpdir to copy the exact current working directory to the macOS clipboard.
  • Added semantic native output colors for Git, grep, and man.

Tool discovery

Run the new interactive explorer:

compozsh

Every loaded public add-on command appears automatically. Search fuzzily, select a command, and view its documentation without executing it.

Noninteractive forms are also available:

compozsh --list
compozsh help f

The catalog is regenerated from live Zsh function metadata. It requires no registry, cache, loading order, or manual registration, and it automatically includes compatible user-defined add-on commands.

File discovery

Search interactively from the current Git project or directory:

f query

Additional scopes and machine-readable output are available through:

f --help

Results are bounded, safely shell-quoted, and never opened or executed implicitly.

Architecture and quality

  • Preserved independent, order-agnostic add-on loading.
  • Centralized help providers so direct and explorer documentation cannot drift.
  • Kept help inspection free of filesystem writes, navigation, prompts, network access, and optional-tool detection.
  • Clarified picker cursor and file-type glyphs in the documentation.
  • Expanded the native Zsh test suite from 52 to 78 passing tests.
  • Added regression coverage for discovery, help safety, fuzzy search, output colors, navigation, and clipboard behavior.

Updating

For the recommended symlink installation:

git -C "$repo_dir" pull --ff-only
exec zsh

For a copied installation:

git -C "$repo_dir" pull --ff-only
zsh "$repo_dir/install.zsh" --copy
exec zsh
Assets 2
Loading