Job Tracker

io.github.adamwardecki由 GitHub 帳號 adamwardecki 發布v0.4.0更新於 Nov 7, 2026

Local job-search tracker: roles, a status machine with evidence, rules, interviews, daily reports.

概覽

AI 產生的概覽

本機求職追蹤器:篩選並核實合適職缺,追蹤狀態、面試與回覆,起草申請資料並等你核准後才送出。

可以做什麼
  • 每日掃描符合硬性篩選條件的職缺,在雇主原始徵才頁面核實,並與已處理過的職缺去重
  • 以附證據的狀態機、規則、面試紀錄與看板追蹤職缺,並提供流程摘要與待辦事項
  • 準備申請:核實、撰寫、填寫表單、回讀內容,然後等待你的明確核准才嘗試送出一次
  • 起草求職信(可選輸出一頁 PDF),並依你自述的經歷準備面試
  • 把你的手動調整轉成附原因與範例的規則,並產出簡短的每日報告
適用情境
適合希望少而精地投遞、需要助理在本機維護求職流程、核實徵才資訊、準備客製化申請並每日回報的人,而不是大量海投。
執行需求
以 stdio 在本機執行;需要 Claude Code 2.1.295 或更新版本(桌面版或命令列)或 Hermes Agent,以及 Node.js 22.18 或更新版本。資料庫位於 JOB_TRACKER_HOME 指定的資料夾(預設 ~/.job-tracker)。建議設定 Gmail 與 Google Calendar 連接器、瀏覽器,以及選用的唯讀 LinkedIn MCP 伺服器。
安裝前請注意
它會填寫並可能送出求職申請,但送出需你在同一工作階段輸入核准指令並通過檢查。它透過瀏覽器讀取徵才頁面與表單,並可能使用 Gmail、Calendar 和 LinkedIn 連接器,涉及這些帳號的資料。專案仍在早期開發階段,徵才網站改版時資料來源轉接可能失效。它不會建立帳號、輸入密碼、破解驗證碼或填寫敏感個人資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Job Tracker,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Job Tracker

A Claude Code (and Hermes Agent) plugin that runs a disciplined job search for one person. Every weekday it finds roles that fit your hard filters, verifies each one on the employer's own posting, dedupes against everything you have touched, and prepares tailored applications. It submits only through the employer's official apply flow, and only after you approve. It tracks replies and interviews and writes one short daily report.

The design follows one principle: fewer, better applications.

Website: jobtrackermcp.com

Setup and usage docs: jobtrackermcp.com/docs.html

Status: early, and in active development. Expect rough edges, and expect the source adapters to break when job sites change. Issues and pull requests are welcome.

What it won't do

  • Send email or LinkedIn messages. It writes drafts only, and a hook blocks every send tool.
  • Submit an application without your /job-tracker:approve <role_id> in the same session.
  • Create accounts, enter passwords, solve visible CAPTCHAs, tick consent boxes, or fill personal-data fields (passport, nationality, age, gender, marital status, ID numbers).
  • Auto-apply at volume.

Requirements

  • Claude Code 2.1.295 or newer (the Desktop app or the CLI), or Hermes Agent.
  • Node.js 22.18 or newer. If it is missing, /job-tracker:setup offers to install it on macOS and Windows. The tracker uses the built-in node:sqlite, and Node runs the plugin's TypeScript directly. There are no runtime npm dependencies.
  • Recommended connectors: Gmail and Google Calendar.
  • Recommended browser: Claude in Chrome or the host's built-in browser.
  • Optional: a LinkedIn MCP server (read-only use: job search and inbox).

Full setup and usage instructions: jobtrackermcp.com/docs.html

Install

Claude Code:

/plugin marketplace add adamwardecki/job-tracker-mcp/plugin install job-tracker@job-tracker-mcp/job-tracker:setup

Hermes Agent:

bash
git clone https://github.com/adamwardecki/job-tracker-mcp.gitcd job-tracker-mcpplugin/scripts/hermes-install.sh

Restart Hermes and type /job-tracker:setup. Details: docs/hermes.md.

The tracker is also in the MCP Registry as io.github.adamwardecki/job-tracker, packaged as an MCPB bundle attached to each GitHub release.

Commands

CommandWhat it does
/job-tracker:setupGuided setup; resumable.
/job-tracker:sweep [--limit N]The daily run. Never submits.
/job-tracker:apply [role-id]Interactive apply: verify, write, fill, read back, then wait for your approval.
/job-tracker:approve <role-id>You type this on the filled form to allow one submit attempt.
/job-tracker:triage <source>Reconcile and clean a tracker board with the delete guard.
/job-tracker:prep <company>Interview prep from your stories.
/job-tracker:statusPipeline summary and open items.
/job-tracker:boardKanban board in your browser.
/job-tracker:cover-letter <role-id>Cover letter, optionally as a one-page PDF.
/job-tracker:correctTurn your override into a rule with a reason and example.

Your data

The tracker runs locally. A stdio server on ~/.job-tracker/tracker.db. No network listener, no token. The directory is owner-only (0700), database is 0600. Nothing is sent to the plugin's author.

Privacy policy (source).

Hooks (hard gates)

GateRule
SendEmail/LinkedIn sends blocked in every session.
SubmitNeeds /job-tracker:approve and a passing gate_check.
Board deleteNeeds a fresh JOBHUNT_TRIAGE_GUARD with ok: true.
Personal data and consentPassport, nationality, age, DOB, gender, marital, ID fields denied; consent boxes stay unticked unless you allow them.
StopA sweep session cannot end until every role has an event and the report was rendered.

Development

npm run setup   # dev only: TypeScript, the Node types and Biome, installed into dev/npm test        # tsc, then the Node and Python tests

The code is TypeScript that Node runs directly (type stripping), so there is no build step and nothing to install at runtime.

See CONTRIBUTING.md before opening a pull request.

Design choices

  1. Local only. The tracker is SQLite behind a stdio server in ~/.job-tracker.
  2. The daily run is a local scheduled task.
  3. LinkedIn is read-only and optional. Send and connect tools are blocked by a hook.
  4. Voice. write-note uses an installed humanizer or writing-style skill when present, else its own rules.
  5. Templates ship neutral. Your own values go in through setup.

License

MIT

來源:README.md,提交 72d1307

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

2
  1. v0.4.0最新Nov 7, 2026
  2. v0.3.3Oct 21, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分