Skip to content
Agents tracked: 502 Releases (7d): 762 Agent status: no reported issuesSince last limit reset: Claude 11d · Codex 9d For AI agents: Markdown Updated Nov 22, 2026

Oh My Posh Validator

by JanDeDobbeleer

check terminal prompt settings.

OtherOfficialRemote

GitHubWebsite

1. Made by

“The Oh My Posh MCP (Model Context Protocol) Server is a validation service that allows you to validate your oh-my-posh theme configurations against the official JSON schema.”

The server lives in the Oh My Posh repository itself and runs on the project's own domain ohmyposh.dev, which also documents it; the registry name dev.ohmyposh matches that domain.

ohmyposh.dev/docs/advanced/mcp-server

Checked against its repository at one commit, on Nov 10, 2026. Tap a verdict to see its source.How we checkedReport an error

What Oh My Posh Validator does

Oh My Posh draws a custom prompt line in your terminal, with your folder, branch and other details. This free online checker lets your AI assistant test an Oh My Posh settings file, or one piece of it, before you load it. It says exactly which line is wrong and why.

What people use it for

Check a new prompt theme before loading it

Your assistant edits your theme file, then checks the whole file. A broken file is caught before your terminal shows an error at startup.

Try one prompt piece on its own

Test a single block, such as the folder path or the git branch, before you add it to your full theme.

Find the exact broken setting

When a theme fails, the checker points to the setting that is wrong, for example a block type that does not exist, and lists the allowed values.

Settings written in YAML or TOML

Keep your theme in the file format you like. The checker reads all three formats Oh My Posh uses and detects which one you sent.

Clean up an old theme after an upgrade

Old themes still work but use outdated names. The checker warns about them, such as a renamed settings field, so you can update the file.

Let your assistant design a prompt for you Idea

Describe the look you want, such as a two-line prompt with time on the right. The assistant writes the theme and checks it before handing it over.

Oh My Posh Validator popularity

23.8K
GitHub stars, JanDeDobbeleer/oh-my-posh
0
public agent projects connect it
Oh My Posh Validator: GitHub starsJanDeDobbeleer/oh-my-posh 23,769

Tools it gives your agent (2)

What it sends and its license

Sends

the full text of the theme or segment you check

To ohmyposh.dev (the Oh My Posh website's server); on every validate_config or validate_segment call. Opt out: do not send files that hold secrets; or check the file in your editor with the "$schema" line.

The checker is a free public service with no sign-up. Its code is part of Oh My Posh, which is under the MIT license, so you may reuse it with the license notice kept.

In a paid app
Yes

The service is free with no sign-up, and the Oh My Posh code is MIT-licensed.

“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction” source

Pass on its files
With conditions

You may copy or self-host the checker's code if the MIT copyright and permission notice stays with it.

“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.” source

Is it alive

Latest version

31.8.0 in the registry, updated Oct 20, 2026

Last release

Oh My Posh v32.0.0 on 2026-11-08 (GitHub release); the registry entry still says 31.8.0. Code read at commit b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675.

Remote endpoint
unclear: one unauthenticated HEAD to https://ohmyposh.dev/api/mcp answered 404, as expected, because the function accepts only GET, POST and OPTIONS (function.json); not re-checked with GET

Alternatives

Oh My Posh Validator This page

23.8K starsRemote

ajv

Pick it if you need to check settings files offline in your own script or build

Local

nerd-fonts

Pick it if the prompt shows boxes instead of icons after a valid theme loads

Local

All other servers

Get started

Tell your AI assistant

“Validate my Oh My Posh theme with the oh-my-posh-validator server (validate_config), fix every error it reports, and show me the corrected file before I reload my shell.”

Connect it

claude mcp add --transport http oh-my-posh-validator https://ohmyposh.dev/api/mcp

The docs give one JSON block for any MCP client; they name no separate Claude Code, Cursor or Codex command.

Mistakes to avoid

Giving a segment a "properties" object, as old themes do
Rename the field to "options"

The checker flags "properties" as deprecated and asks for "options".

Sending a segment to validate_segment without type or style
Always set both "type" and "style" on a segment

The segment check stops at once with a missing-property error and skips the full rules.

Leaving out "$schema" in the theme file
Add "$schema" pointing to the official schema.json

The checker recommends it, and editors use it to suggest and check fields as you type.

Using a relative path or ~ for the config file on Windows cmd
Use the full path to the config file

The cmd setup in the docs needs the full path, not a relative one.

Questions

Do I need to install anything?

No. The checker runs on ohmyposh.dev and your AI app reaches it over the web.

Which file formats can it check?

JSON, YAML and TOML. Leave the format on auto and it detects which one you sent.

What does it return?

Whether the file is valid, a list of errors with the path to each bad setting, warnings, and the format it detected.

Can I call it without an AI app?

Yes. It answers plain web requests, for example with curl, using the same tool names.