A fast, asynchronous Zsh prompt with color ASCII indicators for Git, exit, SSH, virtual environment, and vi mode status.
agkozak-zsh-prompt is a fast, asynchronous Zsh shell prompt that displays real-time status indicators for Git, exit codes, SSH sessions, virtual environments, background jobs, and vi editing mode. It solves the problem of slow or blocking prompts by updating information asynchronously, ensuring a responsive terminal experience. The prompt is highly customizable and works across multiple platforms without requiring a specific Zsh framework.
Zsh users who want a fast, informative, and customizable shell prompt, especially those working with Git repositories, remote sessions, or virtual environments. It appeals to developers who prioritize terminal responsiveness and cross-platform compatibility.
Developers choose agkozak-zsh-prompt for its speed, reliability, and extensive customization options without framework lock-in. Its asynchronous updates prevent terminal lag, and its cross-platform support ensures consistent behavior across different operating systems.
A fast, asynchronous Zsh prompt with color ASCII indicators of Git, exit, SSH, virtual environment, and vi mode status. Framework-agnostic and customizable.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Updates Git status and indicators in the background without blocking user input, using methods like usr1 or subst-async for speed. This ensures a responsive terminal even in large repositories.
Displays real-time information for Git, exit codes, SSH sessions, virtual environments, background jobs, and vi mode. The README shows symbols for diverged branches, stashed changes, and more.
Offers extensive options via environment variables for colors, symbols, and layout, including AGKOZAK_CUSTOM_PROMPT for advanced tweaks. Examples in the README include Zenburn themes and custom Git symbols.
Works on Linux, macOS, Windows (WSL, Cygwin), and BSD, with automatic async method selection. The README confirms testing on diverse systems for reliability.
Can be used standalone or with popular Zsh frameworks like Oh My Zsh and antigen, as detailed in the installation section, avoiding vendor lock-in.
Using AGKOZAK_CUSTOM_PROMPT requires deep knowledge of Zsh prompt codes, making it intimidating for users who want fine-grained control without a steep learning curve.
Some asynchronous methods have platform-specific issues; for example, zsh-async is quirky on Solaris, and the README notes fallbacks that can affect performance or reliability in edge cases.
Focused primarily on Git status indicators, with no built-in support for other version control systems like Mercurial or SVN, limiting its utility in mixed VCS environments.
The README warns that combining options like AGKOZAK_LEFT_PROMPT_ONLY with AGKOZAK_MULTILINE=0 can be visually unappealing on slow systems or large repos, highlighting potential aesthetic compromises.