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.
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).
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:syncImports content from an external folder and converts it into ReadMe's format using Claude. Great for migrating existing docs.
npx @readme/cli importLists all your doc versions and their branches.
npx @readme/cli versionsVery 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 devIf 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.