The best way to build websites with Codex
sitemd is a static site generator / website building toolkit for AI coding agents like Codex.
It's a complete agent-driven framework with MCP server, dev server, skill, guardrails, best practices, and one-line integrations for essentials like SEO, analytics, content generation, doc writing, user login, content gating, dynamic data + detail pages, and more.
It's a site-building superpower for Codex.
Install sitemd for Codex
Scaffold a fresh sitemd project and open it in Codex CLI:
npx @sitemd-cc/sitemd init my-site
cd my-site
codex
The sitemd binary is fetched automatically as part of npx init (via the package's postinstall hook) — no separate install step. The scaffolded project ships with a .codex-plugin/ directory and a pre-configured .mcp.json at the root, so Codex picks up the skill and MCP server automatically — your agent has the full sitemd toolset on first launch.
Plugin source: .codex-plugin/ (plugin.json, .mcp.json) on the public sitemd repo.
Why use sitemd with Codex
Codex is amazing at writing code, and will already happily build websites from scratch. Adding sitemd makes the process faster and reduces friction.
sitemd is a super-efficient toolkit for coding agents to build websites. It ships with:
- A full suite of MCP tools for pages, settings, content generation, SEO, deploy, auth, and more — Codex calls them directly via the pre-configured
.mcp.json, no manual file editing required - A Codex skill (
SKILL.md) that loads the project layout, MCP tool reference, settings format, and markdown extensions into Codex's context as soon as it enters a sitemd project - A complete framework under the hood: auth, gated content, forms, deploy targets, image handling, dynamic data, theming, premium modules — none of which you and Codex have to invent
- Markdown all the way down — every page, every setting, every navigation file is human-readable
.md. Codex reads markdown natively, edits it confidently, and never has to reverse-engineer an external build system
Why not just prompt Codex to build a site from scratch?
sitemd is a site-building superpower for Codex. It helps Codex build a consistent working site quickly by skipping all the scaffolding that's already baked-in to sitemd. sitemd is still very flexible and customizable, so you and Codex can still build sites however you want. sitemd also ships with one-line integrations for essentials like SEO, analytics, content generation, doc writing, user login, content gating, dynamic data + detail pages, and more that would take considerable time for you and Codex to build from scratch.
What Codex gets out of the box
- A full suite of MCP tools — page CRUD, content generation, SEO audit, deploy, auth, dynamic data, batch operations
- A Codex skill (
SKILL.md) — loads project layout, MCP tool reference, settings format, and markdown extensions - Pre-configured
.mcp.json— Codex picks up the MCP server with zero manual configuration - Auto-generated SEO — Open Graph, JSON-LD, sitemap, robots.txt, llms.txt, OG images
- Deploy targets — Cloudflare Pages, Netlify, Vercel, GitHub Pages with one command
- Auth providers — Supabase, Firebase, Clerk, Auth0, custom API
- Dynamic data — Supabase, Firebase, Airtable, REST API with auto-generated detail pages
- Forms, embeds, galleries, modals, gated content, theming, dark mode, i18n-friendly markdown
Build your first site with Codex
After install, in any Codex session inside a sitemd project:
"Build me a documentation site for my SaaS product"
Codex calls sitemd_status, then sitemd_site_context to learn the conventions, then sitemd_pages_create_batch to scaffold pages, then sitemd_content_validate to check quality, then sitemd_deploy when you confirm. The skill surfaces the right context as the agent works. You watch the dev server preview update live.
You can also run a skill directly:
/kickstart a portfolio site for a freelance designer named Mira
That spins up a complete first-draft site — pages, navigation, settings, theme, copy — from a single sentence.
Codex FAQ
Does sitemd work with Codex?
Yes. The recommended path is npx @sitemd-cc/sitemd init my-site — that scaffolds a project, downloads the binary automatically via the npm postinstall hook, and wires up the MCP server, skill, and .mcp.json for Codex in one step. Codex picks the skill up automatically on first launch.
What MCP tools does sitemd give Codex?
A full suite of tools covering page CRUD, content generation, SEO, deploy, auth, dynamic data, batch operations, content validation, and project status. See MCP Server for the full list.
How does the Codex skill work?
It's a SKILL.md file in .codex-plugin/ that Codex loads as context. It contains the project layout, the MCP tool reference table, the settings format, and the markdown extension reference — so Codex doesn't have to rediscover the structure every session.
Do I have to host my site with sitemd?
No, and you couldn't even if you wanted to. sitemd isn't a website hosting service — it's a website building toolkit you install on your machine. You'll build your site locally, then deploy & host wherever you want.
Is there a free version/trial?
Yes. sitemd can run in free trial mode forever. You can preview all features in trial mode. You only need to pay when it's time to deploy your site.
Can I use sitemd for client sites?
Absolutely. 15% bulk discount when purchasing 50+ site slots at one time.
What other agents does sitemd support?
Claude Code, Cursor, Gemini, OpenClaw, and any MCP-capable agent. The same MCP server and skill format work across all of them.