Getting Started
What CareerLens does, how to use it, and where your data actually goes.
What CareerLens Does
CareerLens is a local-first job-market intelligence application. You collect job postings yourself — by pasting a link or the description of a job you're looking at — and CareerLens extracts an editable draft, normalizes it once you save, and lets you organize, analyze, and search across everything you've gathered.
Extraction is deterministic, not AI — it only fills in what it can find with confidence, and always leaves the rest for you to fill in. Nothing is ever guessed.
Your data stays in this browser unless you explicitly export it. There is no account and no server — CareerLens never sends your data anywhere on its own.
Recommended Workflow
- Start empty, load Demo Workspace, or restore a CareerLens backup.
- Add a job — paste a link or the job description you're looking at.
- Review and correct the extracted draft.
- Save the job.
- Organize jobs into collections (optional — Search and the Dashboard already group everything automatically).
- Search and filter the workspace.
- Review analytics on the Dashboard.
- Export a JSON backup or Excel report.
Add Job
Paste the job description you're looking at, or paste its URL. CareerLens never fetches a page for you — pasting a link is preserved as a reference and always falls back to asking for the description. Either way, you get an editable draft: review and correct every field before saving. Nothing is written to your workspace until you click Save job. Pasting a new link or description replaces whatever was auto-extracted before, but never overwrites a field you've already edited yourself.
Prefer to paste structured JSON directly? The Advanced tab has the original select-a-source, paste-JSON workflow, unchanged — useful for developers, testing, or a source with a known exact shape. See the examples further down this page.
Managing a Saved Job
Saving a job is the start, not the end. Open any job's detail view to set a pipeline stage (Saved through Accepted/Rejected/Withdrawn/Expired/Archived — you can move to any stage at any time, in either direction) and mark a priority (High/Medium/Low). The rest is organized into tabs: Events, Contacts, Notes, and Timeline.
The Events tab tracks interview events — recruiter screens, technical interviews, take-home deadlines, and more — each with a date and time shown in your own timezone, a status (scheduled, completed, cancelled, or rescheduled), and an optional location or meeting link. The Contacts tab tracks the people involved (recruiters, hiring managers, interviewers), with just a name required. Notes hold opportunity-wide information (interview prep, recruiter feedback, salary discussions). A timeline records what changed and when, automatically — there's no separate "add a timeline entry" step; every pipeline change, priority change, note, and interview-event schedule/reschedule/completion/ cancellation is already logged for you.
Collections
Collections are lists you curate by hand — for example "Australian Frontend", "Remote React", "Senior Roles", or "Shortlist". A job can belong to any number of collections, or none. Search and the Dashboard already group everything automatically by source, location, skill, experience, employment type, pipeline stage, and priority — make a Collection for a grouping that isn't one of those (e.g. "referred by a friend").
Deleting a collection only removes the collection itself and clears it from every job that was in it — the jobs themselves are never deleted.
Search
Free text searches titles, companies, locations, skills, requirements, tags, source names, interview event titles, and contact names/companies/roles — every word you type must appear somewhere for a job to match. Structured filters (source, collection, skills, experience, employment type, remote type, country, tags, pipeline stage, priority, notes, interview event type, and salary availability) narrow the results further, plus a toggle for jobs with an upcoming or scheduled interview: selecting more than one value within the same filter (e.g. Senior and Lead) matches either one, while selecting values in different filters (e.g. Senior experience and Remote) requires both. Results can be sorted by newest posted, newest or oldest collected, or alphabetically by title or company. Click any result for its full detail, including links to the original posting or application if available.
Dashboard
The Dashboard summarizes the normalized jobs and collections currently stored in this browser. Unknown values (an experience level or location that couldn't be determined) are always shown, never hidden. Salary coverage shows how many jobs disclose a salary and in which currencies and periods — it never averages salaries across different currencies or pay periods. Pipeline stages are shown as a distribution too, alongside jobs currently in an interview stage, high-priority jobs, recently updated jobs, and your next upcoming interview, upcoming interviews, interviews this week, and any overdue take-home deadlines. Every number updates automatically as you import, organize, or remove jobs; no reload is needed.
Local-First Storage
- Jobs, collections, and skills are stored in this browser's IndexedDB.
- A few preferences (like theme) are stored in this browser's local storage.
- Nothing syncs automatically across devices or browsers.
- Clearing your browser's storage for this site removes your data.
- A native JSON export (Settings → Export data) is the recommended way to back up and recover your data — it's the only format designed to restore everything exactly.
Advanced: Structured JSON Examples
Add Job's Paste Description and Paste Link tabs work for any source — you don't need to know a JSON shape for those. The examples below are for the Advanced tab only, which only the sources below have a real, working normalizer for today. Every other source listed there is a planned source that isn't usable for a real import yet — it will report that clearly if you try.
Export and Backup
CareerLens JSON export/import is the native backup format — it captures your entire workspace (or one collection) exactly, and can fully restore it later, in this browser or another one. Excel export is a separate, one-way report meant for analysis or sharing outside CareerLens — it isn't meant to be re-imported. Use JSON for backups; use Excel for reporting.