v0.3.0 - Customizable Formatting

✨ New Features

Custom Format Options

• --format: Customize waybar text output with placeholders like {icon}, {5h_pct}, {5h_reset}, etc.
• --tooltip-format: Customize tooltip content separately from main text
• --show-5h: Always show 5-hour window data instead of auto-switching to 7-day at 80%

Conditional Formatting

• Show/hide sections based on window status with {?var}...{/var} syntax
• Support for multi-variable conditions: {?5h_reset&7d_reset}...{/}

Available Variables

All formats support these placeholders:

• {icon}, {icon_plain} - Service icons (with/without color styling)
• {time_icon}, {time_icon_plain} - Time icons (with/without color styling)
• {5h_pct}, {7d_pct} - Usage percentages for each window
• {5h_reset}, {7d_reset} - Reset times for each window
• {pct}, {reset}, {status}, {win} - Active window info

📖 Examples

# Show only 5-hour data without styled icons
claude-usage --waybar --format "{icon_plain} {5h_pct}% {time_icon_plain} {5h_reset}"

# Show both windows
claude-usage --waybar --format "{icon} 5h:{5h_pct}% 7d:{7d_pct}%"

# Conditional display (only show if window started)
claude-usage --waybar --format "{?5h_reset}{5h_pct}/{5h_reset}{/5h_reset}"

# Always show 5-hour window
claude-usage --waybar --show-5h

📝 Full Changelog

feat: add formatting options (#3) - Thanks to @AntoineGS

• Add --format and --tooltip-format parameters for customizing output
• Add --show-5h flag to always show 5-hour window
• Support conditional formatting with {?var}...{/var} syntax
• Add comprehensive documentation with examples

docs: Add showcase GIF to README

🔗 Installation

AUR (Arch Linux)

yay -Syu waybar-ai-usage

uv tool

uv tool install git+https://github.com/NihilDigit/waybar-ai-usage@v0.3.0