CLI Usage — Rustume

The rustume CLI exposes the same core engine as the web app and REST API — parse external formats, validate schema, render PDFs, and generate PNG previews — without a browser.

Installation

From a release binary — download the appropriate archive from GitHub Releases for your platform (Linux, macOS, Windows).

From source

git clone https://github.com/lgtm-hq/Rustume.git
cd Rustume
cargo install --path crates/cli

Verify:

rustume --version
rustume --help

Global flags

Flag	Description
`-d`, `--debug`	Enable debug logging via `tracing` (`RUST_LOG=rustume=debug`)
`-h`, `--help`	Show help
`-V`, `--version`	Print version

Subcommands

Command	Purpose
`parse`	Convert JSON Resume, LinkedIn, Reactive Resume (`rrv3`), or Rustume JSON
`render`	Generate a PDF from Rustume JSON
`preview`	Generate a PNG preview of a specific page
`templates`	List available Typst templates
`validate`	Check resume data against the schema
`init`	Create a new empty (or sample) resume JSON

Common workflows

Convert and render in one pipeline

rustume parse linkedin.zip -o resume.json
rustume validate resume.json
rustume render resume.json -t onyx -o resume.pdf

Use stdin/stdout

cat resume.json | rustume validate -
rustume parse resume.json | rustume render - -o out.pdf

Quick sample resume

rustume init --sample -o sample.json
rustume preview sample.json -o preview.png

Exit codes

The CLI exits 0 on success and 1 on error. Validation failures print field-level errors to stderr.