ghostty-claude-setup
By koenrohrer
Interactive configuration wizard for Ghostty terminal and Claude Code with advanced options: status line customization, keybinding presets (vim/tmux/VS Code), shell profiles, and performance tuning
npx claudepluginhub koenrohrer/claude-plugins-marketplace --plugin ghostty-claude-setupComponent Overview
Component Details
Commands (1)
Agents (3)
Implementation agent for writing Ghostty and Claude Code configuration files. Use when you have finalized configuration choices and need to write them to disk. This agent creates backups, writes configs, and validates the results. <example> Context: User has selected their theme, font, and settings through the wizard user: "I'm happy with these choices, apply them" assistant: [spawns config-implementer to backup existing config and write new settings] </example> <example> Context: User wants to apply just the Ghostty configuration user: "Save this Ghostty config" assistant: [spawns config-implementer to write Ghostty configuration] </example> <example> Context: User wants to revert to backup user: "Restore my previous configuration" assistant: [spawns config-implementer to restore from backup] </example> <example> Context: User wants to generate a statusline script from a palette user: "Create the statusline script using the catppuccin-mocha palette" assistant: [spawns config-implementer to resolve powerline template and write statusline.sh] </example> <example> Context: User wants to switch to a different palette user: "Switch my theme to dracula" assistant: [spawns config-implementer to regenerate configs with new palette] </example>
Research agent for finding terminal themes, fonts, color schemes, and community configurations. Use when you need to search for Ghostty themes, programming fonts, color palettes, or community dotfiles. This agent searches the web and GitHub for options matching user preferences. <example> Context: User is going through the setup wizard and wants theme recommendations user: "I want a warm, cozy theme that's easy on the eyes" assistant: [spawns config-researcher to search for warm-toned terminal themes] </example> <example> Context: User wants to see what fonts are popular user: "What programming fonts do people recommend for terminal use?" assistant: [spawns config-researcher to search for popular programming fonts] </example> <example> Context: User wants to see community configurations user: "Show me some example Ghostty configs from GitHub" assistant: [spawns config-researcher to search GitHub for Ghostty dotfiles] </example> <example> Context: User wants to explore palettes by mood user: "What palettes do you have that are blue-tinted and modern?" assistant: [spawns config-researcher to search palette library for cool-toned modern themes] </example> <example> Context: User wants font recommendations for high DPI displays user: "I have a 4K monitor, what font would look best?" assistant: [spawns config-researcher to find fonts optimized for high-resolution displays] </example>
Use this agent to configure the user's Claude Code status line setting.
Skills (2)
Use this skill when the user asks to "configure ghostty", "setup terminal", "terminal config", "claude code settings", "setup wizard", "configure my environment", "terminal theme", "ghostty theme", "status line", "keybindings", "shell profile", "performance tuning", or wants help setting up their development environment configuration.
Browse and manage color palettes from the curated library with visual previews
Hooks (1)
README
Ghostty + Claude Code Setup Wizard
An interactive configuration wizard plugin for Claude Code that helps you set up and optimize your Ghostty terminal and Claude Code environment. Features a comprehensive 86-palette color library from 8 design systems with automatic theme consistency.
Features
- Environment Detection: Automatically detects your OS, shell, existing configurations, and installed fonts
- 86 Curated Palettes: Color schemes from Catppuccin, Dracula, Nord, Tailwind, Material, GitHub Primer, and more
- Palette Token System: Consistent theming with
$bg,$fg,$redtokens across all configurations - Full Ghostty Configuration: Theme, font, keybindings, shell integration, window settings, cursor, scrollback
- Full Claude Code Configuration: Theme, statusline customization, permissions, model preferences, MCP servers, hooks
- Advanced Options: Vim/tmux/VS Code keybinding presets, shell profiles, performance tuning
- Web Research: Searches for community themes, fonts, and configurations from GitHub and theme galleries
- Automatic Backups: All configuration changes include timestamped backups with rollback instructions
Installation
claude plugins add github:koenrohrer/ghostty-claude-setup
Quick Start
/setup-wizard
The wizard will:
- Detect your current environment
- Ask about your goals (fresh setup, optimization, or quick theme change)
- Help you select a color palette from 86 options
- Walk through Ghostty configuration options
- Walk through Claude Code configuration options (including statusline)
- Apply your chosen configurations with automatic backups
Quick Commands
/setup-wizard ghostty # Configure Ghostty only
/setup-wizard claude # Configure Claude Code only
/setup-wizard statusline # Configure statusline directly
/setup-wizard keybindings # Configure keybinding presets
/setup-wizard advanced # Jump to advanced options
Palette Library
The plugin includes 86 curated palettes from 8 design systems:
| Source | Count | Examples |
|---|---|---|
| Terminal Classics | 11 | Catppuccin, Dracula, Nord, Gruvbox, Tokyo Night |
| Tailwind CSS | 21 | Slate, Zinc, Stone, Neutral color families |
| Material Design | 12 | Baseline, Blue, Green, Neutral variants |
| GitHub Primer | 7 | Dark, Light, High Contrast, Colorblind variants |
| Radix Colors | 12 | Slate, Mauve, Violet, Crimson and more |
| Open Color | 10 | Gray, Blue, Green, Red and more |
| IBM Carbon | 8 | Gray 100, Cool Gray, Warm Gray variants |
| Apple HIG | 4 | Dark, Light, Vibrant variants |
All palettes support both Ghostty terminal colors and Claude Code statusline themes.
Components
Command
/setup-wizard- Start the interactive configuration wizard
Agents
- config-researcher - Researches themes, fonts, and community configurations
- config-implementer - Writes configuration files with automatic backups
- statusline-setup - Specialized statusline configuration
Skills
- config-wizard - Core wizard knowledge and 8-step workflow
- palette-browser - Palette library browsing and selection
Examples
See the examples/ directory for detailed walkthroughs:
- Basic Setup - Fresh installation walkthrough
- Custom Statusline - Statusline configuration examples
- Palette Customization - Create custom color palettes
- CI Integration - GitHub Actions validation
Documentation
- Architecture - System design and component overview
- Palette System - Complete palette token documentation
- Contributing - Contribution guidelines
- Changelog - Version history
Testing
The plugin includes an automated test suite using bats-core:
# Install bats (macOS)
brew install bats-core
# Run tests
bats tests/
Requirements
- Claude Code CLI
- Ghostty terminal (optional - wizard will detect if installed)
- jq (for palette resolution)
Configuration Paths
The wizard manages these configuration files:
Ghostty:
- macOS/Linux:
~/.config/ghostty/config
Claude Code:
- Global:
~/.claude/settings.json - Project:
.claude/settings.json
Plugin State:
- Active palette:
~/.claude/plugins/ghostty-claude-setup/palette.local.json
License
Author
Similar Plugins
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Help us improve
Share bugs, ideas, or general feedback.