Usage¶

All commands must be run from inside your job_hunt/ folder (the one created by daiana init --copy_dir). This is where the .env file lives and where PDFs and CSVs are written.

This page covers the main user-facing commands in the order you are most likely to use them:

hunt — full end-to-end workflow.
show — inspect saved applications.
update — change the status or edit a saved entry.
oracle — extract and tailor job data without compiling.
compile — build a CV or cover letter from prompts or manual input.
save — log an application directly to the tracker.

daiana hunt¶

The full end-to-end pipeline in a single command: scrape → extract → tailor → compile → open → save.

At least one of --cv or --cl must be passed.

daiana hunt --url "https://jobs.example.com/role" --cv --cl --username jane

Flags

Flag	Description
`--url` / `-u`	URL of the job posting (required).
`--cv`	Extract job info and compile your CV.
`--cl`	Craft a tailored cover letter sentence and compile your cover letter.
`--username` / `-un`	Your name for the output PDF filename (default: `user_name`).
`--verbose`	Show full LaTeX compilation log in the terminal.

What happens

dAIana scrapes the job posting at --url.
The LLM extracts structured job info: position, company, location, career track, and link.
If --cl is set, the LLM also crafts a tailored first-paragraph sentence for your cover letter.
The extracted data is displayed in the terminal and can be edited.
LaTeX compilation runs for each requested document.
You can open the generated PDF(s) with your default viewer.
You can save the application to your CSV tracker.
The command reports total elapsed time.

Tip

Use --verbose the first time you run on a new machine to confirm pdflatex is finding all packages correctly.

daiana show¶

Display your last N saved applications for a given career path as a colour-coded table with status history and totals.

daiana show --career software
daiana show -cp data -rj 10

Flags

Flag	Description
`--career` / `-cp`	Career path label (required).
`--rows` / `-rj`	Number of recent entries to display (default: `20`, min: `1`).

The table footer shows the CSV path and the total number of applications across all statuses.

daiana update¶

Update the status or any editable field of a saved job application. The entry is located by matching position + company name. If multiple entries match, you are shown a numbered list to pick from.

daiana update --career software --status
daiana update -cp data --field
daiana update -cp data --erase

Flags

Flag	Description
`--career` / `-cp`	Career path label (required).
`--status` / `-s`	Interactively set a new application status.
`--field` / `-f`	Edit any other field of the saved entry.
`--erase` / `-e`	Delete a row from the tracker.

Allowed statuses

Status	Meaning
`applied`	Application submitted, no response yet.
`contacted`	Recruiter or hiring manager has reached out.
`int_1`	First interview scheduled or completed.
`int_2`	Second interview scheduled or completed.
`offered`	Offer received.
`rejected`	Application rejected.

daiana oracle¶

Scrape a job posting URL and send the text to the AI for extraction and tailoring without compiling PDFs.

At least one of --extract, --tailor_sentence, --project_selector, --background_selector, or --select_skills must be passed.

daiana oracle --url "https://jobs.example.com/role" --extract --tailor_sentence
daiana oracle --url "https://jobs.example.com/role" --extract --select_skills
daiana oracle --url "https://jobs.example.com/role" --extract --select_skills --project_selector

Flags

Flag	Description
`--url` / `-u`	URL of the job posting (required).
`--extract`	Extract structured job info: position, company, location, career, and link.
`--tailor_sentence`	Craft a tailored phrase for the first paragraph of your cover letter.
`--project_selector`	Pick the best matching projects from your project list.
`--background_selector`	Select the 3 most relevant background items for the cover letter.
`--select_skills`	Rank and select the most relevant skill categories and items from your skills inventory (`skills_payload.md`) for the given job posting. The result is displayed as a Selected Skills panel and passed automatically to `compile --cv` as the CV skills block.

Note

How ``–select_skills`` works

dAIana reads your skills_payload.md inventory.
The LLM ranks your skill categories and picks the most relevant items per category for the target job.
Up to 4 skill categories are returned, each with a tailored item list.
The selection is shown in a colour-coded Selected Skills panel.
You can edit individual categories and item lists interactively before they are forwarded to the compiler.
The final \\cvitem LaTeX block is injected into your CV template automatically — no manual editing required.

To customise which skills are available for selection, edit prompts/skills/skills_payload.md in your job_hunt/ folder.

This command is useful when you want the AI output but do not want to compile a PDF yet.

daiana compile¶

Render a LaTeX template and compile it to PDF from interactive prompts. Use this when you already know the job details or want to enter them manually.

daiana compile --cv
daiana compile --cl --username jane

Flags

Flag	Description
`--cv`	Use the CV template.
`--cl`	Use the cover letter template.
`--username` / `-un`	Name used in the output PDF filename (default: `user_name`).
`--verbose`	Print LaTeX compilation log details to the terminal.

After compilation, you can optionally save the job to the CSV tracker.

daiana save¶

Manually log a job application to the CSV tracker without compiling anything. This is useful when you apply through an external portal and just want to record the application.

daiana save --career software

Flags

Flag	Description
`--career` / `-cp`	Career path label (required) — for example, `software` or `data`.

After the flag, you are prompted for:

Job position
Company name
Location
Job link (optional)

The entry is appended to job_tracking/<career>.csv with status applied.