Cold Pitch Boss

Two steps. That's it.

Download the zip. Paste a prompt into Claude. Claude does the rest — virtual environment, dependencies, browser setup, Gmail authentication, the first dry run.

№ 01

Download the zip

A single 30 KB file. The whole agent, MIT licensed.

cold-pitch-boss.zip

Save it somewhere you'll remember — Downloads is fine.

№ 02

Hand it to Claude

Copy this prompt and paste it into Claude Code (best — it can actually run the commands) or Claude.ai (will walk you through each step in chat).

I just downloaded cold-pitch-boss.zip from freelance.mikee.ai. It's an open-source AI agent that researches prospects and writes cold-outreach emails for me (a freelancer/creator).

Please install and set it up for me, end-to-end:

1. Find the zip in my Downloads folder (or wherever I saved it) and extract it to ~/cold-pitch-boss.
2. Create a Python virtual environment in that folder and install everything in requirements.txt.
3. Install Playwright's Chromium browser (the agent uses it for prospect research).
4. Walk me through Gmail OAuth setup: tell me exactly what to click in Google Cloud Console to create a Desktop OAuth client, then help me save the credentials.json in the right place.
5. Help me write my Ideal Client Profile YAML by asking me about my business, my target customers, and the kind of writing I want to be hired for. Fill in cold_pitch_agent/icp_example.yaml's structure based on my answers.
6. Help me log into LinkedIn once so the agent has a persistent session.
7. Run a dry-run pass over the three sample prospects in examples/prospects_example.json — just to confirm everything works. (Drafts only — never auto-send during setup.)
8. Show me my Gmail drafts and walk me through reviewing them.

Notes:
- ANTHROPIC_API_KEY is required (mine is at console.anthropic.com).
- Default mode is drafts-only. Never send emails without my explicit approval.
- If anything fails, diagnose and tell me what you need from me — don't just retry blindly.

Read the README.md inside the zip first — it has the architecture and constraints you should follow.

That's it. Claude will ask you for the missing pieces (your business, your API key, etc.) and handle the rest. If you get stuck, the full walkthrough has more detail.

Prefer to do it yourself?

Of course. After unzipping:

cd cold-pitch-boss
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python -m playwright install chromium
export ANTHROPIC_API_KEY=sk-ant-...
python -m cold_pitch_agent.agent --help

Full hand-install walkthrough — Gmail OAuth, LinkedIn, first campaign — in the install docs.