# feder-cr/jobs_applier_ai_agent architecture

> Architecture diagram of the GitHub repository feder-cr/jobs_applier_ai_agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/feder-cr/jobs_applier_ai_agent
- Repository: https://github.com/feder-cr/jobs_applier_ai_agent

## Overview

AIHawk is a terminal job-search and application agent. The user supplies a resume; the interface drives a session that builds search criteria, finds postings, scores their fit, and lets the user approve applications. Applications are completed in a browser, with outcomes and evidence retained locally. The map includes the documented data-source and site-plugin capabilities. Several source excerpts are partial, so uncertain internal calls are omitted; README statements support the principal workflow.

Main entry points: [`src/aihawk/session.py`](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/session.py) (Search Session), [`src/aihawk/apply.py`](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/apply.py) (Form Filler), [`src/aihawk/tui.py`](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/tui.py) (Terminal UI), [`src/aihawk/cli.py`](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/cli.py) (CLI Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Terminal Experience"]
  node_cli["CLI Entry<br/>[cli.py]"]
  node_tui["Terminal UI<br/>[tui.py]"]
  node_screens["UI Screens<br/>[screens.py]"]
  node_session["Search Session<br/>[session.py]"]
end

subgraph group_search["Search and Matching"]
  node_profile["Resume Profile<br/>[profile.py]"]
  node_database["Job Search Index<br/>[database.py]"]
  node_shortlist["Fit Scoring<br/>[shortlist.py]"]
  node_llm["Model Gateway<br/>[llm.py]"]
end

subgraph group_apply["Application Automation"]
  node_plugins["Site Plugins<br/>[plugins.py]"]
  node_apply["Form Filler<br/>[apply.py]"]
end

subgraph group_state["Workspace and Records"]
  node_config["Search Settings<br/>[config.py]"]
  node_store[("Local Job Store<br/>[store.py]")]
end

node_user(("Job Seeker"))
node_jobdata[("Hosted Job Data")]
node_orcarouter["OrcaRouter"]
node_browser["Firefox Browser"]

node_user -->|"starts"| node_cli
node_cli -->|"opens"| node_tui
node_tui -->|"drives"| node_session
node_tui -->|"prompts"| node_screens
node_session -->|"loads"| node_config
node_session -->|"installs resume"| node_profile
node_profile -->|"builds profile"| node_llm
node_llm -->|"requests models"| node_orcarouter
node_session -->|"searches postings"| node_database
node_database -->|"reads postings"| node_jobdata
node_session -->|"scores jobs"| node_shortlist
node_shortlist -->|"asks fit"| node_orcarouter
node_session -->|"records jobs"| node_store
node_tui -->|"sends approved"| node_apply
node_apply -->|"fills and submits"| node_browser
node_apply -.->|"requests form actions"| node_orcarouter
node_plugins -.->|"guides site forms"| node_apply
node_apply -.->|"keeps outcomes"| node_store

click node_cli "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/cli.py"
click node_tui "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/tui.py"
click node_screens "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/screens.py"
click node_session "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/session.py"
click node_profile "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/profile.py"
click node_config "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/config.py"
click node_database "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/database.py"
click node_shortlist "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/shortlist.py"
click node_llm "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/llm.py"
click node_store "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/store.py"
click node_plugins "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/plugins.py"
click node_apply "https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/apply.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_tui,node_screens,node_session,node_browser toneBlue
class node_profile,node_database,node_shortlist,node_llm,node_jobdata toneAmber
class node_plugins,node_apply,node_orcarouter toneMint
class node_config,node_store toneRose
class node_user toneIndigo
```

## Components

### Terminal Experience

- [CLI Entry](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/cli.py): `src/aihawk/cli.py`
- [Terminal UI](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/tui.py): `src/aihawk/tui.py`
- [UI Screens](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/screens.py): `src/aihawk/screens.py`
- [Search Session](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/session.py): `src/aihawk/session.py`

### Search and Matching

- [Resume Profile](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/profile.py): `src/aihawk/profile.py`
- [Job Search Index](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/database.py): `src/aihawk/database.py`
- [Fit Scoring](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/shortlist.py): `src/aihawk/shortlist.py`
- [Model Gateway](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/llm.py): `src/aihawk/llm.py`

### Application Automation

- [Site Plugins](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/plugins.py): `src/aihawk/plugins.py`
- [Form Filler](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/apply.py): `src/aihawk/apply.py`

### Workspace and Records

- [Search Settings](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/config.py): `src/aihawk/config.py`
- [Local Job Store](https://github.com/feder-cr/jobs_applier_ai_agent/blob/main/src/aihawk/store.py): `src/aihawk/store.py`

### Other components

- **Job Seeker**
- **Hosted Job Data**
- **OrcaRouter**
- **Firefox Browser**

## Connections

- Job Seeker → CLI Entry: starts (evidence: `README.md`)
- CLI Entry → Terminal UI: opens (evidence: `src/aihawk/cli.py`)
- Terminal UI → Search Session: drives (evidence: `src/aihawk/tui.py`)
- Terminal UI → UI Screens: prompts (evidence: `src/aihawk/tui.py`)
- Search Session → Search Settings: loads (evidence: `src/aihawk/session.py`)
- Search Session → Resume Profile: installs resume (evidence: `src/aihawk/session.py`)
- Resume Profile → Model Gateway: builds profile (evidence: `src/aihawk/profile.py`)
- Model Gateway → OrcaRouter: requests models (evidence: `src/aihawk/llm.py`)
- Search Session → Job Search Index: searches postings (evidence: `src/aihawk/session.py`)
- Job Search Index → Hosted Job Data: reads postings (evidence: `src/aihawk/database.py`)
- Search Session → Fit Scoring: scores jobs (evidence: `src/aihawk/session.py`)
- Fit Scoring → OrcaRouter: asks fit (evidence: `src/aihawk/shortlist.py`)
- Search Session → Local Job Store: records jobs (evidence: `src/aihawk/session.py`)
- Terminal UI → Form Filler: sends approved (evidence: `src/aihawk/tui.py`)
- Form Filler → Firefox Browser: fills and submits (evidence: `src/aihawk/apply.py`)
- Form Filler → OrcaRouter: requests form actions
- Site Plugins → Form Filler: guides site forms
- Form Filler → Local Job Store: keeps outcomes (evidence: `src/aihawk/apply.py`)
