ReadMe CLI

A command-line tool for writing, previewing, and managing your ReadMe docs from your terminal.

We want feedback! If you need a new feature or find a bug, please open an issue.

Commands

Linting

Checks your docs for errors: things like invalid frontmatter, missing files, duplicate slugs, and more. Handy for catching issues before you push.

npx @readme/cli lint [--fix] [--json]

Use --fix to automatically fix what it can, or --json for machine-readable output (great for CI).

OpenAPI Sync

Syncs your reference/ directory with your OpenAPI spec. It'll create, update, or remove pages based on your spec's operations.

npx @readme/cli oas:sync

Import

Imports content from an external folder and converts it into ReadMe's format using Claude. Great for migrating existing docs.

npx @readme/cli import

Versions

Lists all your doc versions and their branches.

npx @readme/cli versions

Dev Server

Very early beta! This command is still a work in progress, and doesn't use our rendering engine yet.

Starts a local dev server so you can preview your docs as you write them. Watches for changes and refreshes automatically.

npx @readme/cli dev

Feedback

If something doesn't work right, or if you have suggestions, please open an issue. We're actively building this and want to hear from you.