How feder-cr/jobs_applier_ai_agent works
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: session.py Search Session · apply.py Form Filler · tui.py Terminal UI · cli.py CLI Entry
Components 16
Terminal Experience
- CLI Entry
src/aihawk/cli.py - Terminal UI
src/aihawk/tui.py - UI Screens
src/aihawk/screens.py - Search Session
src/aihawk/session.py
Search and Matching
- Resume Profile
src/aihawk/profile.py - Job Search Index
src/aihawk/database.py - Fit Scoring
src/aihawk/shortlist.py - Model Gateway
src/aihawk/llm.py
Application Automation
- Site Plugins
src/aihawk/plugins.py - Form Filler
src/aihawk/apply.py
Workspace and Records
- Search Settings
src/aihawk/config.py - Local Job Store
src/aihawk/store.py
Other components
- Job Seeker
- Hosted Job Data
- OrcaRouter
- Firefox Browser
Connections 18
- Job Seeker → CLI Entry: starts
README.md - CLI Entry → Terminal UI: opens
src/aihawk/cli.py - Terminal UI → Search Session: drives
src/aihawk/tui.py - Terminal UI → UI Screens: prompts
src/aihawk/tui.py - Search Session → Search Settings: loads
src/aihawk/session.py - Search Session → Resume Profile: installs resume
src/aihawk/session.py - Resume Profile → Model Gateway: builds profile
src/aihawk/profile.py - Model Gateway → OrcaRouter: requests models
src/aihawk/llm.py - Search Session → Job Search Index: searches postings
src/aihawk/session.py - Job Search Index → Hosted Job Data: reads postings
src/aihawk/database.py - Search Session → Fit Scoring: scores jobs
src/aihawk/session.py - Fit Scoring → OrcaRouter: asks fit
src/aihawk/shortlist.py - Search Session → Local Job Store: records jobs
src/aihawk/session.py - Terminal UI → Form Filler: sends approved
src/aihawk/tui.py - Form Filler → Firefox Browser: fills and submits
src/aihawk/apply.py - Form Filler → OrcaRouter: requests form actions
- Site Plugins → Form Filler: guides site forms
- Form Filler → Local Job Store: keeps outcomes
src/aihawk/apply.py