ohmyposh-configurator
Advanced tools
Design beautiful terminal prompts without touching configuration files
🚀 Launch App • 📖 Documentation • 💬 Discussions
The Oh My Posh Visual Configurator is a modern, intuitive web application that lets you design and customize your terminal prompt visually. No more manual JSON editing or trial-and-error configuration—just drag, drop, customize, and export!
Perfect for developers, DevOps engineers, and anyone who wants a beautiful, informative terminal prompt for PowerShell, Bash, Zsh, Fish, or any shell supported by Oh My Posh.
git)No installation required! Visit the hosted version:
👉 https://configurator.ohmyposh.dev/
# Clone the repository
git clone https://github.com/jamesmontemagno/ohmyposh-configurator.git
cd ohmyposh-configurator
# Install dependencies
npm install
# Start development server
npm run dev
# Build for production (includes JSON minification)
npm run build
# Preview production build locally
npm run preview
npm run dev: Start Vite development servernpm run build: Build for production and minify all JSON assetsnpm run build:mcp: Build the MCP servernpm run mcp: Run the MCP servernpm run preview: Serve the production build from dist/npm run minify: Manually minify JSON files in the public/ directorynpm run format:json: Expand/format JSON files in public/ for easier editingnpm run validate: Validate all configuration files and manifestsnpm run lint: Run ESLint checknpm run test: Run testsWant to create Oh My Posh configurations using natural language with AI assistants? The Oh My Posh Configurator includes a Model Context Protocol (MCP) server that works with VS Code and GitHub Copilot.
Quick Setup for VS Code:
Add to your workspace .vscode/mcp.json:
{
"servers": {
"ohmyposh-configurator": {
"type": "stdio",
"command": "node",
"args": ["/path/to/ohmyposh-configurator/dist/mcp/index.js"]
}
}
}
Build the MCP server:
npm run build:mcp
Open GitHub Copilot Chat in VS Code and start creating prompts with AI!
Example Requests:
📖 Full MCP Server Documentation
🎯 Choose a Starting Point
➕ Add Segments
🎨 Customize
👀 Preview
💾 Export or Share
Love your configuration? Share it with the community!
See CONTRIBUTING.md for detailed instructions.
After downloading your configuration file, follow the Oh My Posh installation guide to use it with your shell:
# PowerShell
oh-my-posh init pwsh --config ~/your-theme.json | Invoke-Expression
# Bash
eval "$(oh-my-posh init bash --config ~/your-theme.json)"
# Zsh
eval "$(oh-my-posh init zsh --config ~/your-theme.json)"
├── public/
│ ├── configs/ # Sample and community configurations
│ │ ├── samples/ # 6 pre-built professional templates
│ │ │ └── manifest.json # Sample configs metadata
│ │ └── community/ # User-contributed themes
│ │ └── manifest.json # Community configs metadata
│ └── segments/ # Segment metadata organized by category (103+ segments)
│ ├── system.json # 14 system segments (path, battery, time, etc.)
│ ├── scm.json # 8 version control segments (git, svn, etc.)
│ ├── languages.json # 26 programming language segments
│ ├── cloud.json # 12 cloud provider segments
│ ├── cli.json # 30 CLI tool segments
│ ├── web.json # 7 web-related segments
│ ├── music.json # 3 music player segments
│ ├── health.json # 3 health tracker segments
│ └── README.md # Documentation for adding segments
├── src/
│ ├── components/ # React components
│ │ ├── Canvas/ # Drag-and-drop prompt builder with tooltips support
│ │ ├── SegmentPicker/ # Category browser with segments
│ │ ├── PropertiesPanel/ # Segment, block, tooltip, and global properties editor
│ │ ├── PreviewPanel/ # Live prompt preview with tooltip previews
│ │ ├── AdvancedSettingsDialog/ # Progressive disclosure settings for advanced features
│ │ ├── ExtraPromptsDialog/ # Secondary prompts configuration
│ │ ├── ConfirmDialog/ # Reusable confirmation dialog
│ │ └── ...
│ ├── data/ # Configuration data and color schemes
│ ├── store/ # Zustand state management with persistence
│ │ ├── configStore.ts # Main config state (blocks, segments, tooltips, global settings)
│ │ └── advancedFeaturesStore.ts # Feature toggles for progressive disclosure
│ ├── types/ # TypeScript type definitions (SegmentMetadata, Tooltip, etc.)
│ ├── utils/ # Utility functions
│ │ ├── segmentLoader.ts # Dynamic segment loading with caching
│ │ ├── configExporter.ts # Export to JSON/YAML/TOML
│ │ ├── configImporter.ts # Import with auto-feature detection
│ │ └── unicode.ts # Unicode escape handling
│ ├── constants/ # Nerd Font icons and other constants
│ └── hooks/ # Custom React hooks (useConfirm, etc.)
├── docs/ # Comprehensive documentation
│ ├── config-migration-guide.md # Guide for config structure updates
│ ├── segment-json-migration.md # Segment refactoring documentation
│ ├── quick-reference.md # Quick reference for contributors
│ └── nerd-font-icons-reference.md # 200+ icon documentation
└── scripts/ # Build and validation scripts
├── validate-configs.js # Config validation tool
└── README.md # Scripts documentation
Segments are now stored in separate JSON files by category in public/segments/. This makes it easy to add or modify segments without touching the codebase:
public/segments/languages.json){
"type": "segment-type",
"name": "Display Name",
"description": "Brief description",
"icon": "lang-python",
"defaultTemplate": " {{ .Property }} ",
"properties": [
{
"name": ".Property",
"type": "string",
"description": "Description of this template variable"
}
],
"options": [
{
"name": "option_name",
"type": "boolean",
"default": true,
"description": "What this option does"
}
],
"defaultCache": {
"duration": "168h",
"strategy": "folder"
}
}
{{ }} templates (e.g., .Full, .Path)home_enabled, fetch_version)public/segments/README.md)See public/segments/README.md for detailed instructions.
This project includes comprehensive SEO optimization:
oh my posh, terminal customization, shell prompt, powerline, prompt theme, terminal theme, powershell prompt, zsh theme, bash prompt, terminal configurator, visual editor, drag and drop, oh-my-posh builder, prompt generator
Contributions are welcome! Please feel free to submit a Pull Request.
This project is open source and available under the MIT License.
FAQs
Unknown package
The npm package ohmyposh-configurator receives a total of 23 weekly downloads. As such, ohmyposh-configurator popularity was classified as not popular.
We found that ohmyposh-configurator demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Security News
Lovable’s OJ rewrites Vite’s dev server in Rust, reducing memory use and preview times as AI lowers the cost of open source reimplementation.
Security News
It has been one year since Shai-Hulud made its first appearance on npm.
Research
/Security News
Operators behind PolinRider used a compromised GitHub account to plant malware in four development versions of a Packagist package with 700,000+ downloads.