Help

Everything you need to get the most out of RoleScout

Getting Started

Start with Profile & Skills — upload your resume, extract your skills, generate your scout config, scout for open roles, and review your ranked matches in Discover Roles.

The 3-step flow

1. Upload your resume Go to Profile & Skills and upload your PDF. RoleScout parses your resume and automatically generates target companies and role filters tailored to your background.

2. Scout for open roles Go to Scout and hit Start Scouting. Scout checks your target companies job boards and returns ranked matches in 1-2 minutes.

3. Review your matches Go to Discover Roles. Filter by remote/hybrid/onsite, search by keyword, save roles you like, pass on the rest.

Profile & Skills

Upload your resume PDF — parsing and config generation happen automatically in one flow, no second button click needed.

Steps

  • Parsing resume — extracts your name, contact info, skills, experience, and education
  • Generating target companies & role filters — builds a list of 30-50 target companies and role filters tailored to your background
  • Done — review and edit your candidate profile below

After generation, your candidate_profile.json is saved locally in your browser. You can edit it directly in the textarea and save.

Scout Config Prompt

The Scout Config Prompt section shows the prompt used to generate your target companies and role filters. Read-only for now — prompt editing coming in a future update.

Free tier

3 resume parses + 3 config generations per day per IP address. Add your Anthropic API key in Settings for unlimited runs.

Scout

Scout checks your target companies job boards for open roles matching your profile.

Last Run stats

  • Target Companies — how many companies were successfully scouted out of your total target list
  • Roles After Filters — roles that matched your title and pattern filters
  • Last Run — date and time of your most recent scout run
  • By ATS — breakdown of roles by the applicant tracking system they were sourced from (Greenhouse, Lever, Ashby)

Start Scouting

Hit Start Scouting to run a fresh scout. Progress streams live in the terminal window — one line per company as it completes. Results save automatically to your browser when the run finishes.

Each run replaces the previous results.

Target Companies & Role Filters

The tables below the terminal show what is in your candidate profile. Edit in Profile & Skills, download from Settings.

Discover Roles

Discover Roles shows all open roles from your last scout run, ranked by match score.

Match scoring

Roles are scored 0-100 based on:

  • Title match: +35 (guaranteed by admission filter)
  • Seniority match: +25
  • Domain match: +5 per match, max 25
  • Skill match: +1 per match, max 15
  • Blank description: unscored (not penalized)

Curated sections

  • Best Match — top roles sorted by match score
  • Top Paying — roles sorted by compensation
  • New This Week — roles posted in the last 7 days

Filters & search

  • Filter pills: All, New This Week, Remote, Hybrid, Onsite
  • Search: type keywords to filter results
  • Prefix with - to exclude (e.g. -manager)
  • Separate multiple terms with commas

Saving roles

Hit the checkmark to save a role, X to pass. Download your saved roles as a CSV using the Download Saved button.

On mobile

Scroll through All Roles below the curated sections. Tap Load more to reveal additional results 6 at a time.

Applications

Applications tracks your job search pipeline from saved roles through to offer.

Pipeline stages

Saved → Applied → Recruiter Screen → Hiring Manager → Interview Loop → Final Round → Offer

Exit states

Rejected, Declined, Ghosted, No Response, Withdrawn, Accepted

Sankey diagram

Visual flow of your applications by source and stage, with exit states branching right.

Table

Filterable table of all applications. Overdue Next Action dates shown in amber. Click View to open the job posting.

Data

Upload your tracking CSV or use demo data to explore. Your data stays in your browser.

Settings

Settings is your data management hub for RoleScout.

API Key

Add your Anthropic API key to bypass the free tier rate limits entirely. Your key is saved locally in your browser and never sent to RoleScout servers — only to Anthropic's API directly.

Supported providers: Anthropic, OpenAI, Gemini.

Data & Storage

All RoleScout data lives in your browser (IndexedDB). No account required, no server storage.

Data rows (in order):

  • Candidate Profile — your parsed resume and scout config
  • Open Roles CSV — latest scout run results
  • Applications Tracking CSV — your job search history
  • Last Run Summary — Scout run metadata and stats
  • Target Companies — company list for Scout
  • Role Filters — title, seniority, and domain filters

Each row has Upload, Download, Sample, and Clear actions. Load demo data to explore the full app without uploading your own resume.

FAQ

Does RoleScout apply to jobs for me?

No. RoleScout scouts — it finds and ranks roles that match your profile. You review, save, and apply yourself. Auto-apply tools optimize for volume; RoleScout optimizes for signal. You stay in the loop.

Do you store my resume or job data?

No. All data is stored locally in your browser using IndexedDB. Your resume is sent to Anthropic's API for parsing but is not stored by RoleScout.

What companies does Scout support?

Greenhouse, Lever, and Ashby ATS platforms. Most modern tech companies use one of these. Google and Meta are not currently supported (JS-rendered job boards).

How does match scoring work?

Roles are scored based on four signals: title match (+35), seniority match (+25), domain keywords in the description (+5 each, max 25), and skill keywords (+1 each, max 15). The effective range is 35-100 for scored roles. Roles with blank descriptions are left unscored, not excluded.

How many free runs do I get?

3 resume parses and 3 config generations per day per IP address. Scout runs are not currently rate-limited — we are doing our best to keep it this way. Add your own Anthropic API key in Settings to bypass the parse and config limits entirely.

What is the Scout Config Prompt?

The prompt sent to the LLM to generate your target companies and role filters from your resume. Currently read-only. Editable prompt support is planned for a future update.

Is my API key safe?

Yes. Your API key is stored only in your browser's localStorage and is sent directly to the provider's API. RoleScout never logs or stores your key.

Changelog

v0.1 Beta — May 6, 2026

First public beta release.

  • Full pipeline live end to end: resume → profile → config → Scout → results
  • Bundled resume upload — parse and generate config in one step, no second button click
  • Railway-hosted Scout backend with live SSE progress streaming
  • Mobile load-more for Discover Roles (All Roles section, 6 at a time)
  • iPad table overflow fix (pointer-based detection)
  • Scout language refresh — Scout Target Companies, Start Scouting, Scout Again
  • Settings grouped layout with download buttons for all data files
  • Dismissible beta banner
  • Welcome back personalization on Dashboard
  • Timezone-aware run timestamps (user local time)
  • Demo data available without account or API key