explaingit

notnotparas/pushcv-ui

Analysis updated 2026-05-18

0HTMLAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A local web UI that turns your job applications into a Kanban board, paired with a command line tool that drafts resumes locally.

Mindmap

mindmap
  root((repo))
    What it does
      Kanban job pipeline
      Job posting scraping
      Local profile editor
    Tech stack
      Python
      FastAPI
      SQLite
    Use cases
      Track applications visually
      Draft resumes with local AI
      Keep data fully local
    Audience
      Job seekers
      Vibe coders

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 visually as a Kanban board in your browser.

USE CASE 2

Paste a job posting URL and add it to your pipeline automatically.

USE CASE 3

Edit your profile.md so AI drafted resumes stay grounded in real experience.

USE CASE 4

Run local AI resume drafting through a companion CLI without cloud calls.

What is it built with?

PythonFastAPISQLiteHTML

How does it compare?

notnotparas/pushcv-ui100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencegeneralgeneralgeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

AI drafting features need a locally running OpenAI-compatible model server.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

pushcv-ui is a local web interface that turns a companion command line tool called pushcv into a visual job application tracker. It shows your job pipeline as a four column Kanban board: Drafting, Applied, Interviewing, and Closed, matching the same job numbers the underlying CLI already uses. You can paste in a job posting URL from sites like LinkedIn, Greenhouse, Lever, or SmartRecruiters, preview it, and add it to your board. Each job has a detail panel where you can move it between statuses, add dated notes, read the full description, and open links to the original posting. The UI also includes a built-in profile editor for the profile.md file that the AI features use as the source of truth when tailoring resumes and cover letters, so drafts never invent experience you have not listed. Rather than reimplementing the AI drafting itself, the UI shows you the exact pushcv command to run in a terminal for each job, and once that command finishes, the generated draft shows up back in the job's detail panel. Everything runs entirely on your own machine. The server only listens on your local computer's address, rejects requests that try to reach it through anything other than localhost, and stores all data in the same SQLite database file the command line tool uses, so both tools stay in sync automatically. The AI drafting features rely on running a local language model through an OpenAI compatible server such as Lemonade, so no job data or resume content is sent to an outside provider. Installation is a single command using uv or pipx, which also installs the pushcv command line tool it depends on. The whole interface is one self contained HTML page with no build step and no external fonts or scripts, and it follows your system's light or dark preference automatically. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install pushcv-ui with uv and get it running in my job-hunt folder.
Prompt 2
Show me how to connect pushcv-ui to a local Lemonade AI server for drafting.
Prompt 3
Walk me through pasting a job posting URL and tracking it on the board.
Prompt 4
Explain how pushcv-ui and pushcv-cli share the same database file.

Frequently asked questions

What is pushcv-ui?

A local web UI that turns your job applications into a Kanban board, paired with a command line tool that drafts resumes locally.

What language is pushcv-ui written in?

Mainly HTML. The stack also includes Python, FastAPI, SQLite.

What license does pushcv-ui use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pushcv-ui to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pushcv-ui for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.