pip install applyr && applyr init && applyr setup-agent

[!NOTE] Requires Python 3.11+ and an AI coding agent (Claude Code, Cursor, OpenCode, or any agent that reads instruction files).

How it works

You: paste a job offer into your AI agent

         |
         v

Agent: reads cv-master.md + evaluates 6 topics
       runs  applyr add '<json>'

         |
         v

applyr:  74% compatibility (>= 65% threshold)
         >> RECOMMENDATION: APPLY
         Skill gaps: English, Experience

         |  (you confirm)
         v

Agent: generates tailored CV from cv-master.md
       runs recruiter review (ATS score: 87/100)
       delivers PDF ready to send

applyr is the storage layer. Your AI agent is the brain.

Features

• Three-state recommendation — APPLY (>=80%), MAYBE (60-79%), LOW MATCH (<60%) with configurable thresholds
• Skill-level breakdown — Strong/Partial/Missing per topic with icons (✓/△/✕)
• "Why you match" — Executive summary of strengths and weaknesses
• Weighted scoring — 6 configurable topics (tech stack 30%, projects 20%, experience 15%, education 15%, english 10%, cultural fit 10%)
• Score breakdown — Weighted contribution per topic so you understand why 78%
• CV tailoring hints — What to emphasize, what to de-emphasize in your CV
• Duplicate detection — same company+title? applyr catches it before you waste time
• ATS-safe CVs — locked single-column CSS, standard fonts, no images. Your agent fills content, never touches structure
• Recruiter review — built-in prompt scores your CV 0-100 with specific improvements
• 21 commands — pipeline, stats, gaps, trends, salary insights, follow-ups, compare, export, and more
• Local and private — SQLite on your machine. No API keys, no subscriptions, nothing leaves your system
• Agent-native — ships with AGENT_INSTRUCTIONS.md that tells Claude/Cursor/OpenCode exactly what to do

Quick start

1. Install and initialize

pip install applyr
applyr init

This creates ~/.applyr/ with config, database, CV template, and agent instructions.

2. Fill your profile

Edit ~/.applyr/cv-master.md with your complete professional profile. This is the only source of truth — the agent reads it to score offers and write CVs.

3. Connect your agent

applyr setup-agent                       # Auto-detects Claude/Cursor/OpenCode
applyr setup-agent --agent claude        # Or specify: claude | cursor | opencode | generic

Done. Paste a job offer into your agent and say "analyze this".

What your agent sees

You:   "Analyze this AI Engineer posting at Acme Corp"

Agent: Checks duplicates → none found
       Scores: tech_stack 85%, experience 40%, projects 90%...
       applyr add '<json>'
       → "74% match. APPLY recommended. Generate CV?"

You:   "Yes"

Agent: applyr cv generate 1 → fills from cv-master.md
       applyr cv review → ATS score: 87/100, READY TO SEND
       applyr cv pdf → delivers PDF

You:   "Analyze this Data Analyst role at SmallCo"

Agent: applyr add '<json>'
       → "42% match. SKIP recommended. Gaps: no R/Tableau, 0 data roles."

You:   "What should I learn?"

Agent: applyr gaps → "Experience: seen in 15 offers, avg gap 20%"

Commands

Tracking

applyr add '<json>'                # Register offer (agent builds the JSON)
applyr list [--status S]           # All offers or filtered
applyr show <id>                   # Full detail + topic scores
applyr pipeline                    # Grouped by status
applyr update <id> <status>        # Change status, add notes
applyr delete <id>                 # Remove an offer
applyr search <keyword>            # Search by company/title/tech

Analytics

applyr stats                       # Conversion funnel + metrics
applyr gaps                        # Skills to improve (by frequency)
applyr trends                      # Applications per week
applyr summary --json              # Weekly summary for LLM
applyr compare 1 3 4               # Side-by-side offers
applyr plan                        # Learning priorities
applyr salary [--seniority mid]    # Salary insights
applyr followups                   # Overdue + upcoming

CV pipeline

applyr cv generate <id>            # Markdown CV with YAML frontmatter
applyr cv review <file.md>         # Recruiter review prompt (accepts .md or .html)
applyr cv pdf <file.md>            # Markdown → ATS-HTML → PDF via Chrome

System

applyr doctor                      # Health check
applyr export --format json        # Export everything
applyr version                     # Show version

Scoring

Each topic is scored 0-100 by the AI agent, then weighted:

Formula: sum(score * weight) / sum(weights) — configurable in ~/.applyr/applyr.toml.

Threshold: score >= 65% → APPLY. Below → SKIP. Configurable.

Status flow

pending ──> applied ──> waiting ──> in_process ──> offer
               |            |           |
               v            v           v
           discarded    rejected    rejected

Configuration

# ~/.applyr/applyr.toml

[general]
threshold = 65          # Min % to recommend applying
followup_days = 10      # Days before follow-up reminder

[weights]               # Auto-normalized, no need to sum to 1.0
tech_stack = 30
education = 15
experience = 15
projects = 20
english = 10
cultural_fit = 10

Project structure

applyr/
  cli.py                 # Entry point
  config.py              # TOML config
  db.py                  # SQLite schema (offers: 31 columns)
  scoring.py             # Weighted scoring engine
  cv.py                  # Markdown CV + Chrome PDF + recruiter review
  md_render.py           # Narrow markdown → ATS-HTML converter
  commands/
    core.py              # add, list, show, update, delete, search, init, setup-agent
    analytics.py         # stats, gaps, trends, pipeline, compare, plan, salary
    workflow.py          # export, doctor
  templates/
    AGENT_INSTRUCTIONS.md
tests/
  test_cli_routing.py    # 115 tests, cli router coverage
  test_cv.py             # CV pipeline tests
  test_md_render.py      # Markdown renderer tests
  test_db.py             # Schema + migration tests
  test_scoring.py        # Scoring engine tests
  test_config.py         # Config loading tests
  test_validators.py     # Input validation tests
  ...

Development

git clone https://github.com/DeibyGS/applyr.git
cd applyr
pip install -e ".[dev]"
pytest                             # 296 tests, ~3s

Built with AI

applyr was designed to work for AI agents — it made sense to build it with one, as a pair programming partner.

Process: Spec (SDD) → AI implementation → Human review → Test → Merge

License

MIT — use it, fork it, improve it.