Getting Started — JSON Resume

Command Line Tool

We've built a CLI (Command Line Interface) which is supported by OSX, Linux and Windows. To create your own resume, install resume-cli from npm:

npm install -g resume-cli

Note: The official CLI tool isn't that actively maintained. There is an alternative that you might have more success with @rbardini/resumed


The command line tool uses an ecosystem of modules that we've open sourced to convert your resume to different formats:

resume export resume.pdf

resume export resume.html

Import from LinkedIn

One of our community members wrote a great Chrome extension to import your LinkedIn Profile.

Download here


JSON Resume offers a hosting service that renders your resume.json to any theme you would like.


All you have to do is create a Gist on GitHub named resume.json.


Our hosting service will automatically detect this when you access{your_github_username}

To set a theme, just add to your resume.json;
{ "meta": { "theme": "elegant" } }

Use your own repository (instead of a gist)

Basically, you can just make a Github Action, that publishes your gist when you push to your own repo. Example below;


Raw Formats

You can access more raw formats of your resume too!


AI (completely experimental)

These urls are integrated with OpenAI ChatGPT, and will pass your resume to them with a predefined prompt to get a new response generated each time. (they take over 10 seconds to run so be paitience)

Interview Yourself or Be Interviewed (using OpenAI GPT-3 your resume.json gets inserted in the prompt and you can talk to or at yourself) -

Recommended Jobs (tries to match your resume to recent Who is Hiring? hn posts) -

Cover Letter (attempts to write a cover letter that matches your resume) -

Resume Suggestions (it asks ChatGPT to give precise feedback for improvements you could make to your resume) -

QR Service

If you want to generate a QR code that links to your hosted resume, use e.g.