Shopping Copilot

About

# faoz — AI Form Copilot

A browser extension that fills out web forms for you using your own profile data and Claude. It detects the kind of form you're on (job application, bug bounty report, freelance proposal, visa application, grant application, CRM, contact, onboarding, etc.), figures out what each field is asking for, and either suggests a value or rewrites your draft text to sound more professional.

## Features

- **Form detection** — classifies the current page (URL + page title heuristics) into a form type, and classifies each field (cover letter, summary, skills, vulnerability description, reproduction steps, contact info, etc.).
- **Smart autofill** — generates a suggestion for a focused field based on your active profile and the surrounding page context.
- **Rewrite assist** — takes existing text in a field and rewrites it to be clearer/more professional.
- **Profiles** — store multiple profiles (professional, freelancer, student, developer, creator, custom), each with contact info, work experience, education, skills, reusable snippets, and bug-bounty-specific bio/templates.
- **Local-first storage** — settings and profiles are kept in `chrome.storage.local`; nothing is sent anywhere except the Anthropic API call needed to generate a suggestion.
- **Free / Pro tiers** — the free plan includes 5 AI suggestions/rewrites per day; a one-time **faoz Pro** license removes the daily limit. See [Monetization](#monetization) below.

### Supported form types

`job_application`, `bug_bounty`, `freelance_proposal`, `visa_application`, `grant_application`, `crm`, `contact`, `onboarding`, and a `generic` fallback for anything else.

## How it works

- [contents/form-copilot.tsx](contents/form-copilot.tsx) — content script injected into pages; detects focused form fields and surfaces suggestions inline.
- [lib/formDetector.ts](lib/formDetector.ts) — pure heuristics for form-type and field-category detection.
- [lib/memoryStore.ts](lib/memoryStore.ts) — profile/settings persistence via `chrome.storage.local`.
- [lib/types.ts](lib/types.ts) — shared types (`Profile`, `FieldContext`, `AIRequest`, etc.).
- [background.ts](background.ts) — service worker that calls the Anthropic Messages API (`api.anthropic.com/v1/messages`) with your API key to generate suggestions and rewrites.
- [popup.tsx](popup.tsx) — extension popup UI (quick settings/status).
- [options.tsx](options.tsx) — full options page for managing profiles, work experience, education, skills, snippets, the Anthropic API key, and the Pro license.
- [lib/usageStore.ts](lib/usageStore.ts) — tracks daily free-tier suggestion/rewrite usage in `chrome.storage.local`.
- [lib/license.ts](lib/license.ts) — verifies Pro license keys offline (Ed25519 signature check, no server).

## Requirements

- An Anthropic API key (suggestions are generated with `claude-haiku-4-5`, billed to your own key).

## Getting started

1. Build/load the extension (see [Development](#development) below).
2. Click the faoz icon and open **Options**.
3. Paste your Anthropic API key and create a profile (fill in contact info, work experience, skills, snippets, etc.).
4. Pick the profile as active, then visit any form — focus a field to see an inline suggestion, or use the rewrite action on text you've already typed.