hypr-concierge

cwar's avatarfrom cwar

Personal theme concierge for Hyprland desktop environments. Use when user wants to (1) change desktop theme/colors, (2) apply preset themes (Catppuccin/Dracula/Nord/Gruvbox/Rose Pine/Kanagawa/Tokyo Night), (3) create custom themes from mood/aesthetic descriptions, (4) create themes inspired by movies/art/feelings, (5) get theme recommendations based on mood, (6) learn what themes look/feel like, (7) save/restore/switch themes, (8) manage which apps get themed, or (9) find/change wallpapers. Triggers: "change theme", "apply catppuccin", "I want something cozy", "create a Hackers theme", "describe the themes", "what feels like...", "save my theme", "find wallpapers", "change wallpaper", "theme concierge".

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 17, 2025
[Developer Tools]

When & Why to Use This Skill

Hypr Concierge is an AI-powered theme management agent specifically designed for Hyprland and Wayland desktop environments. It streamlines the complex process of desktop customization by automating color palette synchronization across multiple applications (like Waybar, Ghostty, and Tmux), managing dotfiles via GNU Stow, and providing intelligent theme recommendations. By leveraging semantic color mapping and integration with wallpaper services like Wallhaven, it transforms abstract mood descriptions into cohesive, system-wide visual aesthetics.

Use Cases

  • Instant Theme Switching: Seamlessly apply popular presets such as Catppuccin, Tokyo Night, or Gruvbox across all supported desktop components with a single command.
  • Aesthetic Generation from Inspiration: Create entirely custom color palettes based on movies, art, or specific moods (e.g., 'a rainy day in Seattle' or 'Blade Runner aesthetic') and apply them system-wide.
  • Automated Dotfile Management: Manage and version-control desktop configurations using GNU Stow, ensuring that theme changes are persistent and organized within the user's dotfiles directory.
  • Cross-App Color Synchronization: Automatically extract colors from one application (e.g., a terminal emulator) and apply them to others (e.g., Waybar or Mako) to maintain visual consistency.
  • Intelligent Wallpaper Integration: Search for, preview, and apply high-resolution wallpapers from Wallhaven that specifically match the current theme's color schema and atmosphere.
namehypr-concierge
descriptionPersonal theme concierge for Hyprland desktop environments. Use when user wants to (1) change desktop theme/colors, (2) apply preset themes (Catppuccin/Dracula/Nord/Gruvbox/Rose Pine/Kanagawa/Tokyo Night), (3) create custom themes from mood/aesthetic descriptions, (4) create themes inspired by movies/art/feelings, (5) get theme recommendations based on mood, (6) learn what themes look/feel like, (7) save/restore/switch themes, (8) manage which apps get themed, or (9) find/change wallpapers. Triggers: "change theme", "apply catppuccin", "I want something cozy", "create a Hackers theme", "describe the themes", "what feels like...", "save my theme", "find wallpapers", "change wallpaper", "theme concierge".

Hypr Concierge

Your personal theme concierge for Hyprland/Wayland desktop environments.

Quick Start

  1. Choose or define a theme (see themes.md for presets)
  2. Read app-formats.md for target application's format
  3. Edit config files in ~/dotfiles/{app}/.config/{app}/
  4. Run cd ~/dotfiles && stow {app} if new files created
  5. Reload each application

Workflow

Apply Preset Theme

User: "Switch to Catppuccin"
  1. Read references/themes.md → get Catppuccin Mocha colors
  2. Read references/app-formats.md → get format for each app
  3. Edit each config file with theme colors:
    • ~/dotfiles/hypr/.config/hypr/hyprland.conf
    • ~/dotfiles/waybar/.config/waybar/style.css
    • ~/dotfiles/rofi/.config/rofi/tokyo-night.rasi (rename file if desired)
    • ~/dotfiles/mako/.config/mako/config
    • ~/dotfiles/ghostty/.config/ghostty/config
    • ~/dotfiles/tmux/.tmux.conf
  4. Reload apps: hyprctl reload && makoctl reload && killall -SIGUSR2 waybar
  5. Suggest Neovim colorscheme plugin if applicable

Describe Themes / Match Aesthetic

User: "Describe the available themes"
User: "I want something cozy and warm"
User: "What theme feels like a rainy day?"
  1. Read references/themes.md → get aesthetic descriptions
  2. For matching: compare user's mood/description to theme moods
  3. Recommend 1-2 themes with explanation of why they fit
  4. Offer to apply the recommended theme

Create Custom Theme

