halo-agent

Local apply agent for HALO. Auto-fills job applications in your real Chrome session — your cookies, your IP, your logged-in tabs — so it bypasses the bot-detection that blocks cloud headless browsers on sites like Workday and LinkedIn.

Install + pair

In the HALO dashboard, open Profile → Auto-apply agent → Get pairing code. Then on your machine:

npx halo-agent pair <CODE>
npx halo-agent install-autostart   # optional: run continuously at every login
npx halo-agent start               # connect now

That's it. The dashboard's "Agent connected" pill should flip on within 30 seconds.

How it works

• Polls GET /apply-queue/next for queued jobs.
• Launches your real Chrome via Playwright (CDP on port 9222, your default profile) — not a headless browser.
• Fills the application with materials you prepped + signed off on in HALO (tailored resume PDF, reviewed cover letter, per-field answers).
• Defaults to review-first: agent fills, then pauses for your sign-off. Per-job auto-submit toggle in HALO if you want it to submit directly.
• CAPTCHA: CapSolver if configured, vision fallback via Anthropic if not.
• Heartbeats every 15s so the dashboard knows you're online.

Commands

| | | |---|---| | halo-agent pair <code> | One-click pair with HALO (recommended) | | halo-agent start | Connect + start polling | | halo-agent install-autostart | Run at every login (macOS / Windows / Linux) | | halo-agent uninstall-autostart | Remove the autostart entry | | halo-agent init | Legacy: manual token paste | | halo-agent token <value> | Update the saved auth token |

Config

Lives at ~/.halo-agent/config.json. Set HALO_API_URL to point at a self-hosted Worker.

License

MIT