barista.conf

# =============================================================================
# Barista Configuration ☕
# =============================================================================
# Serving up fresh stats for Claude Code
# Comprehensive configuration for all modules
# Edit this file to customize your brew
# =============================================================================

# =============================================================================
# GLOBAL SETTINGS
# =============================================================================

# Section separator between modules
SEPARATOR=" | "

# Global display mode: "normal", "compact", "verbose"
# - normal: balanced display with icons and key info
# - compact: minimal display, shorter text, fewer details
# - verbose: full display with all available information
DISPLAY_MODE="normal"

# Color theme: "default", "minimal", "vibrant", "monochrome", "nerd"
# - default:    Standard emoji icons and colored status indicators (🟢🟡🔴)
# - minimal:    Subtle geometric shapes, simple icons (◦ ◐ → ⎇)
# - vibrant:    Bold, expressive emoji with heart colors (💚💛🧡❤️)
# - monochrome: Pure ASCII, no emoji or colors ([OK] [~~] [!!] [XX])
# - nerd:       Nerd Font icons (requires Nerd Font installed)
COLOR_THEME="default"

# Enable/disable all icons globally (individual modules can override)
USE_ICONS="true"

# Enable/disable status indicators (colored dots/emoji)
USE_STATUS_INDICATORS="true"

# Global status indicator style: "emoji", "ascii", "dots"
# - emoji: 🟢 🟡 🔴
# - ascii: [OK] [WARN] [CRIT]
# - dots:  ● ● ●  (colored if terminal supports)
STATUS_STYLE="emoji"

# Custom status indicators (used when STATUS_STYLE="emoji")
STATUS_GREEN="🟢"
STATUS_YELLOW="🟡"
STATUS_RED="🔴"

# =============================================================================
# PROGRESS BAR SETTINGS (used by context module)
# =============================================================================

PROGRESS_BAR_WIDTH=8
PROGRESS_BAR_FILLED="█"
PROGRESS_BAR_EMPTY="░"

# Alternative styles:
# Blocks: PROGRESS_BAR_FILLED="▓" PROGRESS_BAR_EMPTY="░"
# ASCII:  PROGRESS_BAR_FILLED="#" PROGRESS_BAR_EMPTY="-"
# Dots:   PROGRESS_BAR_FILLED="●" PROGRESS_BAR_EMPTY="○"

# =============================================================================
# MODULE ENABLE/DISABLE
# =============================================================================

# Core Modules (enabled by default)
MODULE_DIRECTORY="true"
MODULE_CONTEXT="true"
MODULE_GIT="true"
MODULE_PROJECT="true"
MODULE_MODEL="true"
MODULE_COST="true"
MODULE_RATE_LIMITS="true"
MODULE_TIME="true"
MODULE_BATTERY="true"

# System Monitoring Modules (disabled by default - enable as needed)
MODULE_CPU="false"
MODULE_MEMORY="false"
MODULE_DISK="false"
MODULE_NETWORK="false"
MODULE_UPTIME="false"
MODULE_LOAD="false"
MODULE_TEMPERATURE="false"
MODULE_BRIGHTNESS="false"
MODULE_PROCESSES="false"

# Development Tools Modules (disabled by default)
MODULE_DOCKER="false"
MODULE_NODE="false"

# Extra Modules (disabled by default)
MODULE_WEATHER="false"
MODULE_TIMEZONE="false"

# Sandbox indicator (shows lock icon when in macOS app sandbox)
MODULE_SANDBOX="true"

# Module display order (comma-separated, no spaces)
# Add modules here to display them. Order determines display position.
MODULE_ORDER="sandbox,directory,context,git,project,model,cost,rate-limits,time,battery"

# Example with system modules:
# MODULE_ORDER="directory,git,cpu,memory,disk,model,cost,rate-limits,time,battery"

# =============================================================================
# DIRECTORY MODULE
# =============================================================================

# Icon displayed before directory name
DIRECTORY_ICON="📁"

# Display style: "icon", "text", "both"
# - icon: 📁 myproject
# - text: Dir: myproject
# - both: 📁 Dir: myproject
DIRECTORY_STYLE="icon"

# Show full path instead of just directory name
DIRECTORY_SHOW_FULL_PATH="false"

# Maximum length for directory name (0 = no limit)
# Longer names will be truncated with "..."
DIRECTORY_MAX_LENGTH=20

# =============================================================================
# CONTEXT MODULE
# =============================================================================

