resumec

CI License: MIT OR Apache-2.0

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.

Highlights

Installation

Install with Rust 1.85 or newer:

cargo install --path .

Build a release binary locally:

cargo build --release

Resume schema

Schemas are published in:

An example resume lives at:

Core fields:

CLI usage

resumec 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>

Build a resume

resumec build examples/resume.yaml --format both --theme modern --output-dir dist --overwrite

Validate only

resumec validate examples/resume.yaml

Machine-readable mode

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": []
}

Exit codes

Configuration directory

resumec stores application state in the platform config directory via directories:

Contents:

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

Themes

Built-in themes:

Create a new theme

resumec theme new my-theme

This creates ./my-theme/theme.yml.

Install a theme

resumec theme install ./my-theme
resumec theme install https://example.com/theme.yml

GitHub Actions example

Workflow included at .github/workflows/resume.yml.

Behavior:

Project automation is split by responsibility:

n8n example

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.

MCP mode

Start the local stdio server:

resumec mcp serve

Supported methods:

Supported tools:

Example request line:

{"id":1,"method":"tools/call","params":{"name":"validate_resume","arguments":{"input":"examples/resume.yaml"}}}

Shell completion

resumec completion bash > /tmp/resumec.bash
resumec completion zsh > /tmp/_resumec

Tests

cargo test

The test suite covers:

Notes on PDF generation

PDF output is generated natively with printpdf. No external browser or system PDF runtime is required.

License

Dual-licensed under MIT or Apache-2.0.