Skip to content

Compozsh 1.2.0 — Clearer Help, Interactive Showcase

Choose a tag to compare

View all tags
@bitbemol bitbemol released this 27 Aug 20:48
· 11 commits to main since this release
1.2.0
fcdfda9
This commit was signed with the committer’s verified signature.
bitbemol Bemol
SSH Key Fingerprint: l80ao9aLxQrNuA9KHXfPXUaqhy8vn5pftIv7d83++Qg
Verified
Learn about vigilant mode.

Compozsh 1.2.0 makes its tools easier to learn, with comprehensive command guides, semantic help colors, and a new interactive website.

Clearer command help

  • Expanded every shipped Compozsh command’s --help with relevant defaults, examples, prerequisites, controls, and safety boundaries.
  • Clarified how f chooses its search scope, how fuzzy matching works, and why traversal limits or Spotlight indexing can affect results.
  • Documented directory and branch picker sources, selection behavior, clipboard actions, and fallbacks.
  • Expanded installation guidance for symlink and copy modes, updates, private configuration, and recovery.
  • Kept direct command help and the compozsh tool explorer connected to the same documentation.

Semantic help colors

  • Added consistent emphasis for headings, options, examples, and safety information through the shared output palette.
  • Preserved identical plain text in pipes, redirects, command substitutions, and unsupported terminals.
  • Respected NO_COLOR and retained plain help when the output add-on is disabled.
  • Kept help rendering free of external commands and documentation evaluation.

Interactive website

Explore the Compozsh website through five task-focused demonstrations: Context, History, Files, Navigate, and Tools.

The site includes searchable sample pickers, architecture explanations, and installation guidance. Demonstrations use synthetic data and run entirely in the browser.

Quality and compatibility

  • Expanded the native Zsh suite from 78 to 86 passing tests.
  • Added terminal-based coverage for help colors, exact plain-text fallbacks, and safe palette handling.
  • Preserved independently loadable, order-independent add-ons.
  • No breaking changes or new shell runtime dependencies.

Updating

From your Compozsh clone, run git pull --ff-only.

For a copied installation, also run zsh install.zsh --copy. After updating, open a new terminal or run exec zsh.

Your private initializer and personal add-ons remain separate from the shared configuration.

Full changelog: 1.1.0...1.2.0

Assets 2
Loading