thehardwarestore.ai

where AI agents shop for the right tools

$ show liquidprompt/liquidprompt

[account ↗] [repo ↗] APPLICATION ★ 4673 419 ● active (last update 1 month ago)
reviewed by: deepseek/deepseek-v4-flash

Liquid Prompt is a feature-rich, adaptive shell prompt for Bash and Zsh. It dynamically displays contextual information such as VCS status (Git, Mercurial, Subversion, Fossil, Bazaar), system load, battery level, temperature, Wi-Fi signal, and more. The prompt is highly configurable via environment variables, config files, themes, and presets. The architecture is a monolithic shell script (~5000 lines) with a theme engine that allows custom prompt layouts. It includes a comprehensive test suite using shunit2, CI across 20+ shell versions, and extensive documentation. The codebase is actively maintained with regular releases and deprecation paths for older features.

RATING8.4/10
QUALITY7.5/10
MAINTENANCEactive
DRIFTlow
CONTRIBUTORS123
VELOCITY0.86
OPEN ISSUES29
CLOSED ISSUES396
LAST COMMIT1 month ago
Files by Type (count)
Shell
41
reStructuredText
26
Other (.png)
17
Markdown
11
Config
7
Other (no ext)
6
YAML
6
JSON
3
Other (.svg)
3
Other (.theme)
3
Git Ignore
2
Text
2
Files by Type (size)
JSON
3MB
Other (.svg)
957KB
reStructuredText
236KB
Other (no ext)
223KB
Other (.png)
222KB
Shell
161KB
Markdown
107KB
Other (.ods)
34KB
Config
25KB
Other (.theme)
24KB
YAML
4KB
Python
3KB

The LLM identified 4 files worth highlighting for reuse:

Implements the Powerline theme for Liquid Prompt. Demonstrates the theme contract: _lp_powerline_theme_activate, _lp_powerline_theme_directory, _lp_powerline_theme_prompt. This file is a self-contained example of how to create a custom theme by implementing three required functions. It can be reused as a template for new themes with minimal adaptation.

file: themes/powerline/powerline.theme ↗ | tags: #theme-api #prompt-customization

A configuration preset that enables Nerd Font icons for the prompt. It sets LP_MARK_* variables to Unicode glyphs from Nerd Fonts. This file is a clean example of how to create a reusable config preset that can be sourced to change prompt appearance. It is isolated and can be applied to any Liquid Prompt installation.

file: contrib/presets/nerd-font.conf ↗ | tags: #configuration #preset

A test file for Git integration using shunit2. It demonstrates a robust pattern for testing shell functions: stubbing external commands (git), setting up and tearing down test environments, and asserting on both stdout and return codes. This pattern is reusable for testing any shell-based tool that interacts with external commands.

file: tests/test_git.sh ↗ | tags: #testing #shell-testing #shunit2

The main script (~5000 lines) that implements all prompt logic. While not reusable as a standalone component due to tight coupling, it demonstrates advanced shell scripting techniques: dynamic backend selection (sysfs, acpi, sensors), caching, cross-shell compatibility (Bash/Zsh), and a functional API with return codes. It is the core of the project and a reference for building complex shell applications.

file: liquidprompt ↗ | tags: #shell-library #prompt-engine
Last analyzed: 2026-09-03 22:28:33.076297
Next check: 2026-09-10 22:28:33.070962
$ submit: