resumec is a cross-platform Rust CLI that compiles ATS-friendly resume data from JSON, TOML, or YAML into final PDF and editable DOCX outputs.
schema_version: 1) shared across JSON/TOML/YAMLclassic, modern, and minimal themesInstall with Rust 1.85 or newer:
cargo install --path .
Build a release binary locally:
cargo build --release
Schemas are published in:
schemas/resume.schema.jsonschemas/theme.schema.jsonAn example resume lives at:
examples/resume.yamlCore fields:
schema_versionbasicsworkeducationskillscertifications, projects, languages, awardstheme, locale, target_roleresumec build <input> [options]
resumec validate <input>
resumec theme list
resumec theme new <name>
resumec theme install <path-or-url>
resumec init [--format json|toml|yaml]
resumec config show
resumec config set <key> <value>
resumec mcp serve
resumec completion <shell>
resumec build examples/resume.yaml --format both --theme modern --output-dir dist --overwrite
resumec validate examples/resume.yaml
resumec build examples/resume.yaml --format both --json-output --overwrite
Example output:
{
"status": "success",
"data": {
"input_file": "examples/resume.yaml",
"theme": "modern",
"outputs": [
{
"format": "pdf",
"path": "dist/resume.pdf",
"bytes": 84213
},
{
"format": "docx",
"path": "dist/resume.docx",
"bytes": 45120
}
],
"warnings": []
},
"warnings": [],
"errors": []
}
0: success1: schema validation failure2: theme not found3: write/overwrite failure4: input parsing/read failure5: invalid theme definition6: network failure7: configuration failure8: MCP protocol failureresumec stores application state in the platform config directory via directories:
%APPDATA%\resumec\~/Library/Application Support/resumec/~/.config/resumec/Contents:
preferences.jsonthemes/Set RESUMEC_CONFIG_DIR to override this location in isolated environments or
automated tests.
Example:
resumec config set theme modern
resumec config set format both
resumec config show
Built-in themes:
classic: traditional single-column ATS-safe layoutmodern: accent color hierarchy with ATS-safe orderingminimal: compact presentation with reduced spacingresumec theme new my-theme
This creates ./my-theme/theme.yml.
resumec theme install ./my-theme
resumec theme install https://example.com/theme.yml
Workflow included at .github/workflows/resume.yml.
Behavior:
resumec validatemain run resumec build --format both --json-outputProject automation is split by responsibility:
.github/workflows/ci.yml checks formatting, Clippy, documentation, and tests
on Linux, macOS, and Windows..github/workflows/resume.yml validates the example and uploads generated
resume files from main..github/workflows/release.yml builds platform binaries and publishes a
GitHub release for semantic-version tags such as v0.2.0.Use an Execute Command node:
resumec build /data/resume.yaml --format both --json-output --overwrite
Then parse the node stdout as JSON and read data.outputs for generated file paths.
Start the local stdio server:
resumec mcp serve
Supported methods:
initializetools/listtools/callSupported tools:
validate_resumebuild_resumelist_themesget_preferencesExample request line:
{"id":1,"method":"tools/call","params":{"name":"validate_resume","arguments":{"input":"examples/resume.yaml"}}}
resumec completion bash > /tmp/resumec.bash
resumec completion zsh > /tmp/_resumec
cargo test
The test suite covers:
PDF output is generated natively with printpdf. No external browser or system PDF runtime is required.
Dual-licensed under MIT or Apache-2.0.