Skip to content

feat(wellfound): add browser job adapter#1819

Open
gauravsaxena1997 wants to merge 1 commit into
jackwener:mainfrom
gauravsaxena1997:feat/wellfound-adapter
Open

feat(wellfound): add browser job adapter#1819
gauravsaxena1997 wants to merge 1 commit into
jackwener:mainfrom
gauravsaxena1997:feat/wellfound-adapter

Conversation

@gauravsaxena1997
Copy link
Copy Markdown
Contributor

Summary

This PR adds a new browser-backed wellfound adapter for OpenCLI.

Wellfound is a startup-focused recruiting platform, formerly AngelList Talent, where candidates browse startup roles, inspect company/job details, and apply either directly on Wellfound or through an external company website. It is especially useful for early-stage, remote, full-time, contract, and freelance startup opportunities, but the current OpenCLI adapter set did not have first-class support for reading or acting on Wellfound job search results.

Why this is needed

Job-search automation needs more than scraping a search page. For Wellfound, a useful adapter needs to:

  • read the logged-in Browse jobs feed and preserve stable job URLs
  • inspect detail pages/dialogs before scoring or applying
  • understand remote policy, job type, compensation, equity, skills, recruiter activity, and company status
  • distinguish Wellfound-native apply flows from jobs that require a company website application
  • keep application commands guarded so accidental submissions do not happen
  • support daily shortlist workflows for candidates who want a small set of high-fit jobs instead of raw search output

This adapter gives OpenCLI that Wellfound-specific surface area while keeping writes behind explicit --execute flags.

Commands added

  • opencli wellfound jobs
    • Reads visible jobs from the logged-in Wellfound Browse UI.
  • opencli wellfound top-picks
    • Scores Browse results into daily application targets.
  • opencli wellfound daily
    • Alias for top-picks.
  • opencli wellfound job-detail <job-url>
    • Reads one job detail page/dialog, including description, compensation, remote policy, skills, company metadata, and apply mode.
  • opencli wellfound filters
    • Reads or updates visible Browse filters. Updates require --execute.
  • opencli wellfound apply <job-url>
    • Dry-runs or submits a Wellfound-native application. Submission requires --execute and external company applications are detected but not submitted.

Safety model

  • Read commands are browser-backed and operate on the logged-in Wellfound UI.
  • Mutating filter changes require --execute.
  • Applications are dry-run by default.
  • apply supports --expected-title and --expected-company guards.
  • Company website applications return the external URL instead of submitting external forms.
  • Already-applied state is detected and reported.
  • Multiline application messages are normalized before filling the Wellfound application field.

Documentation

Added docs/adapters/browser/wellfound.md and registered Wellfound in the adapter index.

Tests

  • npm run test:adapter -- clis/wellfound/wellfound.test.js
  • npm run build-manifest

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant