git404hub

what is pretty-claude-cli fr?

srak71/pretty-claude-cli — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A themeable, animated status line for the Claude Code CLI that shows context usage as a color coded heat bar with emoji temperature stages.

vibe map

mindmap
  root((pretty-claude-cli))
    What it does
      Animated heat bar
      Emoji temperature gauge
      Shows model and time left
      Per device colors
    Tech stack
      Python
      Bash
      PowerShell
    Use cases
      Customize Claude Code status line
      Track context usage visually
      Differentiate machines by color
      Theme via config file
    Audience
      Claude Code users
      Developers
    Platforms
      macOS
      Linux
      Windows 11

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Replace Claude Code's default status line with an animated, color coded one.

VIBE 2

Watch context window usage rise through emoji stages as a session fills up.

VIBE 3

Give different machines their own color scheme based on hostname.

VIBE 4

Customize colors, emoji, and bar speed entirely through one config file.

what's the stack?

PythonBashPowerShell

how it stacks up fr

srak71/pretty-claude-cli0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Python 3 on PATH and a terminal with 24-bit truecolor and emoji support.

Released under the MIT license, so it can be used, modified, and redistributed freely, including for commercial purposes, as long as the copyright notice is kept.

in plain english

pretty-claude-cli is a colorful, animated status line for the Claude Code command line tool. It replaces the plain default bar with an at a glance strip showing your operating system, current working directory, a live context window usage bar, your plan, the active model, and the time left until your session window resets. The centerpiece is a heat bar: an animated rainbow progress bar for how much of the context window you have used, paired with an emoji temperature gauge that moves from an ice cube through a thermometer, fire, an explosion, and finally a radioactive symbol as usage climbs. The model name flows with the same moving color gradient as the bar. Each machine can pick its own color palette automatically based on its hostname, so a laptop and a server look different at a glance, and the whole thing runs cross platform on macOS, Linux, and Windows 11 using one pure Python core with no extra dependencies. Everything about the look lives in a single INI config file: colors, the separator character, the emoji sequence and the usage thresholds that trigger each one, and the bar's speed, width, and vibrancy. The script itself never needs to be edited to change the appearance. Installing it on macOS or Linux runs a shell script, and on Windows a PowerShell script, either of which copies the status line into place and adds the right entry to Claude Code's settings file automatically. Under the hood, Claude Code sends session data as JSON to a small launcher script, which locates Python and hands the JSON to the main script. That script detects the operating system, loads your config file, and prints one colored line, with no background process running at any point. It is released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through installing pretty-claude-cli for Claude Code on my Mac.
prompt 2
How do I set a different device_color for my Windows PC in pretty-claude-cli?
prompt 3
Explain how the heat_thresholds setting changes when the emoji gauge switches stages.
prompt 4
Show me how to uninstall pretty-claude-cli without losing my config.

Frequently asked questions

what is pretty-claude-cli fr?

A themeable, animated status line for the Claude Code CLI that shows context usage as a color coded heat bar with emoji temperature stages.

What language is pretty-claude-cli written in?

Mainly Python. The stack also includes Python, Bash, PowerShell.

What license does pretty-claude-cli use?

Released under the MIT license, so it can be used, modified, and redistributed freely, including for commercial purposes, as long as the copyright notice is kept.

How hard is pretty-claude-cli to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pretty-claude-cli for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.