Command reference

Run commands from the presentation project root. The examples below use npm's project-local runner so the command and output match the Drever version installed with the deck:

npm exec -- drever check
pnpm exec drever check
yarn exec drever check
bunx --no-install drever check

Generated projects also provide npm run dev, npm run check, npm run build, and npm run export. Do not depend on a globally installed drever binary.

For every command that accepts [entry], an explicit path wins over entry in drever.config.ts; otherwise Drever uses slides.mdx. Deck entries must be .md or .mdx files.

You do not need to memorize this interface. Ask your agent for the outcome you want; this page keeps the underlying commands transparent, reproducible, and available for CI or manual use.

Command summary

Help and version

drever --help
drever -h
drever --version
drever -v

Running drever without a command also prints the top-level help. Use drever create --help for the creator's complete option list. Other commands reject unknown flags rather than forwarding them to Vite.

Create and preview

Create a project

drever create [directory]
  [--agent <all|auto|codex|claude|none>]
  [--open <codex|claude>]
  [--package-manager <npm|pnpm|yarn|bun>]
  [--no-install]
  [--json]
  [-h|--help]

The directory defaults to the current directory. Drever installs dependencies and both Codex and Claude Code workflows by default. It detects the active package manager, falling back to npm. --no-install leaves installation to the caller; --json emits a machine-readable receipt.

--open codex or --open claude opens the new project with a prepared task and requires the matching --agent target or the default all. Creation never overwrites existing project files.

The usual npm entry point is the equivalent creator package. Put creator options after npm's -- separator:

npm create drever@latest my-slides
npm create drever@latest my-slides -- --open codex

See Getting started.

Run the development preview

drever dev [entry]

The command starts one HMR-enabled local server and prints Storyboard and Speaker URLs beside Vite's Audience URL. /storyboard reads only drever.plan.json, so it can open before the configured MDX entry exists or compiles; Audience and Speaker still require the deck. Configure host, open, port, and strictPort under server in drever.config.ts; dev deliberately exposes no raw Vite flags and there is no separate drever preview command.

See Configuration and Presenting.

Inspect and connect AI tools

Resolve authoring context

drever context [entry] [--json]

Human output is a concise summary. --json returns the resolved slide and Step manifest, source ranges, canvas, Theme, layouts, components, plugins, and source preflight. This is planning evidence; it does not render React or judge visual quality.

See AI workflows: authoring context.

Read the current slide

drever current [--json]

While drever dev is running, this reads the most recently updated open Audience or Speaker window. The JSON form includes its source path, exact route, slide, sparse Step, surface, and any selected static MDX element. The command fails clearly when no live interactive window is connected and does not accept an entry argument.

See AI workflows: current position.

Serve the read-only MCP

drever mcp [entry]

The dependency-free stdio server exposes context, slide listing, exact slide source, source preflight, and the optional live position. Its tools are read-only, and stdout is reserved for JSON-RPC messages. MDX edits are reread on each call; restart the server after changing config, Theme, or plugin registrations.

See AI workflows: optional read-only MCP.

Refresh project-local AI workflows

drever agent sync [--target <all|auto|codex|claude>]

Use --target all to install both adapters. An omitted target updates Codex; auto follows existing Codex or Claude Code project markers and otherwise chooses Codex. Sync updates only Drever-owned files and managed instruction blocks; it reports a conflict instead of replacing unmarked user-owned content.

See AI workflows.

Validate and deliver

Inspect the environment

drever doctor [--json]

This read-only diagnostic checks the required Node.js version and deck entry. A missing project-local Drever package or Playwright Chromium is reported as a warning because not every workflow needs the browser. doctor never installs software or starts a browser.

See Troubleshooting and support.

Install the matching browser

drever browser install [--with-deps]

This installs the Chromium revision required by the project-local Drever CLI. It is needed for rendered preflight, website design import, and PDF export. Use --with-deps when a Linux host also needs Playwright's operating-system packages.

See PDF export.

Check source and rendered states

drever check [entry] [--rendered] [--json]

The default fast check reports source diagnostics. --rendered additionally builds an isolated inspection app and captures Step 0 plus every exact authored Step. It requires Playwright Chromium. --json emits the versioned report used by agents and CI. The process exits nonzero when errors remain; warnings stay visible without blocking delivery.

See Source and rendered checks.

Build the static website

drever build [entry] [--json]

The default output is dist/, or the safe project-local directory configured by build.outDir. A publishable build requires deck.lang. --json suppresses ordinary build output and emits a versioned artifact receipt with absolute source and output paths.

See Build a static website.

Export PDF

drever export pdf [entry]
  [--steps]
  [--slides <range>]
  [-o|--output <path>]
  [--json]

By default, Drever exports the final authored Step of every slide to <entry-basename>-export.pdf in the project root. --steps includes Step 0 and every exact compiled stop. --slides accepts one-based numbers and inclusive comma-separated ranges such as 2-5,8; it composes with --steps. A custom output must end in .pdf. Export requires deck.lang and Playwright Chromium.

--json emits a versioned PDF artifact receipt.

See Export PDF.

Import design evidence

Start a Theme from a website

drever design import <url>
  [--name <name>]
  [--output <directory>]
  [--color-scheme <light|dark>]
  [--allow-private]
  [--json]

The default color scheme is light. Without --name or --output, Drever derives a Theme name and design/<hostname-slug> directory from the URL. The command requires Playwright Chromium and writes rendered evidence plus a local Pass-0 Theme into a new or empty, non-symlink child directory of the project. It never overwrites existing design files or copies the source website.

Only public HTTP and HTTPS URLs are reachable by default. Use --allow-private deliberately for a trusted localhost or private-network reference; this grants reachability, not trust. --json returns the versioned import receipt.

See Themes and art direction: import design evidence.