# Icon displayed before context info
CONTEXT_ICON="📊"

# Show visual progress bar
CONTEXT_SHOW_PROGRESS_BAR="true"

# Show percentage
CONTEXT_SHOW_PERCENTAGE="true"

# Show status indicator (colored dot based on usage level)
CONTEXT_SHOW_STATUS="true"

# Show tokens remaining until auto-compact
CONTEXT_SHOW_TOKENS_REMAINING="true"

# Compact indicator icon (shown after tokens remaining)
CONTEXT_COMPACT_ICON="⚡"

# Threshold percentages for status colors
CONTEXT_WARNING_THRESHOLD=60    # Yellow at this percentage
CONTEXT_CRITICAL_THRESHOLD=75   # Red at this percentage

# Auto-compact threshold (Claude compacts at 80%)
CONTEXT_COMPACT_THRESHOLD=80

# =============================================================================
# GIT MODULE
# =============================================================================

# Icon displayed before branch name
GIT_ICON="🌿"

# Show branch name
GIT_SHOW_BRANCH="true"

# Show status symbols ([●+✓])
GIT_SHOW_STATUS="true"

# Show modified file count
GIT_SHOW_FILE_COUNT="true"

# Status symbols (change to customize)
GIT_SYMBOL_MODIFIED="●"     # Uncommitted changes
GIT_SYMBOL_UNTRACKED="+"    # Untracked files
GIT_SYMBOL_STAGED="✓"       # Staged changes

# File count icon
GIT_FILE_ICON="📝"

# Compact mode: shows just branch and symbols, no file count
GIT_COMPACT="false"

# =============================================================================
# PROJECT MODULE
# =============================================================================

# Display style: "icon", "text", "both"
# - icon: ⚡ (just the framework icon)
# - text: Nuxt (just the name)
# - both: ⚡ Nuxt (icon and name)
PROJECT_STYLE="both"

# Show dev server running indicator
PROJECT_SHOW_DEV_SERVER="true"

# Show build process indicator
PROJECT_SHOW_BUILD="true"

# Dev server and build icons
PROJECT_DEV_ICON="🚀"
PROJECT_BUILD_ICON="🔨"

# Custom project type icons (uncomment to override defaults)
# PROJECT_ICON_NUXT="⚡"
# PROJECT_ICON_NEXTJS="▲"
# PROJECT_ICON_VITE="⚡"
# PROJECT_ICON_SVELTE="🔥"
# PROJECT_ICON_ASTRO="🚀"
# PROJECT_ICON_REMIX="💿"
# PROJECT_ICON_NODE="📦"
# PROJECT_ICON_RUST="🦀"
# PROJECT_ICON_GO="🐹"
# PROJECT_ICON_PYTHON="🐍"
# PROJECT_ICON_RUBY="💎"
# PROJECT_ICON_PHP="🐘"
# PROJECT_ICON_SWIFT="🍎"
# PROJECT_ICON_KOTLIN="🟣"
# PROJECT_ICON_JAVA="☕"
# PROJECT_ICON_ELIXIR="💧"
# PROJECT_ICON_DENO="🦕"
# PROJECT_ICON_BUN="🍞"

# =============================================================================
# MODEL MODULE
# =============================================================================

# Icon displayed before model name
MODEL_ICON="🤖"

# Show output style (e.g., "learning", "explanatory")
MODEL_SHOW_OUTPUT_STYLE="true"

# Compact mode: use abbreviated model names
# e.g., "Claude Opus 4.5" -> "Opus 4.5"
MODEL_COMPACT="false"

# Show model only (hide output style even if enabled)
# Useful when you want MODEL_SHOW_OUTPUT_STYLE for verbose but not normal
MODEL_STYLE="both"   # "model", "style", "both"

# =============================================================================
# COST MODULE
# =============================================================================

# Icon displayed before cost
COST_ICON="💰"

# Show burn rate ($/hour)
COST_SHOW_BURN_RATE="true"

# Show tokens per minute (TPM)
COST_SHOW_TPM="true"

# TPM icon
COST_TPM_ICON="⚡"

# Decimal places for cost display
COST_DECIMAL_PLACES=2

# Compact mode: show only cost, no burn rate or TPM
COST_COMPACT="false"

# Hide cost if below this amount (0 = always show)
COST_MINIMUM_DISPLAY=0.01

# =============================================================================
# RATE LIMITS MODULE
# =============================================================================

# Show 5-hour rate limit
RATE_SHOW_5H="true"

