CLI Commands

CLI commands

All commands run from the repo root with the project's virtualenv: .venv/bin/python -m app <command>.

Command	What it does
serve	Dashboard, scheduler and task runner on http://127.0.0.1:8770
serve --host 0.0.0.0	Reachable from your phone on the same Wi-Fi (use a strong password)
serve --port 9000	Another port
serve --tls	HTTPS with ~/.config/applydesk-tls/server.{crt,key}
run daily_run	One daily search in the foreground, with the live log
run daily_run --max-drafts 2	Same, but at most 2 drafts this time
run draft_url --url https://...	Score and draft one posting
run interview --application-id 5	Interview prep for tracker row 5
run gmail_check	One Gmail check
run deadline_alert	Alert for applications closing within 3 days
set-password --username me	Set the dashboard login (--generate prints a random password)
selftest	Check bun, TeX, poppler, the login and Claude access

run keeps its own run history (app/data/cli/), so it never races a running server.

Development

.venv/bin/python -m unittest discover -s app/tests -t .   # Apply Desk tests
python -m unittest discover -s tests -t .                 # framework tool tests
cd app/web && bun run dev                                 # dashboard dev server
cd app/web && bun run build                               # production build served by the app

The HTTP API the dashboard uses is documented in app/API.md.