explaingit

jeromeetienne/resumejson_cli

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5LicenseSetup · moderate

TLDR

A command line tool that converts resumes between PDF, JSON, and Markdown, and uses AI to score and rewrite them for better ATS performance.

Mindmap

mindmap
  root((repo))
    What it does
      Converts resume formats
      Scores ATS readiness
      Rewrites resume content
    Tech stack
      TypeScript
      Node.js
      OpenAI API
    Use cases
      Extract JSON from a PDF resume
      Score and improve ATS friendliness
      Chain steps into a full pipeline
    Audience
      Developers
      Job seekers
    Setup
      npm install globally
      Set OpenAI API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert an existing PDF resume into structured JSON that can be edited or reused.

USE CASE 2

Get a numerical score of how well a resume will perform against ATS filtering software.

USE CASE 3

Automatically rewrite a resume based on an AI generated review of its weaknesses.

USE CASE 4

Chain conversion and ATS commands into one scripted end-to-end resume pipeline.

What is it built with?

TypeScriptNode.jsOpenAI APISQLite

How does it compare?

jeromeetienne/resumejson_cli0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20+ and an OpenAI API key for every AI backed command.

Use freely for any purpose, including commercial use, with minimal restrictions and no warranty.

In plain English

resumejson_cli is a command line tool that converts resumes between PDF, JSON, and Markdown formats, and runs an AI powered pipeline to score and improve how well a resume performs against Applicant Tracking Systems, the automated software many companies use to filter job applications. At the center of the tool is a structured JSON format for resumes, checked against a fixed schema. Every command either reads or writes this JSON, so the output of one step can feed directly into the next, or be inspected and edited by hand along the way. The from_pdf command extracts this structured data out of an existing PDF resume using a vision model that reads the rendered pages, while to_pdf and to_markdown render the JSON back into a formatted PDF or Markdown file. The ATS pipeline adds several more commands on top of format conversion. ats_score gives a numerical readiness score you can use to compare before and after versions. ats_review produces a written review covering strengths, weaknesses, and suggestions. ats_question generates the kind of screening questions a recruiter's software might ask, ats_answering drafts answers to them using the resume as context, and ats_optimize rewrites the resume guided by the review. A documented full pipeline chains all of these steps together, from PDF ingestion through to a final optimized PDF and Markdown export. The tool also ships a SKILL.md file that can be installed into an AI agent's skill folder, letting an agent like Claude drive the CLI directly. Running the AI backed commands requires Node.js 20 or newer and an OpenAI API key set as an environment variable, since these commands call OpenAI's models by default. This project is aimed at developers or job seekers comfortable with a command line who want a scriptable way to check and improve a resume's ATS friendliness. It is released under the ISC license.

Copy-paste prompts

Prompt 1
Help me set my OpenAI API key and run from_pdf to convert my resume.pdf into resume.json.
Prompt 2
Walk me through the full ATS pipeline commands to score, review, and optimize my resume.json.
Prompt 3
Explain the difference between ats_review and ats_optimize and when to run each one.
Prompt 4
Show me how to install the bundled SKILL.md so a Claude agent can drive this CLI directly.

Frequently asked questions

What is resumejson_cli?

A command line tool that converts resumes between PDF, JSON, and Markdown, and uses AI to score and rewrite them for better ATS performance.

What language is resumejson_cli written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, OpenAI API.

What license does resumejson_cli use?

Use freely for any purpose, including commercial use, with minimal restrictions and no warranty.

How hard is resumejson_cli to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is resumejson_cli for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.