Stop wrestling with Docusaurus config files, "docmd" is zero-config alternative is built for the AI era
If you’ve ever spent three hours configuring Webpack, fixing broken npm dependencies, or tweaking a docusaurus.config.js or mkdocs.yml file just to spin up a basic documentation site, you know the fatigue is real.
I recently stumbled upon an emerging open-source tool called docmd (strictly lowercase), and it feels like exactly where documentation engines should be heading. It strips away all the framework bloat and focuses entirely on speed, security, and AI compatibility.
Here is a quick, honest breakdown of what it is and why it's a massive upgrade from traditional tools:
What actually is it?
docmd is a zero-configuration, local-first documentation engine. You point it at a folder of raw Markdown files, run a single command, and it compiles a blazing-fast, Single Page Application (SPA) instantly.
Why it beats traditional tools at scale:
- Zero Configuration: There are no bulky boilerplate setups. You run npx docmd build and it automatically maps your folder structures, handles asset routing, and builds your site out of the box.
- Insane Performance (~18 KB Payload): Tools like Docusaurus load heavy React component hydration trees for every route, causing massive bloat on large sites. docmd compiles down to pure vanilla DOM manipulation with a client payload of under 20kb. Pages load instantly with a literal 100/100 Lighthouse score.
- 100% Local Semantic Search: Most documentation generators force you to pay for or configure third-party cloud services like Algolia just to get a functional search bar. docmd runs full-text and fuzzy search entirely on the client side using browser-side tokenizers. Zero data ever leaves your machine.
- Built for AI Agents (The Secret Weapon): This isn't just for human eyes. docmd natively handles the shifting developer landscape. It auto-generates structured llms.txt context buffers at build time and features a native Model Context Protocol (MCP) server (docmd mcp). If you use AI assistants like Claude Code or Cursor, they can plug directly into your local docs via stdio to eliminate code hallucinations completely.
Evolution: From 0.1 to Now
The project didn't just stop at basic Markdown parsing. The developers have been aggressively shipping high-discipline engineering updates:
- Multi-threaded Worker Pools: It handles thousands of enterprise documents concurrently without hitting single-thread Node bottlenecks.
- Strict Security Hardening: They systematically stripped raw innerHTML execution across the monorepo to eliminate XSS vulnerabilities, making it safe for secure, air-gapped corporate setups.
- Modular Custom Plugins: Instead of bloating the core engine with heavy third-party npm packages, they custom-engineered micro-libraries like lite-matter (frontmatter parsing) and lite-hl (syntax highlighting) to keep execution lightning fast.
Quick Test Drive
You don’t even need to install it to see how it looks. Drop some markdown files in a folder and run:
npx @docmd/core build
If you are using Claude Code or Cursor and want to feed it the native developer rules, you can install the standalone skill set directly to your agent directory:
npx docmd-skills ~/.claude/skills
It’s completely free, MIT-licensed, and 100% offline. If you're tired of framework bloat or want to give your AI tools better codebase context, it is well worth checking out.
GitHub Project: github.com