Skip to main content
The Starship configuration customizes your command-line prompt with a minimal, elegant design using lambda symbols.

​
Overview

This configuration:
  • Customizes the prompt character to use the lambda symbol (λ)
  • Shows green lambda for successful commands
  • Shows red lambda for failed commands
  • Maintains Starship’s smart defaults for everything else

​
Configuration File

starship.toml
[character]
success_symbol = "[λ](bold green)"
error_symbol = "[λ](bold red)"

​
Prompt Character

The [character] section customizes the prompt symbol that appears before your cursor.

​
Success Symbol

success_symbol = "[λ](bold green)"
When the previous command exits successfully (exit code 0), the prompt displays a bold green lambda (λ) symbol. 
λ git status  # Previous command succeeded

​
Error Symbol

error_symbol = "[λ](bold red)"
When the previous command fails (non-zero exit code), the prompt displays a bold red lambda (λ) symbol, providing immediate visual feedback. 
λ cat nonexistent.txt
cat: nonexistent.txt: No such file or directory
λ # Red lambda indicates the error
The lambda (λ) symbol is commonly used in functional programming and mathematics, representing abstraction and functions. It’s a popular choice for developer prompts due to its minimalist aesthetic.

​
Visual Examples

λ echo "Hello, World!"
Hello, World!
λ  # Green lambda
The green lambda indicates the echo command completed successfully.

​
Default Features

While this configuration only customizes the prompt character, Starship automatically provides:

Git Integration

Shows current branch, modified files, and repository status without additional configuration.

Language Versions

Displays versions for detected languages and tools (Node.js, Python, Ruby, etc.).

Directory Path

Shows current directory with smart truncation for deep paths.

Execution Time

Displays command execution time for long-running commands.

​
Minimal Philosophy

This configuration follows a minimal approach:
Starship’s defaults are excellent for most use cases. By only changing the prompt character, you get:
  • All of Starship’s intelligent context detection
  • Automatic language and tool version display
  • Git integration without manual configuration
  • A unique personal touch with the lambda symbol
The lambda symbol:
  • Is concise and doesn’t take up much space
  • Has cultural significance in programming (lambda calculus, anonymous functions)
  • Looks clean and professional
  • Is easily distinguishable from command output
  • Green: Positive feedback, command succeeded
  • Red: Alert, something failed and may need attention
  • Bold: Makes the prompt character stand out from surrounding text

​
Customization Examples

If you want to extend the configuration, here are some popular options: 
[directory]
truncation_length = 3
truncate_to_repo = true

​
Installation

The Starship configuration is symlinked during setup: 
ln -sf "$DOTFILES_DIR/starship.toml" "$HOME/.config/starship.toml"
Starship must also be initialized in your shell. See the Shell Configuration page: 
eval "$(starship init zsh)"

​
Testing Changes

After modifying starship.toml, the changes take effect immediately in new shell sessions. To test in your current session: 
# Reload shell configuration
source ~/.zshrc

# Or just start a new shell
exec zsh
Use starship config to quickly open the configuration file in your default editor.

​
Full Documentation

For complete Starship customization options, see the official documentation:

Build docs developers (and LLMs) love

Get started for freeTalk to us