Retro Skins Platform

Generate retro terminal skins with CRT effects, scanlines, glow, and more. Supports WezTerm, Alacritty, Kitty, and Windows Terminal terminal emulators.

Installation

# Clone and install dependencies
cd retro-skins-platform
pnpm install

# Build the project
pnpm build

# Link globally (optional)
pnpm link --global

CLI Commands

retro-skins list

List all available retro skins.

retro-skins list

Output:

🎨 Available Skins:

  • phosphor    Phosphor CRT
  • amber       Amber Monochrome
  • lcd         LCD Display
  • cyber       Cyber Purple
  • terminal    Classic Terminal

📝 Use: retro-skins preview <skin-name>

retro-skins preview [skin]

Preview a skin configuration. Shows all skins if no name given.

# Preview specific skin
retro-skins preview phosphor

# Preview all skins
retro-skins preview

# Preview with terminal-specific config
retro-skins preview phosphor --terminal wezterm

Options: | Option | Description | |--------|-------------| | -t, --terminal <type> | Preview for specific terminal (wezterm, alacritty, kitty, windows-terminal) |

retro-skins generate <terminal> <skin>

Generate terminal configuration directly (non-interactive).

# Generate to stdout
retro-skins generate wezterm phosphor
retro-skins generate alacritty amber
retro-skins generate kitty lcd

# Generate to file
retro-skins generate wezterm phosphor --output ~/.config/wezterm/retro_skin.lua
retro-skins generate alacritty cyber --output ~/retro-alacritty.yml
retro-skins generate kitty terminal --output ~/.config/kitty/retro_skin.conf

# Dry run (preview without writing)
retro-skins generate wezterm phosphor --dry-run

Arguments: | Argument | Description | |----------|-------------| | terminal | Target terminal (wezterm, alacritty, kitty, windows-terminal) | | skin | Skin name (phosphor, amber, lcd, cyber, terminal, puncore) |

Options: | Option | Description | |--------|-------------| | -o, --output <file> | Write to file instead of stdout | | --dry-run | Preview without writing files |

retro-skins apply <terminal>

Interactive command to apply a skin to your terminal.

# Interactive mode (prompts for skin selection)
retro-skins apply wezterm

# With output file
retro-skins apply alacritty --output ~/.config/alacritty/retro_skin.yml

Arguments: | Argument | Description | |----------|-------------| | terminal | Target terminal (wezterm, alacritty, kitty, windows-terminal) |

Options: | Option | Description | |--------|-------------| | -o, --output <file> | Write to file instead of stdout |

Available Skins

| Name | Description | Colors | |------|-------------|--------| | phosphor | Classic green phosphor CRT | #0D0208 → #00FF41 | | amber | Amber monochrome display | #1A0F00 → #FFB000 | | lcd | Clean LCD display style | #0A0A0A → #E8E8E8 | | cyber | Purple cyberpunk aesthetic | #0D0D1A → #B388FF | | terminal | Classic blue terminal | #0C0C14 → #4AF626 | | puncore | Neon theme | #575757 → #858585 |

Usage Flow

# 1. List available skins
retro-skins list

# 2. Preview a skin
retro-skins preview phosphor

# 3. Preview terminal-specific output
retro-skins preview phosphor --terminal wezterm

# 4. Generate final config
retro-skins generate wezterm phosphor --output ~/.config/wezterm/retro_skin.lua

Installation Locations

After generating configs, place them in:

| Terminal | Location | |----------|----------| | WezTerm | ~/.config/wezterm/retro_skin.lua | | Alacritty | ~/.config/alacritty/retro_skin.yml | | Kitty | ~/.config/kitty/retro_skin.conf |

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Run tests
pnpm test

# Watch mode
pnpm dev

Testing

Run integration tests for all three terminals:

pnpm test

Tests cover:

• ✅ List command
• ✅ Preview command (all skins + terminal-specific)
• ✅ Generate command (all terminal/skin combinations)
• ✅ File output with --output flag
• ✅ Dry-run with --dry-run flag
• ✅ Valid syntax for WezTerm Lua, Alacritty YAML, and Kitty config

License

MIT