A minimal and extensible Zsh theme with a component-based architecture for custom prompts.
Minimal is a Zsh theme that provides a clean, customizable prompt for terminal users. It solves the problem of overly complex or inflexible shell themes by offering a modular system where users can pick and arrange components like status indicators, directory displays, and version control info. It focuses on staying out of the way while allowing deep personalization.
Zsh users who want a lightweight, aesthetically simple prompt that they can tailor extensively without digging into low-level Zsh configuration. It's ideal for developers and power users who spend significant time in the terminal and value both minimalism and control.
Developers choose Minimal over other Zsh themes because it combines a minimalist aesthetic with a powerful, component-based architecture. Unlike monolithic themes, it lets users build their prompt piece by piece, and its 'magic enter' feature adds useful context without cluttering the prompt itself.
A minimal zsh theme
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Prompts are assembled from independent shell functions like mnml_status and mnml_git, allowing users to pick and place elements without touching core code, as shown in the MNML_PROMPT array configuration.
Global settings (e.g., MNML_OK_COLOR) and arrays define colors, characters, and layout, enabling fine-grained adjustments to match personal preferences or workflow needs.
Configurable actions like mnml_me_ls or mnml_me_git trigger on pressing Enter with an empty command line, adding contextual information without permanent prompt clutter.
Users can write custom shell functions and integrate them into prompt arrays, as demonstrated in the custom components example, making it simple to add new features.
Setting up requires editing Zsh arrays and understanding shell scripting, which can be intimidating for users unfamiliar with terminal customization or Zsh internals.
Some components, like mnml_hg, are admitted to be slow due to launching a Python interpreter, potentially impacting prompt responsiveness in certain workflows.
Out of the box, the theme is starkly minimal and lacks visual flair; achieving a polished look demands significant time investment in tweaking settings and components.
The theme is built specifically for Zsh and cannot be used with other shells like Bash or Fish, limiting its applicability in mixed-shell environments.