First Run

First run

1. Fill in your profile

Every score and every draft is grounded in two files:

• CLAUDE.md: who you are, target roles, location, remote preference and deal-breakers (hybrid or on-site, working hours, salary floor ...).
• .claude/skills/job-application-assistant/01-candidate-profile.md: your experience, skills and achievements. Drafts may only claim what is written here.

The fastest way is the interview in Claude Code:

claude      # then type /setup

You can also edit both files by hand; the templates explain each section.

Optional extras:

File	Purpose
app/prompts/claim_bank.txt	pre-approved CV bullets the drafting agent may reuse verbatim
app/store.py → ANSWERS	your standard form answers (name, notice period, salary ...), shown under Form answers
app/data/banned_names.txt	names that must never appear in a draft (one per line, for example a confidential client)

2. Set a dashboard login

.venv/bin/python -m app set-password --username me

--generate prints a random password instead. The hash is stored in ~/.config/applydesk/config.json.

3. Health check

.venv/bin/python -m app selftest

4. Start it

.venv/bin/python -m app serve

Open http://127.0.0.1:8770 and sign in. To open it from your phone on the same Wi-Fi, add --host 0.0.0.0 and use a strong password.

5. Try one search

Click Run daily search now on Today, or limit the first run:

.venv/bin/python -m app run daily_run --max-drafts 2

Watch it on Runs. When it finishes, drafts appear on Ready.

6. Turn on the extras

• Gmail replies: Gmail Tracking
• Phone alerts: Schedules and Notifications
• Always on with HTTPS: Docker Deployment