finch-cli 0.1.1__tar.gz

finch_cli-0.1.1/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.DS_Store
+build/
+dist/
+.venv/
+.env
+.pytest_cache/
+.ruff_cache/
+*.swp
+.DS_Store

finch_cli-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carlos Luna-Pena
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

finch_cli-0.1.1/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: finch-cli
+Version: 0.1.1
+Summary: Tailor your resume to any job posting from your terminal.
+Project-URL: Homepage, https://applyfinch.com
+Project-URL: Repository, https://github.com/applyEasy/finch-cli
+Project-URL: Issues, https://github.com/applyEasy/finch-cli/issues
+Author-email: Carlos Luna-Pena <carlunpen@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,career,cli,deepseek,internship,job-search,openai,resume,textual,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.83.0
+Requires-Dist: trafilatura>=1.12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# finch-cli
+
+a terminal client for job hunting. browse fresh internship + new-grad postings, tailor your resume to any of them, see an ats-style match score with matched + missing keywords, keep a library of the tailored versions.
+
+![jobs tab](docs/tui-jobs.svg)
+
+![tailor tab with match panel](docs/tui-tailor.svg)
+
+## install
+
+```
+pip install finch-cli
+export DEEPSEEK_API_KEY=sk-...
+finch ui
+```
+
+deepseek keys are cheap (currently around $0.27 / 1M input tokens, ~30x cheaper than claude). get one at https://platform.deepseek.com/api_keys.
+
+other providers work too. any openai-compatible chat-completions endpoint: openai, together, groq, fireworks. pass `--base-url` and the matching `--api-key`, or set `FINCH_BASE_URL` and `OPENAI_API_KEY`. the same `finch_cli/tailor.py` runs against all of them.
+
+## what it does
+
+three tabs, one keyboard.
+
+**jobs** pulls the simplifyjobs internship and new-grad lists (the same two feeds the finch backend mirrors). 3000+ active postings, filterable by query, source, term. press T on a row, the job loads into the tailor tab pre-filled.
+
+**library** is the list of tailored resumes you've saved. Markdown preview on the right.
+
+**tailor** is the three-pane editor: base resume / job posting / tailored output. claude rewrites bullets and ordering to fit the posting. won't invent skills you don't have. a match-analysis panel at the bottom shows an ats-style score, which job keywords your resume covers, which ones it doesn't, and how much the tailored version moved the needle vs the base.
+
+## install (pure cli, no tui)
+
+```
+finch tailor --resume resume.md --job https://jobs.example.com/swe-intern -o tailored.md
+```
+
+if the job site is js-heavy (workday, some greenhouse iframes), the fetch fails clean and tells you to use `--job-file` with a pasted description:
+
+```
+finch tailor -r resume.md --job-file pasted.txt -o tailored.md
+```
+
+## tui keys
+
+| key | action |
+|---|---|
+| `1` / `2` / `3` | jump to jobs / library / tailor |
+| `Ctrl+T` | tailor; on jobs tab loads the selected job first |
+| `Ctrl+U` | paste a job url, fetches it into the tailor pane |
+| `Ctrl+O` | open a resume file |
+| `Ctrl+R` | refetch the job feeds |
+| `Ctrl+L` | save the tailored output to the library |
+| `Ctrl+S` | save the tailored output to a file |
+| `Ctrl+D` | load the bundled demo |
+| `Ctrl+Q` | quit |
+
+filter inputs at the top of the jobs tab are live; type and the table updates.
+
+## cli flags
+
+`finch tailor`
+
+| flag | what |
+|---|---|
+| `-r, --resume PATH` | base resume in markdown or plain text (required) |
+| `-j, --job URL` | job posting url |
+| `--job-file PATH` | local file with the job description (use if `--job` won't extract) |
+| `-o, --out PATH` | save tailored resume here, else stdout |
+| `--model NAME` | model name (default `deepseek-chat`) |
+| `--api-key KEY` | override `$DEEPSEEK_API_KEY` / `$FINCH_API_KEY` / `$OPENAI_API_KEY` |
+| `--base-url URL` | override openai-compatible base url (default `https://api.deepseek.com`) |
+
+`finch ui`
+
+| flag | what |
+|---|---|
+| `--demo` | preload the bundled example into the tailor tab |
+| `--model NAME` | model name |
+
+## where stuff lives
+
+| | path |
+|---|---|
+| job feed cache (~6h ttl) | `~/.cache/finch-cli/{intern,newgrad}.json` |
+| saved tailored resumes | `~/.local/share/finch-cli/resumes/` |
+| bundled example resume + job | `examples/` in the repo |
+
+## why a cli
+
+most of these tools are saas you have to sign up for. this is the opposite. install, run, the only thing leaving your machine is the llm call you control.
+
+the autofill side - the part that actually fills out the application form - lives in the web app at applyfinch.com, free during beta.
+
+## known limits
+
+- workday and some greenhouse iframe pages need js. the fetch fails clean and tells you to use `--job-file`.
+- tailored output is markdown. pipe to pandoc for pdf, or paste into overleaf if you have a tex template.
+- the model won't invent skills. if the base resume is thin, the tailored version is thin. fix the base first.
+
+## roadmap
+
+- a built-in pdf renderer (drop the pandoc step)
+- `finch apply` to autofill the application after tailoring, same engine as the web app
+- optional sign-in to view your real applyfinch.com pipeline from the terminal
+
+## license
+
+mit.

finch_cli-0.1.1/README.md

@@ -0,0 +1,108 @@
+# finch-cli
+
+a terminal client for job hunting. browse fresh internship + new-grad postings, tailor your resume to any of them, see an ats-style match score with matched + missing keywords, keep a library of the tailored versions.
+
+![jobs tab](docs/tui-jobs.svg)
+
+![tailor tab with match panel](docs/tui-tailor.svg)
+
+## install
+
+```
+pip install finch-cli
+export DEEPSEEK_API_KEY=sk-...
+finch ui
+```
+
+deepseek keys are cheap (currently around $0.27 / 1M input tokens, ~30x cheaper than claude). get one at https://platform.deepseek.com/api_keys.
+
+other providers work too. any openai-compatible chat-completions endpoint: openai, together, groq, fireworks. pass `--base-url` and the matching `--api-key`, or set `FINCH_BASE_URL` and `OPENAI_API_KEY`. the same `finch_cli/tailor.py` runs against all of them.
+
+## what it does
+
+three tabs, one keyboard.
+
+**jobs** pulls the simplifyjobs internship and new-grad lists (the same two feeds the finch backend mirrors). 3000+ active postings, filterable by query, source, term. press T on a row, the job loads into the tailor tab pre-filled.
+
+**library** is the list of tailored resumes you've saved. Markdown preview on the right.
+
+**tailor** is the three-pane editor: base resume / job posting / tailored output. claude rewrites bullets and ordering to fit the posting. won't invent skills you don't have. a match-analysis panel at the bottom shows an ats-style score, which job keywords your resume covers, which ones it doesn't, and how much the tailored version moved the needle vs the base.
+
+## install (pure cli, no tui)
+
+```
+finch tailor --resume resume.md --job https://jobs.example.com/swe-intern -o tailored.md
+```
+
+if the job site is js-heavy (workday, some greenhouse iframes), the fetch fails clean and tells you to use `--job-file` with a pasted description:
+
+```
+finch tailor -r resume.md --job-file pasted.txt -o tailored.md
+```
+
+## tui keys
+
+| key | action |
+|---|---|
+| `1` / `2` / `3` | jump to jobs / library / tailor |
+| `Ctrl+T` | tailor; on jobs tab loads the selected job first |
+| `Ctrl+U` | paste a job url, fetches it into the tailor pane |
+| `Ctrl+O` | open a resume file |
+| `Ctrl+R` | refetch the job feeds |
+| `Ctrl+L` | save the tailored output to the library |
+| `Ctrl+S` | save the tailored output to a file |
+| `Ctrl+D` | load the bundled demo |
+| `Ctrl+Q` | quit |
+
+filter inputs at the top of the jobs tab are live; type and the table updates.
+
+## cli flags
+
+`finch tailor`
+
+| flag | what |
+|---|---|
+| `-r, --resume PATH` | base resume in markdown or plain text (required) |
+| `-j, --job URL` | job posting url |
+| `--job-file PATH` | local file with the job description (use if `--job` won't extract) |
+| `-o, --out PATH` | save tailored resume here, else stdout |
+| `--model NAME` | model name (default `deepseek-chat`) |
+| `--api-key KEY` | override `$DEEPSEEK_API_KEY` / `$FINCH_API_KEY` / `$OPENAI_API_KEY` |
+| `--base-url URL` | override openai-compatible base url (default `https://api.deepseek.com`) |
+
+`finch ui`
+
+| flag | what |
+|---|---|
+| `--demo` | preload the bundled example into the tailor tab |
+| `--model NAME` | model name |
+
+## where stuff lives
+
+| | path |
+|---|---|
+| job feed cache (~6h ttl) | `~/.cache/finch-cli/{intern,newgrad}.json` |
+| saved tailored resumes | `~/.local/share/finch-cli/resumes/` |
+| bundled example resume + job | `examples/` in the repo |
+
+## why a cli
+
+most of these tools are saas you have to sign up for. this is the opposite. install, run, the only thing leaving your machine is the llm call you control.
+
+the autofill side - the part that actually fills out the application form - lives in the web app at applyfinch.com, free during beta.
+
+## known limits
+
+- workday and some greenhouse iframe pages need js. the fetch fails clean and tells you to use `--job-file`.
+- tailored output is markdown. pipe to pandoc for pdf, or paste into overleaf if you have a tex template.
+- the model won't invent skills. if the base resume is thin, the tailored version is thin. fix the base first.
+
+## roadmap
+
+- a built-in pdf renderer (drop the pandoc step)
+- `finch apply` to autofill the application after tailoring, same engine as the web app
+- optional sign-in to view your real applyfinch.com pipeline from the terminal
+
+## license
+
+mit.

finch_cli-0.1.1/REDDIT_POST.md

@@ -0,0 +1,100 @@
+# reddit launch drafts
+
+pick a title, paste a body, post. space the cross-posts at least 24h apart.
+
+## titles
+
+1. i built a tui that tailors your resume to a job posting in 30 seconds
+2. pip install finch-cli, a cli + tui for resume tailoring
+3. tired of editing the same resume 80 times a recruiting cycle so i built a cli
+4. show hn: finch-cli, resume tailoring from the terminal (cli + textual tui)
+
+## body for r/csmajors, r/cscareerquestions, r/internships
+
+```
+i'm a cs senior at tamu. my co-founder pepe and i are building applyfinch.com, an ai tool that tailors your resume per job posting and autofills the application form. the tailoring is the part you actually feel improving, so i packaged it as a small open source cli with a textual tui on top.
+
+how it works:
+
+    pip install finch-cli
+    export DEEPSEEK_API_KEY=sk-...
+
+cli:
+
+    finch tailor --resume resume.md --job https://jobs.netflix.com/positions/14234 -o tailored.md
+
+tui:
+
+    finch ui --demo
+
+three panes, base resume on the left, the job in the middle, the tailored output on the right. ctrl+t to tailor, ctrl+u to paste a url, ctrl+s to save. screenshot is in the repo readme.
+
+you give it your resume in markdown and a job description. it rewrites the resume so the bullets and wording line up with the posting. it won't invent experience or skills, only reorders and rewords what you already have. the prompt enforces that.
+
+why a cli, because most of these are saas tools you have to sign up for. this is the opposite. install, run, done. only thing leaving your box is the llm call you control.
+
+repo: https://github.com/applyEasy/finch-cli (mit)
+
+the autofill side is at applyfinch.com if you want that part too, free during beta.
+
+feedback / prs welcome. roadmap is `finch jobs` (pull fresh internships from our bank, ~3,200 active) and `finch apply` (autofill, same engine as the web app).
+```
+
+## body for r/Python
+
+```
+small tool i shipped this weekend. tailors a resume in markdown to a job posting url via the anthropic api. cli mode and a textual tui in the same package.
+
+stack: click for the cli, textual for the tui, httpx, trafilatura for html to text, anthropic sdk, rich. about 450 loc total. hatchling for the build.
+
+    pip install finch-cli
+    export DEEPSEEK_API_KEY=...
+    finch tailor --resume resume.md --job <url> -o tailored.md
+    finch ui --demo
+
+repo with the prompt at github.com/applyEasy/finch-cli (mit). svg screenshot of the tui in the readme.
+
+two things i'd actually want feedback on:
+
+- the system prompt is the whole product. anyone got patterns for keeping the llm from inflating bullet wording past what the base resume actually supports? i've got a hard no-invent rule but it still occasionally rephrases "shipped a pipeline" into "architected a production-grade pipeline". curious how other people handle that.
+- using trafilatura for html to text. works on lever and greenhouse static pages, fails on workday js renders. i was avoiding bundling chromium for a 200mb playwright install on a resume tool. anyone got a lighter trick.
+
+companion web app at applyfinch.com if you want the autofill side.
+```
+
+## body for show hn
+
+```
+Show HN: finch-cli, resume tailoring from the terminal (cli + textual tui)
+
+i built a small cli that takes your resume in markdown and a job url, calls claude to rewrite the resume so bullets and wording match the posting, writes markdown out. then added a textual tui on top, three panes (resume / job / tailored output).
+
+the relevant thing is the prompt. hard rule: never invent experience, employers, dates, or numbers. soft guidelines: reorder bullets so the most relevant come first, rewrite wording to use the posting's terminology where it truthfully applies.
+
+    pip install finch-cli
+    export DEEPSEEK_API_KEY=...
+    finch tailor --resume resume.md --job <url> -o tailored.md
+    finch ui --demo
+
+repo: https://github.com/applyEasy/finch-cli (mit)
+
+this is the tailoring half of an ai resume tool i'm building with a co-founder at applyfinch.com. the web app also autofills the application form, which the cli doesn't do yet. wanted the prompt and the plumbing in open source so people can sanity-check the approach and run it locally.
+
+known limits, in the readme: workday job pages need js to render and won't extract, so the cli tells you to paste the description into a file and use --job-file. output is markdown, pipe through pandoc for pdf.
+```
+
+## posting order
+
+1. r/csmajors first - tamu and adjacent students, biggest concentrated audience
+2. r/cscareerquestions, broader and slower
+3. r/internships (293k, lower noise than r/jobs)
+4. r/Python with the tui angle and the svg screenshot. probably the strongest single post.
+5. show hn, sat or sun morning pacific
+6. twitter/x with a 20s screen recording
+7. your personal linkedin separately, pepe's for the recruiter side later
+
+## still to do
+
+- publish to pypi. until then `pip install git+https://github.com/applyEasy/finch-cli.git` works
+- record a ~20s screen recording of `finch ui --demo`, ctrl+t, save. drop it above the svg in the readme. screenshot is good, recording is the share asset
+- the default model is `deepseek-chat` (cheap, matches the actual finch web app's tailoring model). users can override with `--model` and `--base-url` for any openai-compatible provider