@cortex-docs/cli is the command-line interface for Cortex Docs.
Install the CLI:
npm install --global @cortex-docs/cliCreate a project:
cortex init my-api --open-api ./openapi.yaml
cd my-api
cortex generate
cortex docs serveBuild static HTML documentation for deployment:
cortex docs build --output .cortex/docsDeploy the output directory to a static web host. Configure page URLs such as /docs/quickstart to resolve to /docs/quickstart.html.
The deployed site needs no Node.js server. Rebuild the site after source changes.
Commit cortex.config.yml and your Markdown to the default branch of a public GitHub repository. Then run:
cortex deploy https://github.com/OWNER/REPOThe project configuration value becomes PROJECT.cortexdocs.dev. Deploy requires gh auth login or GITHUB_TOKEN with repository write access.
If documentation inputs are unchanged, deployment skips the build and upload. Use deploy.domain for a verified custom domain.
cortex mcp-serve https://github.com/OWNER/REPOThis stdio server checks the default branch before each documentation request. Configure your MCP client to run the command as a local process.
The existing cortex mcp generate and npm publishing commands remain available.
Read the hosting guide for client setup, automatic deployment, and limits.
Read the Cortex Docs repository for the complete documentation.