PySH logo
PySH

Prompt Themes

Under Construction

Configure and customize the PySH shell prompt appearance.

Note: The PySH theme system is actively being developed. Additional themes and a theme builder will be added in upcoming releases.

Available themes

  • ✓"modern" — Default theme. Shows Python version, tool versions, git branch, and a colored path.
  • ✓"minimal" — Clean single-line prompt. Shows only current directory and Python version.
  • ✓"classic" — Traditional Unix-style prompt with user@host format.

Setting the theme

~/.pysh.toml

[prompt]

theme = "modern"

Custom prompt elements

Each theme supports toggling individual elements. Set any of the following keys to false in the [prompt] section to hide them:

  • ✓show_python — Python version (e.g., py3.13)
  • ✓show_tools — Active tool versions (uv, ruff, etc.)
  • ✓show_directory — Current working directory
  • ✓show_git_branch — Active git branch
  • ✓show_virtualenv — Active virtual environment name
Minimal prompt configuration

[prompt]

theme = "minimal"

show_python = true

show_tools = false

show_git_branch = true