🤖 resume-analyzer

An AI-powered CLI that analyzes your resume against a job description and scores how well they match.

Installation

npm install -g @anth0nycodes/resume-analyzer

Setup

The CLI calls the OpenAI API with your own API key, so you need one before running an analysis.

1. Get an API key — run resume-analyzer config --aki for step-by-step instructions.

2. Save it:

   resume-analyzer config --set-api-key <api-key>

3. (Optional) Pick a default model:

   resume-analyzer models

Your API key, default model, and analysis history live in ~/.resume-analyzer/.

Note

An OpenAI API key needs billing credits to work — a ChatGPT Plus subscription does not cover API usage.

Usage

Default

resume-analyzer

Shows basic information about the tool. Run resume-analyzer -h / resume-analyzer --help for additional information.

Commands

Analyze a Resume

Run an analysis against a job description:

resume-analyzer analyze

The flow is interactive:

1. Pick your resume — via a native file dialog, or from a list of files in Desktop/ and Downloads/.
2. Paste the job description into your $EDITOR ($VISUAL/$EDITOR, falling back to vi or notepad), then save and close.
3. The resume is converted to Markdown and sent to OpenAI along with the job description.

You get back a score out of 100, plus strengths, suggestions, gaps, and missing keywords — all judged against that specific posting. Every run is saved to your history.

Note

Only PDF and DOCX resumes are supported.

View History

Browse past analyses in an interactive picker:

resume-analyzer history

Or jump straight to a run by its ID:

resume-analyzer history <run-id>

Manage Models

Pick the default model interactively:

resume-analyzer models

List the supported models (the current default is marked):

resume-analyzer models --lm
# or
resume-analyzer models --list-models

Set your default model:

resume-analyzer models --sm <model>
# or
resume-analyzer models --set-model <model>

Reset your default model:

resume-analyzer models --rm
# or
resume-analyzer models --reset-model

API Key Info

Show instructions on how to create an OpenAI API key:

resume-analyzer config --aki
# or
resume-analyzer config --api-key-info

Set API Key

Set your API key:

resume-analyzer config --sak <api-key>
# or
resume-analyzer config --set-api-key <api-key>

Show Config

Display your current configuration settings (contains API key):

resume-analyzer config --sc
# or
resume-analyzer config --show-config

Reset Config

Resets your current configuration settings (clears API key and default model):

resume-analyzer config --rc
# or
resume-analyzer config --reset-config

Contributing

Contributions are welcome! Whether it's a bug fix, new feature, or docs improvement, see CONTRIBUTING.md for how to get started.

Found a bug? Open a bug report.