Docs

RolePrep runs locally: the dashboard, SQLite data, generated files, and dedicated browser sessions stay on your machine.

Start here

Try it without installing globally
npx roleprep

Starts the local dashboard with the packaged command.

Install once
npm install -g roleprep
roleprep start

Useful when you want RolePrep available from any terminal.

Command reference

Run the dashboard
roleprep start
roleprep stop
roleprep restart
roleprep status

Use these for the local web app lifecycle.

Connect LinkedIn
roleprep login linkedin

Opens the dedicated local browser profile used for LinkedIn search automation.

Configure AI
roleprep api set sk-...
roleprep api status
roleprep ai provider openai
roleprep ai provider codex
roleprep ai status

OpenAI is the default. Codex mode is for local owner testing with an already logged-in CLI.

Maintenance
roleprep doctor
roleprep reset-data --yes

Check local setup health or intentionally clear local RolePrep data.

Use cases

Market research

Run focused LinkedIn searches, collect a small candidate set, and inspect what roles ask for.

Learning guides

Turn repeated skill patterns into targeted study plans and project ideas.

Interview preparation

Use extracted job keywords and generated insights to prepare for concrete role requirements.

Local-first workflow

Keep job data, browser sessions, and generated artifacts on your machine by default.

LinkedIn automation can still be detected. Use it only if you accept the account risk and keep runs low-volume.