Skip to content

🪐 CMD — cmd.aguidetocloud.com

Stop Googling Microsoft. Just type. The first true planet in the A Guide to Cloud universe.

Naming history

CMD is the current brand. It was originally launched as Brain Bar and rebranded mid-2026. The domain (cmd.aguidetocloud.com) and the slug brainbar (in code paths and aguidetocloud-revamp/brainbar/) still reflect the original name — that's tech debt, not a brand decision. In all user-facing copy, use CMD.

CMD is a typed-command universal launcher for Microsoft cloud terminology AND error codes. Type any acronym, license, portal, feature, or product into the URL bar — get a plain-English explainer, the official Microsoft definition, rebrand history, the right portal link, and what cert covers it. Paste an AADSTS / HRESULT / KB code and get the meaning, most likely causes, and a working fix path.

It's the wedge product that proved the Cosmos Philosophy in practice.

What it is, in one screen

Surface What it does
cmd.aguidetocloud.com/ Launcher — [ $ jargon ] [ ! errno ] chips above one prompt; type and hit Enter; tier-1 matches auto-open
cmd.aguidetocloud.com/<slug>/ Jargon entry page — plain-English + official + plans + links
cmd.aguidetocloud.com/decode/ Errno-mode landing — paste an error code, get a curated decode
cmd.aguidetocloud.com/decode/<code>/ Errno entry page — plain English · most likely causes · fix path · seen in · related
<term>.cmd.aguidetocloud.com cmd.ms-style wildcard — mde.cmd.aguidetocloud.com redirects to canonical
/all/ Browseable jargon catalogue grouped by kind (product, portal, license…)
/wishlist/ Public top-20 missed-term aggregate (privacy-safe analytics)
/changelog/ Public release log
/about/ Story + cosmos placement + "what CMD isn't"
/cmd-index.json Public jargon JSON index — consumed by the launcher and the MCP server
/decode/decode-index.json Public errno JSON index — consumed by /decode/ launcher
mcp.aguidetocloud.com/mcp MCP server — CMD inside Claude / ChatGPT / Cursor

Inspired by cmd.ms (Microsoft portal launcher) but expanded — CMD adds the explanation layer: plain-English Sush-takes, rebrand history, related certs/tools/blogs, and an MCP server so AI agents can use it as a knowledge tool.

Architecture

 ┌──────────────────────────────────────┐
 │ data/cmd_entries.toml (truth) │
 │ data/cmd_voice.toml (Sush overlay) │
 └─────────────────┬────────────────────┘
 │ Hugo content adapter
 ┌──────────────────────────┼──────────────────────────┐
 ▼ ▼ ▼
 ┌─────────────────┐ ┌─────────────────────────┐ ┌─────────────────┐
 │ Static HTML pages │ │ /cmd-index.json (search) │ │ /_redirects │
 │ /<slug>/, /all/, │ │ 35 entries · 122 paths │ │ 92 alias 301s │
 │ /wishlist/, etc. │ └────────────┬────────────┘ └─────────────────┘
 └────────┬────────┘ │
 ▼ ▼
 Cloudflare Pages ┌──────────────────────┐
 + Pages Functions │ Cloudflare Worker │
 (functions/api/* │ brainbar-mcp │
 + functions/_middleware) │ (the MCP Move planet) │
 └──────────────────────┘
 │
 ▼
 Claude · Cursor · Cline · ChatGPT

The 6-tier search ranking

The launcher (/static/js/cmd.js) and the MCP server's brainbar_search tool both implement the same deterministic ranking. No fuzzy auto-open — only tier 1-4 exact matches navigate without confirmation.

Tier Match type Auto-open on Enter?
1 Exact slug (mde) ✅
2 Exact abbreviation (MDE) ✅
3 Exact alias (mdatp) — shows "redirects to canonical" ✅
4 Exact slugified old-name (azure-ai-studio) — shows "rebranded — was X" ✅
5 Prefix match on slug or name ❌ list only
6 Substring match (slug, name, plain-English) ❌ list only

Data model

Two TOML files, deliberately separated:

  • data/cmd_entries.toml — entity layer. Reusable across future planets (Shift, Grandma). Schema: slug, name, kind, domain, terms.{aliases,old_names,abbreviations}, plain_english, official, plans, portal_url, learn_url, related_tools, related_certs, related_blogs, status, watch, last_verified.
  • data/cmd_voice.toml — Brain-Bar-specific presentation. mascot, sush_take, sush_take_status. Skipped if no genuine opinion ("silence > forced fit").

A build-time validator (scripts/validate-entries.py) enforces 10 rules including global slug+alias uniqueness, learn_url required for products/portals/features, last_verified ≤365 days, and warns on alias-vs-old-name overlap within an entry.

Disambiguation pages

Ambiguous Microsoft codes (P1, P2, E5, Defender, Copilot) get chooser pages — the launcher routes the bare term to the disambiguation entry, which then lists the candidates. Prevents wrong-product confusion.

The wildcard subdomain (cmd.ms-style)

mde.cmd.aguidetocloud.com → 302 to cmd.aguidetocloud.com/mde/. Implemented as a Cloudflare Pages Function (functions/_middleware.mjs) that reads the Host header. 13/13 offline tests pass.

Unknown subdomains fall back gracefully: xyz.cmd.aguidetocloud.com → cmd.aguidetocloud.com/?q=xyz (drops user into the launcher with the term pre-filled).

The MCP server (the cosmic gem)

Three tools:

  • brainbar_search(query, limit?) — search by slug, alias, name, etc.
  • brainbar_get(slug) — full entry record
  • brainbar_list_kinds(kind?) — discovery, grouped by kind

🔒 Paid-content firewall. The MCP server is allowed to fetch exactly ONE upstream URL: cmd.aguidetocloud.com/cmd-index.json. Hardcoded allowlist + load-time check. This enforces cosmos law #6: no paid content crosses cosmic boundaries via free pathways.

Connect from Claude Desktop:

{
 "mcpServers": {
 "brainbar": { "url": "https://mcp.aguidetocloud.com/mcp" }
 }
}

Privacy-safe analytics

The /wishlist/ page shows the top-20 missed-term aggregate over 30 days. No IP, no User-Agent, no session — only (term, day) pairs in Cloudflare D1. Minimum threshold of 2 to avoid amplifying one-off typos. Full server-side firewall on origin (only cmd.aguidetocloud.com and *.cmd.aguidetocloud.com can write).

Without the D1 binding (local dev / preview), endpoints short-circuit gracefully — no errors, no data lost.

Place in the cosmos

🌍 aguidetocloud.com (Earth)
 └── 🌑 /guided/ (Moon — cert prep + paid practice exams)

🪐 cmd.aguidetocloud.com           ← CMD (this planet)
🪐 shift.aguidetocloud.com         ← Shift (the AI job-change wire)
🪐 plainai.aguidetocloud.com       ← Plain AI (AI explained plainly, for everyone)
🪐 agents.aguidetocloud.com        ← Agentic (cockpit field-guide)
🪐 claw.aguidetocloud.com          ← Claw (OpenClaw study reference)

⭐ mcp.aguidetocloud.com           ← The MCP Move (CMD's star)