CLI

Run React framework scripts and renoun utilities from a single command-line interface.

The renoun CLI keeps the background language tools in sync with your project while you work. It starts a persistent server that handles syntax highlighting, type checking, and grammar loading so your React framework can focus on rendering.

Framework commands

When you run a framework command through the CLI, renoun boots its background services before forwarding every flag and positional argument to the framework. This keeps the developer experience identical to your existing scripts while ensuring renoun stays connected to your content.

  • Next.js — renoun next dev (defaults to dev when no subcommand is supplied)
  • Vite — renoun vite dev
  • Waku — renoun waku dev

Update your package.json scripts to prepend renoun to the framework commands you already use:

{
  "scripts": {
    "dev": "renoun next dev",
    "build": "renoun next build"
  }
}

You can pass through additional flags with the standard -- separator. For example, the following command enables Vite’s production optimizations while renoun keeps the grammar cache in sync:

renoun vite build -- --mode production

Pruning theme files

Use renoun theme to minimize VS Code theme JSON files. The command validates the input file, removes unused properties, and writes the optimized JSON back to the same path:

renoun theme path/to/theme.json

Use renoun validate to check for broken internal links in your MDX content or on a running site.

  • Static analysis (default) : Parses MDX to collect links and validates them against routes inferred from your MDX file structure. External links and dynamic JSX href values are skipped. Files and directories matched by your root .gitignore are ignored.
  • Runtime crawler (URL) : Follows links on a running site and checks responses.

Usage

Run static MDX analysis across the workspace:

renoun validate

Run static MDX analysis only for files under the provided directory:

renoun validate ./docs

Run live validation by crawling the provided URL:

renoun validate http://localhost:3000/

When broken links are found, the command reports the source MDX file and the normalized link path (for static), or the failing URL and HTTP status (for live).

Last updated