User: "Create a theme with blue and orange accents"
  1. Read references/color-schema.md → understand required color slots
  2. Generate cohesive palette based on user's description
  3. Apply using same process as preset themes

Create Theme from Inspiration

User: "Create a theme inspired by the movie Hackers"
User: "I want a Blade Runner aesthetic"
User: "Make it feel like a forest at night"
  1. Analyze the inspiration's visual language:
    • What are the dominant colors?
    • What's the mood/atmosphere?
    • What would "error" or "success" look like in that world?
  2. Generate a cohesive palette following references/color-schema.md
  3. Name the theme descriptively
  4. Show the user the palette with rationale before applying
  5. Save as a custom theme in ~/.config/hyprland-themes/saved/

Partial Theme Update

User: "Make waybar match my terminal colors"
  1. Read the source config (e.g., ghostty) to extract current colors
  2. Read target app's format from references/app-formats.md
  3. Apply matching colors to target config only

Save Current Theme

User: "Save my current theme as cozy-dark"
  1. Read references/theme-management.md for save procedure
  2. Create ~/.config/hyprland-themes/saved/{name}/ directory
  3. Copy all current configs to the save directory
  4. Create theme-info.txt with name, date, description
  5. Update active-theme.txt

List Saved Themes

User: "What themes do I have saved?"
  1. List contents of ~/.config/hyprland-themes/saved/
  2. Read theme-info.txt from each
  3. Indicate which is currently active

Switch/Restore Theme

User: "Switch to my tokyo-night theme"
  1. Verify theme exists in saved themes
  2. Offer to save current theme first if it has unsaved changes
  3. Copy saved configs back to dotfiles locations
  4. Re-stow dotfiles and reload all applications
  5. Update active-theme.txt

List Themed Apps

User: "What apps can you theme?"
  1. Read references/themed-apps.md
  2. List all apps in the registry with their reload commands
  3. Note any plugin-based apps (like Neovim)

Add New App to Theming

User: "Add kitty terminal to my themed apps"
  1. Ask user for config file location and reload command
  2. Determine color format by reading their existing config
  3. Add entry to references/themed-apps.md
  4. Add detailed format instructions to references/app-formats.md
  5. Include the new app in future theme operations

Find Wallpapers for Theme

User: "Find wallpapers for my Hackers theme"
User: "I need a new wallpaper"
  1. Search Wallhaven with theme-appropriate keywords (see references/wallpapers.md)
  2. Collect wallpaper IDs and resolutions from results
  3. Generate themed HTML preview page with thumbnails
  4. Open preview in browser for user to browse visually
  5. User selects wallpaper by ID
  6. Download and apply selected wallpaper

Apply Wallpaper

User: "Use wallpaper l3qo2r" or "Download that one"
  1. Download full resolution from Wallhaven
  2. Save to ~/Pictures/ with descriptive name
  3. Update ~/dotfiles/hypr/.config/hypr/hyprpaper.conf
  4. Reload hyprpaper: hyprctl hyprpaper reload

Themed Applications

Application Config Location Reload Command
Hyprland hypr/.config/hypr/hyprland.conf hyprctl reload
Hyprlock hypr/.config/hypr/hyprlock.conf (next lock)
Waybar waybar/.config/waybar/style.css killall -SIGUSR2 waybar
Rofi rofi/.config/rofi/*.rasi (next launch)
Mako mako/.config/mako/config makoctl reload
Ghostty ghostty/.config/ghostty/config Ctrl+Shift+,
Tmux tmux/.tmux.conf tmux source ~/.tmux.conf

Color Format Quick Reference

App Format Example
Hyprland rgba(HEXaa) rgba(7aa2f7ee)
Waybar #HEX or rgba(r,g,b,a) #7aa2f7 or rgba(122,162,247,0.9)
Rofi #HEXaa #7aa2f7e6
Mako #HEX #7aa2f7
Ghostty #HEX #7aa2f7
Tmux #HEX in strings "fg=#7aa2f7"

Available Themes

Presets in references/themes.md:

  • Tokyo Night (current default)
  • Catppuccin Mocha
  • Dracula
  • Nord
  • Gruvbox Dark
  • Rose Pine
  • Kanagawa

Theme Management

Saved themes stored in ~/.config/hyprland-themes/saved/

Action Quick Check
List saved ls ~/.config/hyprland-themes/saved/
Current theme cat ~/.config/hyprland-themes/active-theme.txt
Theme details cat ~/.config/hyprland-themes/saved/{name}/theme-info.txt

See theme-management.md for full save/restore procedures.

References