resumectl - Your Resume as Code

Demo

Features

Multiple Formats

Generate your resume in HTML, PDF, or view it directly in your terminal.

5 Themes

Choose from modern, classic, minimal, elegant, or tech themes.

Custom Colors

Customize any theme with your own primary color using --color.

Single Binary

Templates embedded in the binary. No external files needed.

Photo Support

Add your photo with grayscale filter and round/square shape options.

Live Preview

Start a local server with resumectl serve for instant preview.

LinkedIn Import

Import your profile data directly from LinkedIn with resumectl init.

GitHub Projects

Automatically add your top GitHub projects sorted by stars.

Installation

Requirements

Go 1.21+
PDF generator: Google Chrome, Chromium, or WeasyPrint

Build from source

git clone https://github.com/juhnny5/resumectl.git
cd resumectl
go mod tidy
make build

Initialize from LinkedIn & GitHub

The init command lets you bootstrap your CV by importing data from LinkedIn and GitHub.

Quick Start

# Create an empty CV template
resumectl init

# Import from LinkedIn (public data only)
resumectl init --linkedin johndoe

# Import with full LinkedIn data (requires cookie)
resumectl init --linkedin johndoe --cookie "YOUR_LI_AT_COOKIE"

# Add top GitHub projects
resumectl init --github yourusername

# Combine both platforms
resumectl init --linkedin johndoe --cookie "AQEDAx..." --github yourusername

# Customize number of GitHub projects (default: 5)
resumectl init --github yourusername --projects 10

LinkedIn Authentication

To get full profile data (experiences, education, skills), you need your LinkedIn session cookie:

Log in to LinkedIn in your browser
Open Developer Tools (F12)
Go to Application → Cookies → linkedin.com
Copy the value of the li_at cookie

Usage

# Generate HTML and PDF
resumectl generate

# Generate HTML only
resumectl generate --html

# Generate PDF only
resumectl generate --pdf

# Use custom YAML file
resumectl generate -d my_cv.yaml

# Use specific theme
resumectl generate --theme elegant

# Custom color (any theme)
resumectl generate --color #ff5733

# Live preview with auto-reload
resumectl serve
resumectl serve --port 3000

# Show CV in terminal
resumectl show

# Validate YAML file
resumectl validate

# List available themes
resumectl themes

Photo Options

Add a photo to your resume with optional filters:

personal:
  photo: "photo.jpg"        # Path to your photo
  photoGrayscale: true      # Black and white filter
  photoShape: "square"      # "round" (default) or "square"

Themes

Choose from 5 beautiful themes for your resume:

Modern

--theme modern

Classic

--theme classic

Minimal

--theme minimal

Elegant

--theme elegant

Tech

--theme tech

Generate your resume from a YAML file to PDF, HTML, or directly in your terminal.