explaingit

notnotparas/pushcv-cli

Analysis updated 2026-05-18

52PythonAudience · generalComplexity · 2/5Setup · moderate

TLDR

A local, privacy focused command line tool that tracks your job applications as a terminal Kanban board and tailors resumes using a local AI model.

Mindmap

mindmap
  root((pushcv-cli))
    What it does
      Job application tracker
      Kanban board in terminal
      Local resume tailoring
    Tech stack
      Python
      Typer
      SQLite
      LiteLLM
    Use cases
      Track applications
      Scrape job postings
      Tailor resumes locally
    Audience
      Job seekers
      Privacy conscious users

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

Track job applications through drafting, applied, interviewing, and closed stages on a terminal board.

USE CASE 2

Scrape a job posting from LinkedIn, Greenhouse, Lever, or SmartRecruiters with one command.

USE CASE 3

Generate a tailored resume or cover letter for a specific job using a local AI model, with no cloud calls.

USE CASE 4

Export all tracked job application data to JSON or CSV at any time.

What is it built with?

PythonTyperRichSQLModelSQLiteLiteLLM

How does it compare?

notnotparas/pushcv-cliamaravijayalakshmi216-collab/crop-recommendation-systembiansy000/mda
Stars525252
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity2/52/55/5
Audiencegeneralresearcherresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Resume tailoring requires setting up a separate local AI inference server, core tracking works without it.

The README does not state a license for this project.

In plain English

This is a command line tool for tracking a job search, described by its author as git for job hunting. Everything runs on your own computer using a local file based database, so no account is needed and no personal data leaves your machine. The tool shows your job applications as a Kanban style board right in your terminal, moving jobs through stages like drafting, applied, interviewing, and closed. It can scrape a job posting directly from a pasted link, supporting LinkedIn, Greenhouse, Lever, and SmartRecruiters, and falls back to a general parser for most other careers pages. It also flags applications that have gone quiet for a while so you remember to follow up, and lets you keep dated notes on each job. One of its more distinctive features is resume and cover letter tailoring using a local AI model rather than a cloud service. You fill in a profile file describing your background, experience, and skills, and the tool uses only that information, without inventing anything, to generate a resume tailored to a specific job posting. This requires running a separate local AI server on your own machine, since the tool does not call out to any commercial AI provider for this feature. There is also an experimental salary estimate feature that searches the web for comparable pay data, which can be turned off in settings. Installation is done through standard Python packaging tools, and the whole tool can even be tried without a permanent install using a single command. All tracked data can be exported to JSON or CSV files at any time, so nothing is locked in. This is aimed at job seekers who are comfortable using a terminal and want to keep their job search data private and organized, rather than using a spreadsheet or a cloud based tracker.

Copy-paste prompts

Prompt 1
Walk me through installing pushcv with pipx and running pushcv init to set up my job tracker.
Prompt 2
Help me fill in profile.md so pushcv can tailor resumes accurately from my real experience.
Prompt 3
Show me how to scrape a LinkedIn job posting into pushcv and move it through the application stages.
Prompt 4
Explain how to set up a local AI server like Lemonade so pushcv draft can generate tailored resumes.
Prompt 5
Help me export my tracked job applications from pushcv to a CSV file.

Frequently asked questions

What is pushcv-cli?

A local, privacy focused command line tool that tracks your job applications as a terminal Kanban board and tailors resumes using a local AI model.

What language is pushcv-cli written in?

Mainly Python. The stack also includes Python, Typer, Rich.

What license does pushcv-cli use?

The README does not state a license for this project.

How hard is pushcv-cli to set up?

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

Who is pushcv-cli for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.