Raven Documentation #

Raven helps you find jobs across major ATS platforms and board feeds, draft tailored applications from your profile and resume, and send outreach via Gmail or Outlook — all from a single CLI.

What Raven does #

Who this is for #

• Software engineers and builders searching across Greenhouse, Lever, Ashby, Workday, and board feeds
• Job seekers who want resume-aware drafts and ATS form guides, not generic cover letters
• Power users who prefer a scriptable, local-first workflow over browser tab sprawl

Quick links #

Getting started #

• Installation — first-time setup
• Quick start — five-minute overview
• Example dry run — full pipeline walkthrough

Core workflow #

• Architecture — how Raven is structured
• Pipeline — Discover → Draft → Send
• Discover command — job search reference
• Draft command — tailored application drafts
• Send command — email outreach

Configuration #

• portals.yml — job search filters
• profile.yml — your source of truth
• Environment variables — .env reference

Advanced #

• Job sources — ATS, boards, openjobdata
• Resume parsing — format and cache
• ATS form guides — non-email applications
• Gemini plugin — optional AI polish
• Troubleshooting — common issues

Requirements #

• Node.js 18+
• Optional: Gmail/Outlook OAuth for sending email
• Optional: GEMINI_API_KEY for AI-assisted email drafts
• Optional: HF_TOKEN for openjobdata sync (if bucket requires auth)