Reference
CLI Commands
Every public Rolester CLI command plus maintainer-only npm scripts.
The primary entry point. Run as rolester <command> [args] [--flags].
| Command | What it does |
|---|
start [agent] | Scaffold workspace, install skills, boot dashboard, launch agent |
start claude | Same, with Claude Code as the agent |
start codex | Same, with Codex as the agent |
init | Scaffold workspace only (no agent, no dashboard) |
doctor | Environment health check, scaffold state, skills discoverability |
next | Show the next agent task from doctor guidance |
ingest | Guided candidate setup (profile, targeting, evidence, etc.) |
searches | Build and curate the search-source config |
companies | Manage tracked employer ATS boards |
evaluate | Run the body-read gate on a saved job |
tracker | One-shot dashboard snapshot, summary, follow-ups, or --verify |
tracker-dev | Live-reloading dashboard server on :7777 |
modes | Show or change optional usage and application modes |
automation | Show or toggle opt-in browser-automation config |
activity | Read, append, or prune Activity Pulse events |
research | Read or record web-research artifacts |
stories | Read, validate, or add STAR+R interview stories |
strategy-review | Stamp a strategy-review run |
analytics | Compute tracker analytics |
evidence | Read, validate, or add evidence claims |
gate | Safely update gate data such as comp floors and exclusions |
learnings | Read or append per-role-family learnings |
status-map | Inspect ATS status normalization |
export | Render a tailored artifact or packet to PDF or DOCX |
update | Pull latest code from npm; data untouched |
restore | Recover tracker.json from a rolling snapshot (confirm-first) |
install-skills | Re-shim .claude/skills to .agents/skills |
--version | Print installed version |
| Flag | Effect |
|---|
--no-agent | Scaffold + dashboard only |
--no-dashboard | Agent only, no dashboard server |
--agent <name> | Override agent CLI (any CLI on PATH) |
--port <n> | Dashboard port (default 7777) |
Most users should use rolester <command>. These npm scripts are useful when
developing from a source checkout or running lower-level maintenance tools.
| Script | What it does |
|---|
lint | Run Biome checks |
lint:fix | Run Biome with safe fixes |
format | Format files with Biome |
test | Run the Node test suite |
web:dev | Run the marketing/docs website locally |
web:build | Build the marketing/docs website |
build:demo | Build demo assets |
deploy:demo | Deploy demo assets |
| Script | What it does |
|---|
verify:tracker | Validate workspace/tracker.json schema and integrity |
lint:placeholders | Check tailored artifacts for unresolved placeholders |
| Script | What it does |
|---|
capture:search-sources | Bulk-capture board listing pages |
capture:board | Capture a single board page |
analyze-outcomes | Read outcome analytics from tracker |
check-job-links | Check liveness of sourced job links |
scan:sourced | Scan configured sourced rows |
delta:sourced | Show sourced-row deltas |
calibrate:style | Build writing-style calibration artifacts |
| Variable | Default | Purpose |
|---|
ROLESTER_HOME | <repo root> | Override location of candidate/ and workspace/ |
NEXT_PUBLIC_SITE_URL | (unset) | Docs-site base URL for metadata |