Customization Commands

VritraAI offers extensive customization options to personalize your terminal experience. Customize themes, prompt styles, and welcome banners to make VritraAI truly yours. All customization changes are automatically saved and persist across sessions.

Theme Management

theme [name]

Switch between 37+ color themes to customize the appearance of VritraAI. Themes control the colors used for prompts, output, errors, success messages, warnings, and info messages.

Usage Modes:

  • theme - Show all available themes organized by category
  • theme <name> - Switch to a specific theme
  • theme reset - Reset theme to default (matrix)

Theme Categories:

  • Basic: dark, light
  • Tech: hacker_green, matrix, cyberpunk, terminal_green
  • Colors: retro, neon, rainbow, purple, cherry, mint
  • Nature: ocean, sunset, forest, winter, spring, summer
  • Professional: grayscale, royal, coffee, professional
  • And many more! (37+ total themes)

Features:

  • Automatic configuration saving
  • Theme preview on switch
  • Organized by category for easy browsing
  • Current theme indicator
  • Theme descriptions

Examples:

# Show all available themes
theme

# Switch to a specific theme
theme matrix
theme cyberpunk
theme ocean

# Reset to default
theme reset

Note: Theme changes are automatically saved to your configuration file and persist across sessions. The default theme is "matrix".

Prompt Style Management

prompt [style]

Change the prompt style to customize how your command prompt appears. VritraAI includes 60+ creative prompt styles ranging from professional to fun and themed styles.

Usage Modes:

  • prompt - Show all available prompt styles with descriptions
  • prompt <style> - Switch to a specific prompt style
  • prompt reset - Reset prompt style to default (hacker)

Prompt Style Categories:

  • Tech Styles: hacker, cyberpunk, matrix, code_matrix, terminal_classic
  • Fun Styles: ninja, pirate, superhero, robot, alien, magical, medieval, western, steampunk, gaming
  • Professional Styles: corporate, professional, elegant, minimal_zen
  • Nature Styles: space, fire, water, earth, air, mountain, jungle, desert, arctic
  • And many more! (60+ total styles)

Features:

  • Automatic configuration saving
  • Rich table display (if Rich library available)
  • Current style indicator
  • Style descriptions
  • Wide variety of creative options

Examples:

# Show all available prompt styles
prompt

# Switch to a specific style
prompt hacker
prompt ninja
prompt professional

# Reset to default
prompt reset

Note: Prompt style changes are automatically saved to your configuration file. The default prompt style is "hacker".

Banner Management

banner [subcommand]

Manage MOTD (Message of the Day) / welcome banners that appear when VritraAI starts. Customize your startup experience with different banners, random banner selection, and color synchronization options.

Subcommands:

  • banner or banner help - Show banner management help
  • banner list - List all available banner IDs and names
  • banner set <id> - Set a specific banner by ID
  • banner random - Enable random banner selection on each startup
  • banner reset - Reset to default banner (ID: 1)
  • banner preview <id> - Preview a banner without saving
  • banner sync on|off - Toggle theme-synced vs hardcoded ANSI colors

Banner Features:

  • Multiple banner designs to choose from
  • Random banner mode for variety
  • Theme-synced colors (uses Rich library colors matching your theme)
  • Hardcoded ANSI colors option (traditional terminal colors)
  • Preview before setting
  • Automatic configuration saving

Examples:

# Show banner help
banner

# List available banners
banner list

# Set a specific banner
banner set 1
banner set 5

# Enable random banners
banner random

# Preview a banner
banner preview 3

# Toggle color sync
banner sync on
banner sync off

# Reset to default
banner reset

Banner Color Modes:

  • Theme-synced (on): Banners use Rich library colors that match your current theme
  • Hardcoded ANSI (off): Banners use traditional ANSI color codes for consistent appearance

Customization Persistence

All customization changes are automatically saved to your configuration file:

  • Configuration File: ~/.config-vritrasecz/vritraai/config.json
  • Automatic Saving: Changes are saved immediately when you switch themes, prompt styles, or banners
  • Session Persistence: All customizations persist across VritraAI sessions
  • Backup System: Configuration backups are automatically created

Best Practices

  • Try different themes: Use theme to browse and try different color schemes
  • Match prompt to theme: Choose prompt styles that complement your selected theme
  • Use random banners: Enable banner random for variety on each startup
  • Preview before setting: Use banner preview to see banners before committing
  • Sync banner colors: Use banner sync on to match banner colors with your theme
  • Check configuration: Use config to verify your customization settings

💡 Pro Tip: Combine themes, prompt styles, and banners to create a unique terminal experience. For example, use the "matrix" theme with the "hacker" prompt style and a tech-themed banner for a complete cyberpunk aesthetic!