Commands

Commands

Run every command from the repository folder with uv run jobradar <command>.

Command	What it does
init	Creates config/config.yaml, config/profile.yaml and .env from the examples if missing, logs in to Telegram (code sent to your app), and checks the Notion database. Run once.
chats	Lists every channel and group your account can read, with the id to put in sources.telegram.chats.
run	Catches up on each channel, then listens live and processes everything. Ctrl+C stops it cleanly.
add <url>	Adds one job link by hand and syncs it to Notion, without Telegram.
extract --missing	Queues page reading for jobs listed before you had an LLM key. run then works through them at about requests_per_minute.
stats [--days N]	Posts received, posts with no link, jobs, reposts merged, hidden ads, likely duplicates, posts → jobs per channel, failed tasks. Default 7 days.
retry --failed	Puts failed tasks back in the queue; they run on the next run.
--version	Prints the version.

Not built yet: resume (v0.3), doctor (v0.4). They print which release they are planned for.

Reading the log

Line	Meaning
telegram catch-up done chat=… messages=N	Read N posts that arrived while JobRadar was off
telegram listening chats=N	Live on N channels
new job … url=…	A link seen for the first time
duplicate job, added sighting	A repost of a known job; its Seen In goes up
message has no job link	A post without a usable link (text-only or image); read from v0.2 part C
link hidden … reason=…	An ad or a denied link was hidden
notion page created / updated / details written	Notion writes
job extracted … role=… company=…	Gemini read the job
page not usable … why=login required	The job page needs a login; the post text is used instead
daily LLM budget reached	LLM work pauses until midnight; listing continues