# Show 7-day rate limit
RATE_SHOW_7D="true"

# Show time remaining until reset
RATE_SHOW_TIME_REMAINING="true"

# Show projection status indicator (colored dot predicting if you'll hit limit)
RATE_SHOW_PROJECTION="true"

# Show visual progress bar before each percentage (e.g., "5h:███░░░░░ 45%")
RATE_SHOW_PROGRESS_BAR="false"

# Progress bar width (empty = use global PROGRESS_BAR_WIDTH)
RATE_PROGRESS_BAR_WIDTH=""

# Threshold percentages for status colors
RATE_WARNING_THRESHOLD=80     # Yellow at this percentage
RATE_CRITICAL_THRESHOLD=100   # Red at this percentage

# Compact mode: "5h:45% 7d:23%" instead of full display
RATE_COMPACT="false"

# Labels for rate limits
RATE_5H_LABEL="5h"
RATE_7D_LABEL="7d"

# Cache TTL for API responses (seconds) - higher = fewer API calls
RATE_CACHE_TTL=120

# Fallback backoff duration after 429 (seconds) - API's retry-after header takes precedence
RATE_BACKOFF_SECONDS=300

# =============================================================================
# VERSION MODULE
# =============================================================================

# How long to show version after startup (seconds)
VERSION_SHOW_DURATION=120

# Icon for version display
VERSION_ICON="☕"

# =============================================================================
# UPDATE MODULE
# =============================================================================

# How often to check for updates (seconds, default 24 hours)
UPDATE_CHECK_INTERVAL=86400

# GitHub repository to check for releases
UPDATE_REPO="pstuart/Barista"

# Icon for update notification
UPDATE_ICON="⬆"

# =============================================================================
# TIME MODULE
# =============================================================================

# Icons
TIME_DATE_ICON="📅"
TIME_CLOCK_ICON="🕐"

# Show date
TIME_SHOW_DATE="true"

# Show time
TIME_SHOW_TIME="true"

# Date format (uses strftime format)
# Common formats:
#   %m/%d      -> 01/11
#   %Y-%m-%d   -> 2024-01-11
#   %b %d      -> Jan 11
#   %a %m/%d   -> Sat 01/11
TIME_DATE_FORMAT="%m/%d"

# Time format (uses strftime format)
# Common formats:
#   %I:%M %p   -> 04:30 PM (12-hour)
#   %H:%M      -> 16:30 (24-hour)
#   %I:%M%p    -> 04:30PM (no space)
TIME_TIME_FORMAT="%I:%M %p"

# Compact: combine date and time with single icon
TIME_COMPACT="false"

# =============================================================================
# BATTERY MODULE
# =============================================================================

# Icon displayed before battery percentage
BATTERY_ICON="🔋"

# Show charging indicator when plugged in
BATTERY_SHOW_CHARGING="true"

# Charging icon
BATTERY_CHARGING_ICON="⚡"

# Low battery icon (shown when below low threshold)
BATTERY_LOW_ICON="🪫"

# Critical battery icon
BATTERY_CRITICAL_ICON="🔴"

# Threshold for low battery warning
BATTERY_LOW_THRESHOLD=20

# Threshold for critical battery warning
BATTERY_CRITICAL_THRESHOLD=10

# Show percentage number
BATTERY_SHOW_PERCENTAGE="true"

# =============================================================================
# ADVANCED SETTINGS
# =============================================================================

# Cache duration for API calls (seconds)
# Lower = more up-to-date but more API calls
CACHE_MAX_AGE=60

# Enable debug logging (creates $CLAUDE_CONFIG_DIR/barista.log)
DEBUG_MODE="false"

# =============================================================================
# TERMINAL LAYOUT
# =============================================================================
# These settings control how Barista's output interacts with Claude Code's
# built-in right-side display (tokens/version info)

# Layout mode: "smart", "newline", "wrap", "truncate", or "none"
#   smart    - (default) Join with separator, wrap to new line at separator
#              boundaries when content exceeds terminal width minus reserve.
#   newline  - Add newline after output. Claude's right-side content
#              appears on a separate line below. Simple and reliable.
#   wrap     - Pad output to line boundary. Requires accurate TERMINAL_WIDTH.
#   truncate - Cut output with "..." to fit on same line as Claude's right-side.
#   none     - No adjustments, natural terminal wrapping behavior.
LAYOUT_MODE="smart"

