Rolester
Getting Started

Your First Job

A 5-minute path to confirm the whole loop is working.

Once rolester start is up and your agent is live, use it the way a real candidate would. Here is the fastest path to confirm the full stack — CLI, skills, agent reasoning, and the live dashboard — is working end to end.

The 5-step test loop

1. Let it onboard you

The agent builds your profile by asking a few questions. To test without using real details:

set me up with a quick sample profile so I can test the flow

2. Paste a job posting and ask it to evaluate

Copy a job description from anywhere (a posting URL, raw JD text, or the bundled sample at examples/sample-jobs/) and paste it into the agent chat. Say:

evaluate this

You should get a structured verdict:

GATE: KEEP — strong overlap with role targets
FIT: high 88 — ...
COMP: clear — posted range covers target_base
ACTION: apply-now

This is a real read of the posting body against your config — not a keyword match. If the posting is a poor fit you will get GATE: CUT with a reason.

3. Ask it to tailor

write a resume and cover letter for this

The agent builds honest artifacts from your evidence bank. It will not invent facts. If you used the sample profile from step 1, the output will be illustrative rather than personalized.

4. Paste a recruiter email

Copy any recruiter message (even a generic one) and paste it. Say:

draft a reply

The agent routes to the email-comms skill, drafts a reply in your writing style, and tracks the thread.

5. Check the dashboard

Open http://localhost:7777 and watch the application appear, move through the funnel, and accumulate activity. The dashboard is read-only — the agent is the writer; the dashboard just shows the state.

If all five land, Rolester is working end to end.

Using the bundled sample

The repo ships a fictional sample candidate ("Riley Chen") and sample job in examples/:

examples/
  sample-candidate/   ← illustrative candidate config files
  sample-jobs/        ← a sample JD to evaluate
  demo-workspace/     ← a pre-seeded tracker for demos

You can point the agent at the sample JD directly:

evaluate the job in examples/sample-jobs/

Let the agent run the test itself

If you prefer to hand it off entirely, open your agent in the repo root and say:

read the README and AGENTS.md, set yourself up, and walk me through testing Rolester end to end

The agent will self-direct through the full loop.

Expected pre-setup behavior

Until ingest-profile has run, rolester doctor reports that local candidate setup is incomplete and lists the candidate/*.yml files to create. That is the expected pre-setup state — the agent fills them in during onboarding. It is not an error.

On this page