CareerRat itself costs nothing. Your AI provider may have its own plan or usage costs.
- Current Status
- Documentation
- Quick Start
- Recent Updates
- Why CareerRat
- Features
- Supported Integrations
- Star History
- Built With
- For Developers
- Community & Support
As of November 3, 2026: v0.24.0 is the latest release. CareerRat installs from npm and runs on your machine, in your terminal, with the AI CLI you already use. v0.19.2 was the last release with a Mac app.
New in v0.24.0:
- An Activity tab shows background searches as they run, and Search jobs starts one straight away.
- Generated résumés, cover letters and AI-drafted packet answers are fact-checked.
Review saved and deterministic answers yourself. One-off chat answers aren't
automatically checked. Eligible cover-letter and answer drafts may get a wording
review when it's enabled in
modes.ymland available. Deterministic answers are excluded; a failed review leaves the draft unchanged. - Honest outcome rates, fake-recruiter warnings, and your corrections saved as writing rules.
- Prebuilt terminal helpers cover supported Linux architectures. Other platforms may need native build tools.
New in v0.23.0:
careerrat startnow opens the terminal workspace.- Run it for other people with
--for <name>. Each person gets their own separate workspace. - Much better job search: more sources, related job titles, dead job boards skipped, and closed jobs detected.
- The agent never presses Submit unless CareerRat's checks pass first.
- Send a roundup to the people you run it for, once they've agreed to get one.
- Needs Node 24.22.1 or newer and Python 3.11 or newer.
Automatic submission, introduced in v0.21.0:
- CareerRat submits an application itself once it's complete and checked: every required field answered, required uploads attached, one clear submit button, and a fit gate of KEEP or a REVIEW you approved. It presses Submit once and looks for a confirmation page.
careerrat automation submit manual --writeturns that off, so CareerRat fills the form and you press Submit.- If no confirmation page shows up, the application isn't marked Applied and CareerRat never clicks again. Today asks you to check the site.
- When CareerRat stops before Submit, it says why. The job thread shows what was sent.
If you use the Mac app, it keeps working at v0.19.2. There won't be a later Mac
build; switch with npm i -g careerrat.
| Resource | Link |
|---|---|
| Website | careerrat.com |
| Docs | careerrat.com/docs |
| Changelog | CHANGELOG.md |
| Architecture | docs/ARCHITECTURE.md |
| Release process | docs/RELEASE.md |
| Windows status | docs/WINDOWS.md |
| Contributing convention | AGENTS.md |
| Security policy | .github/SECURITY.md |
| Issues | GitHub Issues |
| Discussions | GitHub Discussions |
| Real-time chat | CodesWhat Discord |
CareerRat installs from npm. It hands the actual work to an AI coding assistant you probably already have on your machine, Claude Code or OpenAI Codex, and gives that assistant a full recruiter's job to do: read the posting, check it against what you want, write your materials, and keep score of everything.
CareerRat needs one AI engine to do the actual work: Claude Code 2.1.241 or newer, or OpenAI Codex (any version). You do not need it before you install CareerRat. If neither is there, CareerRat can install Claude Code for you on first run, or point you at the Codex setup guide. CareerRat detects which one is ready on your machine and you pick it.
You need Node.js 24.22.1 or newer within 24.x, or 26.12.1 or newer, and
Python 3.11 or newer (with venv, which
some Linux systems package separately, for example python3-venv). On Debian or
Ubuntu: sudo apt install python3 python3-venv. The terminal helper ships
prebuilt for supported macOS, Linux (x64, arm64, glibc and musl) and Windows
architectures. If a prebuild is missing or cannot load, installation falls back
to node-gyp rebuild and needs native build tools.
npm i -g careerrat
careerrat startcareerrat start opens the CareerRat workspace in your terminal. The Mac app
and the browser workspace are being retired.
The Mac app ended at v0.19.2 and is no longer updated. The .dmg and the
Homebrew cask are frozen at that version, so install from npm.
CareerRat works with Claude Code
or OpenAI Codex. Install and sign
in to either one, then pick it in CareerRat. CareerRat keeps using the one
you picked. It never falls back to another tool or switches on its own. It
shows Ready once the tool is installed, signed in, and passes a quick check.
Run careerrat start in a terminal window. The first time, CareerRat sets up a
private Python environment for the workspace, which takes a minute and needs an
internet connection. It never touches your other Python packages. After that it
opens right away.
The workspace shows your saved jobs on one side and a chat with Claude Code or
Codex on the other. CareerRat uses whichever one it finds on your machine, Claude
Code first. If neither is installed, the workspace still opens and tells you so.
Claude Code needs a
paid Claude plan; Pro is enough, and Max gives more usage. You can
get Claude through Scott's referral.
To use Codex, follow its official install guide.
To pick one yourself, run careerrat start claude or careerrat start codex.
On a brand new install, the chat starts on setup by itself. Drop a PDF, DOCX, image, or text resume into the conversation, or just start talking. Paul, the CareerRat rat, learns your target roles, location rules, compensation floor, dealbreakers, evidence, and honesty boundaries, and speaks in plain English. When it needs an abstract choice, it gives concrete examples instead of job-search jargon. For example:
"What would make one job worth applying to before another? The kind of work, a schedule and pay that fit, or room to grow?"
Progress saves continuously. Once the minimum search profile is ready, CareerRat starts the first location-aware search while the rest of setup continues.
From there, ask it to find roles, evaluate a posting, tailor an application,
prepare an interview, or pick up a saved thread. Click a job to see its details,
Search jobs starts a background search directly. Review and Apply insert a
request into the chat for you to send.
Press F6 to move between the jobs and the chat, and Ctrl+Q to quit. Use
careerrat start --no-agent to browse saved jobs without starting a chat.
careerrat start needs a real terminal window. It will not run from a script or
a pipe.
careerrat start opens your saved jobs on the left and your agent on the right.
Pick a job and the details, a requirement-by-requirement fit report, its history,
and the changes you've made appear under the table. These screenshots use demo
jobs and a stand-in agent transcript.
The Fit report checks the posting against your must-haves:
Search jobs runs in the background, and the Activity tab shows its progress while you keep working:
Windows
The Windows x64 installer passed build, install, launch, export, and uninstall QA. A public Windows installer will ship only after SignPath Foundation signing is available; SignPath requires project reputation CareerRat does not yet have. See Windows status.
There is no mobile app and no Intel Mac build.
v0.24.0 highlights
- The terminal workspace has an Activity tab. Search jobs runs in the background and shows its progress there.
- Saved résumés and cover letters are fact-checked. One-off chat answers are not automatically checked.
- Honest outcome rates and fake-recruiter warnings.
- Prebuilt terminal helpers cover supported Linux architectures. Other platforms may need native build tools.
- CareerRat ships through npm only. The Mac app ended at v0.19.2.
Full history in CHANGELOG.md.
Rate. Apply. Track.
CareerRat reads the full job posting against your location and compensation floor,
fit, and dealbreakers before it recommends anything. It builds resumes, cover
letters, and screening answers from your real experience, then fills supported
application forms. When the application is complete and verified, CareerRat
submits it. Run careerrat automation submit manual --write (or ask the agent to)
and it stops for you to press Submit instead.
Pay rules work for salaried, hourly, tipped, and commissioned jobs. You can set a guaranteed base floor, a minimum for annual cash earnings that includes wages, tips, commission, and cash bonuses, or both. Equity and benefits never count as cash earnings.
The search stays together in one local workspace: conversations, jobs, recruiter threads, missions, files, follow-ups, interviews, and outcomes. You can close the terminal, come back later, and CareerRat restores the relevant state without depending on one AI vendor's session history. CareerRat owns those workflows and threads, so the execution layer stays provider-neutral.
CareerRat combines built-in public job-board and ATS sources with broad AI open-web discovery. Source setup selects the applicable built-in sources from your saved roles, then CareerRat discovers additional specialist boards and employer pages for that search.
CareerRat gives Claude Code and Codex the same complete workflow, keeps long searches and application missions durable across navigation and restart, and turns finite questions into normal clickable choices that can also be answered in text. Search combines built-in boards with AI open-web discovery, keeps AI leads clearly unverified, then checks readable full postings against location, office-day, compensation, seniority, eligibility, and fit rules before treating them as verified.
The terminal search worker skips browser-backed saved searches and does not open a login window for them. Public sources and AI open-web discovery can still run. Ask the agent to research login-gated sites separately.
Those partial discoveries are not presented as proven jobs. Search labels them AI · unverified and preserves the visible title, company, location, pay, date, link, and search evidence. Evaluate then verifies liveness, captures the full posting through the public or supervised browser path, and applies your real location, compensation, eligibility, and fit rules before any tailoring or application work begins.
- Every job is read in full before tailoring or application work begins.
- Generated claims must trace back to your own evidence. Missing facts are asked for or left out, never invented.
- Application automation fills safe, confirmed fields and can attach the generated resume. When an application needs your answer, the job thread shows that question in its review panel and saves the response against the exact form question before preparation resumes. Voluntary demographic and self-identification questions stay blank by default; in Profile > Application defaults, you can leave them blank or choose the form's decline option when one is available. CareerRat never infers an answer.
- Application questions stay with the exact job thread. CareerRat can prepare a
form through the final safe step. CAPTCHA, sensitive attestations, and
uncertainty always stop it and hand the form to you. By default (
submit: autoinautomation.yml) CareerRat presses Submit itself, once, only when every required field is answered, required uploads are attached, exactly one clearly labelled submit control exists, and the fit gate is KEEP or a REVIEW you approved. It then waits for a confirmation page. If it doesn't see one, the application is marked submitted-unverified, never retried, and you're asked to check the site. Runcareerrat automation submit manual --writeand CareerRat fills the form and stops for you to press Submit.
The terminal workspace has three working areas. The saved jobs table is on the left, with status, fit and pay, and filters for status and pay. Your Claude Code or Codex agent is on the right, so job-search actions and skill results come back to the same chat. Under the table, the Inspector has tabs for Job details, the Fit report, History, Workspace, Changes, and Activity.
Missions turn longer work into resumable, ordered steps with clear user gates. Deep ingest gets its own durable thread, and mock interviews keep their session and debrief. Changes records supported settings and evidence edits, with a preview-first Undo for each recorded change.
Searches continue in the background when you move between tabs. Activity shows their progress. If CareerRat or your computer stops mid-run, the saved run shows the interruption. Use Search jobs to retry with another search.
CareerRat stores canonical candidate state, conversations, missions, mock sessions, and pipeline records in local SQLite. Job descriptions, research, interview dossiers, resumes, and exports remain readable Markdown, PDF, or other normal files. See the chat-first runtime.
CareerRat has no product account, hosted candidate database, or app telemetry. Your workspace stays on your machine and can be exported.
Exactly what leaves your machine
- The selected AI CLI connects to its own provider under that provider's account and privacy terms.
- Search, research, and browser skills fetch the public or authenticated pages needed for the task you started.
- The Mac app (final release v0.19.2, no longer updated) checked GitHub's
latest-mac.ymlSHA-512 checksum metadata at most once a day. It sends no candidate data and no unique installation or device identifier. When a newer version exists, it downloads the signed and notarized app update. Nothing installs until you choose Restart and install. Automatic checks can be disabled in Settings, and "Check for Updates…" still works as a manual check-and-download action. Windows self-update stays off until its installed app and final installer share a complete signing chain. - The public website uses cookieless, privacy-limited aggregate analytics. The local app does not load that website analytics client.
Read the full privacy documentation, data contract, and Code signing policy.
The terminal workspace and the CLI share the same public skill definitions. You never have to know their names; Paul routes to the right one for what you ask.
Setup and intake
ingest-profile: conversational candidate setup and resume intakeresume-extract: structured facts from PDF, image, or DOCX resumesintake-extract: verbatim extraction from general dropped filesconfigure: inspect and change validated CareerRat settings
Find and research
setup-searches: turn targeting into a reviewed source configurationsearch-jobs: search configured sources, dedupe, check liveness, and triagediscover-companies: find likely employers and resolve their career boardsresearch-boards: find and validate additional job boardsresearch-company: build a cited company briefresearch-comp: benchmark compensation for a role and locationcompany-health: assess role-specific company stability and momentumrelationship-sourcing: find recruiters, hiring teams, and warm contacts
Evaluate and apply
evaluate-job: full-posting fit, compensation, location, and action gatecoach-gaps: turn review-worthy fit gaps into an honest plantailor-application: produce evidence-backed resumes and application artifactsanswer-question: answer screening questions from saved evidence and defaultsapply-job: orchestrate evaluation, artifacts, form filling, and user reviewoptimize-linkedin: propose evidence-backed LinkedIn profile improvements
Pipeline and communication
email-comms: draft and track recruiter and hiring-team messagesschedule-meeting: handle scheduling threads and availability repliescalendar-sync: write approved search events to supported calendarsingest-mail: fold recruiter and application email into the workspaceingest-messages: capture LinkedIn and Wellfound message threadssync-status: read ATS dashboards and normalize application statustrack-outcomes: record transitions, rejections, advances, and learnings
Interview, strategy, and support
interview-prep: create interview packets, practice, and debriefsreevaluate-strategy: tune the search from accumulated funnel outcomesreport-issue: diagnose CareerRat failures and prepare redacted reports
Claude Code and OpenAI Codex are CareerRat's two supported runtime choices. The AI controls use the same product language for either one. Automatic chooses by task, keeping Paul on the strongest coaching path while routine search and extraction work stays efficient. Faster, Balanced, and Best let you choose the overall quality level, while Thinking depth controls how long the selected runtime reasons. The setting never ranks Claude Code against OpenAI Codex or silently changes providers.
Aggregators: HiringCafe, LinkedIn, Indeed, Glassdoor, Wellfound, Remote Vibe Coding Jobs
ATS boards: Ashby, Greenhouse, Lever, Workable, SmartRecruiters, Recruitee, Workday
Remote boards: RemoteOK, Jobicy, Working Nomads, We Work Remotely, Remotive
Hospitality boards: OysterLink, Hcareers, Hospitality Online, iHireHospitality
Anything not covered by a built-in source is filled in by AI open-web discovery, kept clearly labeled AI · unverified until Evaluate reads the live posting. See docs/SOURCES.md for the full, current source table.
Approved interview holds, prep blocks, and deadlines write to Apple Calendar, Google Calendar, or Outlook. Recruiter email and LinkedIn or Wellfound message threads fold into the same workspace as the rest of your search.
CareerRat ships as an npm package. The careerrat CLI runs the engine and the
terminal workspace, on the same canonical skills and local data.
Needs Node.js 24.22.1 or newer within 24.x, or 26.12.1 or newer, and Python 3.11 or newer. The terminal helper uses a prebuild when one is available and compatible; otherwise installation needs native build tools.
npm i -g careerrat
careerrat startcareerrat start and careerrat tui are the same command: they open the
terminal workspace. careerrat start claude or careerrat start codex picks the
agent, and --no-agent skips it. careerrat start --browser still serves the
legacy browser workspace (with --no-open and --port) until it is removed.
Useful terminal commands:
careerrat next # show the next useful agent-led workflow
careerrat doctor # verify setup, data, skills, and runtime health
careerrat update # update an npm installation without touching user data
careerrat tracker # write a recovery snapshot and summary
careerrat tracker-dev # legacy: serve the browser workspace at localhost:7777careerrat start (also careerrat tui) opens clickable saved jobs, details, requirement reports and
history beside native agent chat. Use --agent claude or --agent codex to
choose the agent, or --no-agent to browse saved jobs. Keys: F6 switches
between jobs and agent, s starts a background search, v reviews matches, a
applies to the selected job, c adds context, F5 refreshes, F1 opens the command
palette, Ctrl+J adds a new line in the agent, and Ctrl+Q closes the workspace
and its agent. Shift+Enter also adds a new line in terminals that distinguish it
from Enter; other terminals may submit the prompt. The full tour is in
The terminal workspace.
First launch needs Python 3.11 or newer with venv support. On Windows it looks
for the py -3 launcher, then python. The native terminal dependency has
prebuilds for supported macOS, Linux and Windows architectures. A missing or
incompatible prebuild needs native build tools; careerrat doctor reports when
the helper is missing. CareerRat installs
hash-locked Textual dependencies in a private environment. careerrat tui setup
prepares it ahead of time; CAREERRAT_TUI_PYTHON selects a Python interpreter.
Your global Python packages and candidate data stay separate from that runtime.
Search jobs starts the background worker directly. Review and Apply insert a request into the agent; review it and press Enter there to run it. Add context saves pasted documents or local files before generating its request. Read saved JD opens the captured posting locally. Windows is untested end to end so far.
git clone https://github.com/CodesWhat/careerrat
cd careerrat
npm install
npm run hooks:install
npm link
careerrat start claudeThe repository convention is in AGENTS.md. Public architecture and release documentation live in docs/ARCHITECTURE.md and docs/RELEASE.md. Full setup docs are on careerrat.com/docs.
Real-time chat and early support: CodesWhat Discord
Bugs and concrete feature requests go to GitHub Issues; open-ended questions, ideas, and show-and-tell go to GitHub Discussions; real-time chat happens on the CodesWhat Discord.
Found a bug in the app itself? Say so in your CareerRat chat. It prepares redacted diagnostics (never candidate PII, comp, or workspace contents) and only opens a GitHub issue with your explicit yes.
Private vulnerability reports: Security policy.
CodesWhat, small, sharp tools from one developer and a lot of agents.