# Manual terminal width override (only needed for smart/wrap/truncate modes)
# Auto-detection (tput) may not work in Claude Code's statusline context
# Example: TERMINAL_WIDTH=200
TERMINAL_WIDTH=""

# Space reserved on right side of terminal (used by smart/truncate modes)
RIGHT_SIDE_RESERVE=20

# =============================================================================
# PRESET CONFIGURATIONS
# =============================================================================
# Uncomment one of these blocks to quickly apply a preset style

# --- MINIMAL PRESET ---
# DISPLAY_MODE="compact"
# MODULE_PROJECT="false"
# MODULE_MODEL="false"
# MODULE_COST="false"
# MODULE_TIME="false"
# MODULE_BATTERY="false"
# SEPARATOR=" "

# --- DEVELOPER PRESET ---
# DISPLAY_MODE="normal"
# MODULE_BATTERY="false"
# GIT_SHOW_FILE_COUNT="true"
# COST_SHOW_TPM="true"

# --- ASCII PRESET (for terminals without unicode) ---
# USE_ICONS="false"
# STATUS_STYLE="ascii"
# PROGRESS_BAR_FILLED="#"
# PROGRESS_BAR_EMPTY="-"
# DIRECTORY_ICON="DIR:"
# CONTEXT_ICON="CTX:"
# GIT_ICON="GIT:"
# MODEL_ICON="MODEL:"
# COST_ICON="COST:"
# TIME_DATE_ICON="DATE:"
# TIME_CLOCK_ICON="TIME:"
# BATTERY_ICON="BAT:"

# =============================================================================
# CPU MODULE
# =============================================================================

# Icon displayed before CPU usage
CPU_ICON="💻"

# Show percentage
CPU_SHOW_PERCENTAGE="true"

# Threshold percentages for status colors
CPU_WARNING_THRESHOLD=60
CPU_CRITICAL_THRESHOLD=80

# Show status indicator
CPU_SHOW_STATUS="true"

# =============================================================================
# MEMORY MODULE
# =============================================================================

# Icon displayed before memory usage
MEMORY_ICON="🧠"

# Show percentage
MEMORY_SHOW_PERCENTAGE="true"

# Show used/total (e.g., "8G/16G")
MEMORY_SHOW_USED="false"

# Threshold percentages for status colors
MEMORY_WARNING_THRESHOLD=70
MEMORY_CRITICAL_THRESHOLD=85

# Show status indicator
MEMORY_SHOW_STATUS="true"

# =============================================================================
# DISK MODULE
# =============================================================================

# Icon displayed before disk usage
DISK_ICON="💾"

# Path to monitor (default: root filesystem)
DISK_PATH="/"

# Show percentage used
DISK_SHOW_PERCENTAGE="true"

# Show free space instead of used (e.g., "50G free")
DISK_SHOW_FREE="false"

# Threshold percentages for status colors
DISK_WARNING_THRESHOLD=70
DISK_CRITICAL_THRESHOLD=90

# Show status indicator
DISK_SHOW_STATUS="true"

# =============================================================================
# NETWORK MODULE
# =============================================================================

# Icon displayed before network info
NETWORK_ICON="🌐"

# Show LAN IP address
NETWORK_SHOW_LAN="true"

# Show WAN IP address (requires internet, cached for 5 min)
# Privacy note: enabling this sends requests to external IP lookup services
# (ifconfig.me, icanhazip.com), which exposes your public IP to those services.
NETWORK_SHOW_WAN="false"

# Redact WAN IP for privacy (default: true)
# When true, displays e.g. "203.0.xxx.xxx" instead of full public IP
# Set to "false" to display the full unredacted public IP address
NETWORK_WAN_REDACT="true"

# Show WiFi SSID (macOS only)
NETWORK_SHOW_SSID="false"

# Compact mode
NETWORK_COMPACT="false"

# =============================================================================
# UPTIME MODULE
# =============================================================================

# Icon displayed before uptime
UPTIME_ICON="⏱️"

# Display style: "short" (2d 5h), "long" (2 days, 5 hours), "days" (2d)
UPTIME_STYLE="short"

# Show load average after uptime
UPTIME_SHOW_LOAD="false"

# =============================================================================
# LOAD AVERAGE MODULE
# =============================================================================

# Icon displayed before load
LOAD_ICON="📊"

# Show all three averages (1, 5, 15 min)
LOAD_SHOW_ALL="false"

# Warning threshold (default: number of CPUs)
# LOAD_WARNING_THRESHOLD=4

