gitwtfhub

wtf is pushcv-ui?

notnotparas/pushcv-ui — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

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

Why would anyone build with this?

REASON 1

Track job applications visually as a Kanban board in your browser.

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

PythonFastAPISQLiteHTML

How it stacks up

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 spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.