Skip to main content
Glama
README.md
![Job-o-Matic: a career database your AI uses to write your résumés, fast. A friendly robot types at a mid-century desk.](docs/assets/banner_hero_v1.jpg)

# A career database your AI uses to write your resumes, fast.

*The labor-saving way to keep your career facts. Now with AI.*

Load your work history once. From then on your AI keeps it up to date and pulls from it whenever you need a resume, a cover letter or an interview answer. You don't retype anything.

**Runs on your computer · No account · Works with any MCP app or chat AI · Windows, Mac, Linux**

| You | Your AI | Your AI |
|---|---|---|
| **Seed it once.** Drop in old resumes, reviews and job posts, or type the basics. Your files are kept unedited. | **Keeps it current.** Turns your files into facts, writes resume lines and saves new facts as it learns them. | **Writes from it.** Tailored resumes in five styles, cover letters and interview answers, from facts you've checked. |

![The Job-o-Matic screens: Profile, Experience with employers and positions, Items, and the For the AI page with the data map.](docs/assets/tour_v2.gif)

*The screens are for checking and fixing. Most changes come from your AI, and each one is marked **You** or **AI**. Shown with the made-up demo data that ships with the app.*

## Documentation
The [wiki](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki) explains the database and how to use it. It's written mainly for AIs; a copy lives in [`docs/wiki/`](docs/wiki) for agents working from a clone.

- **If you are an AI:** start at [Quick Start for AI](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Quick-Start-for-AI), then [Data Model](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Data-Model), [Table Reference](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Table-Reference) and [MCP Tools](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/MCP-Tools).
- **If you are a person:** [Install and First Run](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Install-and-First-Run) and [Your Data and Privacy](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Your-Data-and-Privacy).
- **If you are a developer:** [For Developers](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/For-Developers).
- **Want to help?** Open an issue, then a pull request. See [CONTRIBUTING.md](CONTRIBUTING.md).

## How your data flows
Everything lives in one file on your computer. You put facts in. Your AI reads them, saves what it finds and writes from them.

![Data flow: You seed and check the Job-o-Matic database. Your AI reads from and saves to it, then writes resumes, cover letters and interview answers. Inside: profile; employers to positions to items to resume lines; skills, education, interview Q&A; and your original files, whose facts are pulled into items.](docs/assets/data_flow_v1.svg)

Yellow is what you do; green is what your AI does. An employer can have several positions, so a promotion stays under one company. An item is one thing you did; a resume line is one way of wording it. The full picture is in [Data Model](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Data-Model).

![Create Resume: pick a style and version, preview it, or hand the job to your AI.](docs/screenshots/create_resume.png)

## Get yours
Pick the one for your computer from the [newest release](../../releases/latest):

- Windows: `Job-o-Matic_v<version>_windows-x64.zip`
- Mac with an Apple chip (M1, M2, M3...): `Job-o-Matic_v<version>_macos-arm64.zip`
- Mac with Intel: `Job-o-Matic_v<version>_macos-x64.zip`
- Linux: `Job-o-Matic_v<version>_linux-x64.zip`

## Open it
Unzip it anywhere; Python comes inside. The app isn't paid-for "signed", so your computer warns you once:

- **Windows:** Extract All, double-click `Job-o-Matic.bat`, then **More info → Run anyway**.
- **Mac:** double-click `Job-o-Matic.command`, click **Done**, then **System Settings → Privacy & Security → Open Anyway**.
- **Linux:** `chmod +x job-o-matic.sh`, then `./job-o-matic.sh`.

A browser tab opens at `http://127.0.0.1:8765/app/`. The number is 8765 (or the next free number shown) in the window that stays open. That address is your own computer. Step-by-step help: [Install and First Run](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Install-and-First-Run).

## Connect your AI
- **An MCP app** (Claude Desktop, for example) reads and saves your data directly. Quickest: `uvx job-o-matic-mcp` from PyPI, no download needed. The zip also has a one-step Claude Desktop connector; see [Install and First Run](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Install-and-First-Run#5-connect-your-ai).
- **An AI that runs commands** (Claude Code, Codex and similar): point it at `app/docs/AI_GUIDE.md` or [Quick Start for AI](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Quick-Start-for-AI).
- **Any chat AI:** click the robot button or **Create Resume**, copy the prompt, paste it into your AI, and paste its answer back.

Then ask something like: *"Read my old resume in Job-o-Matic's originals and fill in my experience."*

## Your data
Everything stays in the `my_data` folder next to the app, backed up daily. Nothing is sent anywhere. Details: [Your Data and Privacy](https://github.com/JR91387/jobomatic-reusme-skills-database/wiki/Your-Data-and-Privacy) and `PRIVACY.md`.

![A 1950s-style magazine ad: Your Career, on Autopilot! A smiling woman and a friendly robot holding a résumé.](docs/assets/ad_page1_v1.jpg)

## Licence
MIT. See `LICENSE`, and `NOTICE.md` for the third-party parts.
Copyright (c) 2026 Jerry Reinitz

Built by Jerry Reinitz at Reinitz Industries: bespoke, effective software, developed in Tulsa. https://jerryreinitz.com

---

**More from Reinitz Industries:** [Wagtail Kanban Content Calendar](https://github.com/JR91387/wagtail-kanban-content-calendar) · [Preen](https://github.com/JR91387/Preen-AI-email-sorting) · [/bully](https://github.com/JR91387/claude-skill-bully) · [/bruh](https://github.com/JR91387/claude-skill-bruh) · [Calendar Forge](https://github.com/JR91387/calendar-forge-ics)

<!-- First-run wording checked 2026-11-02:
macOS 15+ removed Control-click -> Open; use System Settings > Privacy & Security > Open Anyway (Apple developer news quoted at
  https://www.idownloadblog.com/2024/08/07/apple-macos-sequoia-gatekeeper-change-install-unsigned-apps-mac/ , 2024-08-07).
Windows SmartScreen "Windows protected your PC" > More info > Run anyway:
  https://learn.microsoft.com/en-us/answers/questions/5909311/windows-protected-your-pc-microsoft-smartscreen-bl
  https://www.techeia.com/blog/fix-smartscreen-unrecognized-app-windows-11
-->