# Critical threshold (default: 2x number of CPUs)
# LOAD_CRITICAL_THRESHOLD=8

# Show status indicator
LOAD_SHOW_STATUS="true"

# =============================================================================
# TEMPERATURE MODULE
# =============================================================================
# Note: Requires osx-cpu-temp, istats, or smctemp on macOS

# Icon displayed before temperature
TEMP_ICON="🌡️"

# Units: "C" for Celsius, "F" for Fahrenheit
TEMP_UNITS="C"

# Threshold temperatures for status colors (in Celsius)
TEMP_WARNING_THRESHOLD=70
TEMP_CRITICAL_THRESHOLD=85

# Show status indicator
TEMP_SHOW_STATUS="true"

# =============================================================================
# BRIGHTNESS MODULE
# =============================================================================
# Note: May require 'brightness' CLI tool on macOS (brew install brightness)

# Icon displayed before brightness
BRIGHTNESS_ICON="☀️"

# Show percentage
BRIGHTNESS_SHOW_PERCENT="true"

# Show progress bar
BRIGHTNESS_SHOW_BAR="false"

# Progress bar width
BRIGHTNESS_BAR_WIDTH=5

# =============================================================================
# PROCESSES MODULE
# =============================================================================

# Icon displayed before process count
PROC_ICON="🔄"

# Show total process count
PROC_SHOW_TOTAL="true"

# Show running process count
PROC_SHOW_RUNNING="false"

# Warning/critical thresholds
PROC_WARNING_THRESHOLD=300
PROC_CRITICAL_THRESHOLD=500

# Show status indicator
PROC_SHOW_STATUS="false"

# =============================================================================
# DOCKER MODULE
# =============================================================================

# Icon displayed before Docker info
DOCKER_ICON="🐳"

# Show running container count
DOCKER_SHOW_RUNNING="true"

# Show total container count
DOCKER_SHOW_TOTAL="false"

# Show status indicator (green if containers running)
DOCKER_SHOW_STATUS="true"

# Compact mode
DOCKER_COMPACT="false"

# =============================================================================
# NODE MODULE
# =============================================================================

# Icon displayed before Node version
NODE_ICON="⬢"

# Show Node version
NODE_SHOW_VERSION="true"

# Show npm version
NODE_SHOW_NPM="false"

# Show nvm indicator
NODE_SHOW_NVM="false"

# Compact mode (major.minor only)
NODE_COMPACT="false"

# =============================================================================
# WEATHER MODULE
# =============================================================================
# Uses wttr.in API (free, no API key required)

# Location (leave empty for auto-detect by IP)
WEATHER_LOCATION=""

# Units: "m" (metric), "u" (US/imperial), "M" (metric wind)
WEATHER_UNITS="u"

# Show temperature
WEATHER_SHOW_TEMP="true"

# Show condition icon
WEATHER_SHOW_COND="true"

# Compact mode
WEATHER_COMPACT="false"

# Cache duration in seconds (default: 30 minutes)
WEATHER_CACHE_TTL=1800

# =============================================================================
# TIMEZONE MODULE
# =============================================================================

# Comma-separated list of timezones
# Examples: "UTC", "America/New_York", "Europe/London", "Asia/Tokyo"
TIMEZONE_ZONES="UTC"

# Time format (strftime format)
TIMEZONE_FORMAT="%H:%M"

# Show timezone label
TIMEZONE_SHOW_LABEL="true"

# Custom labels (comma-separated, matches TIMEZONE_ZONES order)
# Example: "UTC,NYC,LON" for the zones "UTC,America/New_York,Europe/London"
TIMEZONE_LABELS=""

# Compact mode
TIMEZONE_COMPACT="false"

# =============================================================================
# SYSTEM MONITORING PRESET
# =============================================================================
# Uncomment to quickly enable system monitoring modules

# --- SYSTEM MONITORING PRESET ---
# MODULE_CPU="true"
# MODULE_MEMORY="true"
# MODULE_DISK="true"
# MODULE_NETWORK="true"
# MODULE_ORDER="directory,git,cpu,memory,disk,network,model,cost,rate-limits,time,battery"

# --- DEVELOPER FULL PRESET ---
# MODULE_CPU="true"
# MODULE_MEMORY="true"
# MODULE_DOCKER="true"
# MODULE_NODE="true"
# MODULE_ORDER="directory,git,node,docker,cpu,memory,model,cost,rate-limits,time,battery"