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 CLI, 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:
npm i -g @sitemd-cc/sitemd
sitemd init my-site
cd my-site
codex
The scaffolded project ships with a .codex-plugin/ directory, so Codex picks up the skill automatically — your agent has the full sitemd toolset on first launch.
Plugin source: .codex-plugin/ (plugin.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 CLI commands for pages, settings, content generation, SEO, deploy, auth, and more — Codex calls them directly, no manual file editing required
- A Codex skill (
SKILL.md) that loads the project layout, CLI command 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 CLI commands — page CRUD, content generation, SEO audit, deploy, auth, dynamic data, batch operations
- A Codex skill (
SKILL.md) — loads project layout, CLI command reference, settings format, and markdown extensions - 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. Install with npm i -g @sitemd-cc/sitemd then sitemd init my-site — that scaffolds a project with the skill wired for Codex in one step. Codex picks the skill up automatically on first launch.
What CLI commands does sitemd give Codex?
A full suite of commands covering page CRUD, content generation, SEO, deploy, auth, dynamic data, batch operations, content validation, and project status. See CLI 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 CLI command reference, 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 coding agent. The same skill format works across all of them.