# liquidprompt/liquidprompt

A full-featured & carefully designed adaptive prompt for Bash & Zsh

Repository: https://github.com/liquidprompt/liquidprompt
Canonical: https://ross.abutalabs.com/products/liquidprompt
Homepage: https://liquidprompt.readthedocs.io/
Language: Shell
License: AGPL-3.0
License Family: copyleft
Topics: zsh, bash, prompt, linux-shell, powerline, shell-prompt, shell-theme, prompt-toolkit, prompt-tuning
Last push: 2026-08-23T15:30:56+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 60, longevity 100
- inputs: {"age_days": 5158, "days_push": 10, "days_rel": 59, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4675, forks 419 (observed 2026-08-28T04:08:56.704694+00:00)

## What it is
Liquid Prompt is an adaptive, carefully designed shell prompt for Bash and Zsh, written in portable Shell. It displays contextual, useful information (git status, battery, load, etc.) with minimal visual clutter and is highly configurable via simple key/value settings.

## Use cases
- show a smart adaptive prompt in bash and zsh
- display git branch and repo status in my shell prompt
- get a powerline-style prompt theme for my terminal
- see system status like load and battery in the prompt
- customize my shell prompt without learning a complex config format
- make my terminal prompt show information only when relevant

## When to choose
- you use Bash or Zsh and want a well-designed, informative prompt
- you want a prompt that adapts contextually instead of showing everything at once
- you prefer simple text-file configuration over DSLs
- you want a pure-Shell solution with no heavy dependencies

## When to avoid
- you use a shell other than Bash or Zsh, like Fish or Nushell
- you want a prompt framework with a rich plugin/theme ecosystem in another language
- you prefer minimal default prompts with no extra status information

## Facets
- artifact type: plugin
- maturity: stable
- function: developer-tools, terminal-ui, theme
- domain: developer-tools
- platform: cli, cross-platform
- tags: shell-prompt, bash, zsh, powerline, shell-theme, command-line, linux, macos

## Member repositories
- liquidprompt/liquidprompt (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:56.704694+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:19:21.743897+00:00, confidence not recorded.
  - readme: https://github.com/liquidprompt/liquidprompt (fetched 2026-08-28T04:08:56.704694+00:00, sha 9c852ef24a97)
- Data as of 2026-08-30T08:39:29.467469+00:00.