---
name: "liquidprompt"
section: "1"
platform: "linux"
package: "liquidprompt"
version: "2.2.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/liquidprompt"
---

# liquidprompt(1)

A full-featured & carefully designed adaptive prompt for bash & zsh

## NAME

liquidprompt - A full-featured & carefully designed adaptive prompt for bash & zsh

## DESCRIPTION

Liquid Prompt gives you a nicely displayed prompt with useful information when you need it. It shows you what you need when you need it. You will notice what changes when it changes, saving time and frustration.\
 You can even use it with your favorite shell – **[bash(1)](/bash/1.md)** or **[zsh(1)](/zsh/1.md)**.

## ACTIVATION

The liquidprompt package has no way to know which users do you want this prompt to be active for. A small script, **liquidprompt\_activate** is included to ease activation of the prompt.

This will set the required environment:

```
	* The files ~/.bashrc and/or ~/.zshrc are modified to load liquidprompt at startup.
	* If no previous ~/.config/liquidpromptrc file exists, it will be created.
```

So, to get liquidprompt working simply run:

```
	user@debian:~$ liquidprompt_activate
	user@debian:~$ source ~/.bashrc
```

Be aware that multiple invocations of the **liquidprompt\_activate** command may pollute **~/.bashrc** and/or **~/.zshrc** files.

## FUNCTIONS

Once liquidprompt has been loaded, you will have 4 new commands available (which are shell functions actually).

- **liquidprompt\_tag tag**

  tag current shell liquidprompt with *tag*.

- **liquidprompt\_OFF**

  use an empty prompt, just the $ mark.

- **liquidprompt\_off**

  turn off liquidprompt for this shell.

- **liquidprompt\_on**

  turn on liquidprompt for this shell.

## CONFIGURATION

liquidprompt is highly configurable. There are plenty of options regarding style, performance, VCS, et all.\
 Please take a look at the included README file at **/usr/share/doc/liquidprompt/** and the file **~/.config/liquidpromptrc** as well.

## SEE ALSO

**https://liquidprompt.readthedocs.io/**, **[bash(1)](/bash/1.md)**, **[zsh(1)](/zsh/1.md)**

## ABOUT

liquidprompt was originally developed by **nojhan \<nojhan@nojhan.net\>**. Visit the source code at **https://github.com/nojhan/liquidprompt**.\
 This manpage was written by Arturo Borrero Gonzalez \<arturo@debian.org\> for the Debian GNU/Linux distribution (but it may be used by others).