Introduction

Introduction

Envoy is a local, review-first autonomous agent designed to streamline your job application process. Running entirely on your own machine, Envoy takes the tedious work out of applying for jobs, allowing you to focus on roles that truly excite you and ensure every submission is aligned with your preferences.

What Envoy Does

Envoy empowers you to navigate the job market more efficiently and with greater precision by:

• Automated Job Discovery: Continuously searching popular job platforms like SEEK, Indeed, and LinkedIn for new opportunities that match your specified keywords, location, and other criteria.
• Personalized Application Drafting: Leveraging advanced AI to draft highly personalized cover letters and tailor application materials for each specific job. This includes an interactive "profile interview" feature, allowing Envoy to refine and build a rich, canonical representation of your professional experience and voice.
• Intelligent Form Filling: Automatically navigating and accurately filling out complex online application forms on various job portals, handling different layouts and requirements.
• Human-in-the-Loop Control: Operating on a "review-first" principle. Before any application is submitted, Envoy presents you with all drafted materials and form data for your approval. You retain full control, reviewing and editing everything from cover letters to specific form field values.
• Privacy and Local Execution: All operations, including data processing, AI reasoning, and storage, occur locally on your machine. Your personal data and job search activities remain entirely private and under your control.

How it Works (High-Level)

Envoy is built as a modular system, composed of three interconnected services that work together to provide its functionality:

• Portal (React): This is your interactive web user interface. You'll use the Portal to define search criteria, review discovered jobs, edit AI-drafted cover letters, participate in profile interviews, and approve applications before submission.
• Agent (Python): The intelligent core of Envoy, the Agent orchestrates all workflows. It manages AI interactions (such as cover letter generation and profile refinement), applies job-matching policies, and persists all application data to a local SQLite database.
• Tools (Node/Playwright): This service handles all browser automation tasks. It's responsible for interacting with external job boards to search for jobs, parse detailed job descriptions, and fill out application forms, all while remaining stateless for robustness.

This modular design ensures a reliable, transparent, and scalable application flow.

Next Steps

To begin using Envoy, please refer to the Installation Guide for setup instructions, followed by the Quick Start Guide to run your first job search and application.