harvey
Autonomous AI sales agent powered by Claude Code or Codex. Finds prospects, writes cold emails, sends campaigns, handles replies, books meetings. No API keys needed — runs on your Claude or Codex subscriptions.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ethanplusai/sellbird with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ethanplusai/sellbird'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/ethanplusai--harvey)HTML
<a href="/listings/ethanplusai--harvey"><img src="/api/listings/ethanplusai--harvey/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Prerequisites
- **Python 3.11+** — check with `python3 --version`. macOS ships 3.9; if that's what you have, `brew install python@3.13` first. - An active **Claude Pro or Max** subscription, with the CLI logged in (`claude login`) — or, opt-in, a **ChatGPT plan with the Codex CLI** ([see below](#using-a-chatgpt-plan-instead-codex)) - A mailbox to send from — Gmail/Workspace recommended, on a *dedicated secondary domain*. Microsoft 365 works too ([setup](docs/microsoft365.md))
Easiest: let Claude set it up
git clone https://github.com/ethanplusai/harvey.git cd harvey claude
Then say: **"set up Harvey for me"**. The repo ships a `CLAUDE.md` that turns Claude Code into the setup wizard — it checks what state you're in, installs what's missing, asks what it needs, and trains Harvey on your product.
Or do it yourself
# 1. Install — note python3.13, not python3. On macOS bare `python3` is the # system 3.9, and a venv built from it can't run Harvey. python3.13 -m venv .venv && source .venv/bin/activate && pip install -e . # 2. Configure — every variable is documented inline with where to get it cp .env.example .env && $EDITOR .env # 3. Learn your product from your website harvey train https://your-company.com # 4. Choose what makes a good prospect (see below — this one matters) harvey signals --confirm free # 5. Find businesses. Free source, no account needed. harvey discover # 6. Watch it work harvey dashboard # http://localhost:5555 harvey run
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 198 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <p align="center">
- <a href="https://sellbird.ai">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/brand/sellbird-wordmark-white.svg">
- <img src="docs/brand/sellbird-wordmark.svg" alt="Sellbird" width="300">
- </picture>
- </a>
- </p>
- <p align="center"><strong>The open-source outreach platform that runs on your Claude or ChatGPT plan.</strong></p>
- <p align="center">
- Sellbird finds companies that need what you sell, finds the person who decides, checks their email address, writes each one a personal cold email, sends it and handles the replies.
- It runs on your own machine, and by default nothing goes out until you approve it.
- </p>
- <p align="center">
- <a href="https://x.com/sellbirdagent"><img alt="Follow @sellbirdagent on X" src="https://img.shields.io/badge/follow-%40sellbirdagent-000000?logo=x&logoColor=white"></a>
- <a href="https://github.com/ethanplusai/sellbird/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ethanplusai/sellbird?style=flat&logo=github&label=stars&color=244b62&cacheSeconds=3600"></a>
- <a href="https://github.com/ethanplusai/sellbird/actions/workflows/tests.yml"><img alt="Tests" src="https://github.com/ethanplusai/sellbird/actions/workflows/tests.yml/badge.svg"></a>
- <a href="LICENSE"><img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-244b62"></a>
- <img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-244b62?logo=python&logoColor=white">
- <a href="https://sellbird.ai"><img alt="Hosted at sellbird.ai" src="https://img.shields.io/badge/hosted-sellbird.ai-244b62"></a>
- <a href="https://sellbird.ai/harvey/"><img alt="Formerly Harvey" src="https://img.shields.io/badge/formerly-Harvey-8aa0ad"></a>
- </p>
- <p align="center">
- <a href="https://trendshift.io/repositories/303676?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-303676" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/303676" alt="ethanplusai%2Fsellbird | Trendshift" width="250" height="55"/></a>
- </p>
- > **[Harvey is now Sellbird.](https://sellbird.ai/harvey/)** Same project, same history, new name. Already running Harvey? Your setup carries over: see [Upgrading from Harvey](#upgrading-from-harvey).
- **New releases, features and the roadmap go out first on X: [follow @sellbirdagent](https://x.com/sellbirdagent).**
- **Prefer not to run it yourself? [sellbird.ai](https://sellbird.ai) is the hosted version, with sending domains, inboxes and warmup set up for you. It's in early access.**
- 
- <sub>The demo data is invented: "Bookwell" selling online booking to roofers, dental practices and HVAC shops, on `.test` domains.</sub>
- ## What it does
- Sellbird is a pipeline you can run end to end, or stop at any step.
- | | What happens | More |
- |---|---|---|
- | **Find companies** | Searches for businesses that match your customer: free on OpenStreetMap, or on a paid source you pick. Every paid search shows its cost before it runs. | [Discovery](docs/signals-and-pipeline.md#1-discover--who-exists) |
- | **Learn why they'd buy** | Reads each company's own website for the buying signals you confirmed, like no online booking, ads running or a role they're hiring for. No model calls, no cost. | [Signals](docs/signals-and-pipeline.md) |
- | **Find who decides** | Finds the owner or manager named on the company's own pages, two people per company at most. | [Enrich](docs/signals-and-pipeline.md#3-enrich--who-decides) |
- | **Check the address** | Learns the company's email pattern and verifies one address. Every address is marked verified, risky, guess or invalid, and only deliverable ones are ever sent to. | [Verify](docs/signals-and-pipeline.md#4-verify--can-you-reach-them) |
- | **Write and send** | Writes a short sequence for each person from what it found, then sends from your Gmail, Microsoft 365 or SMTP mailbox inside your daily limit and their office hours. | [Sending](docs/approval-and-sending.md) |
- | **Handle replies** | Reads every reply, drafts an answer, sets auto-replies aside, honours opt-outs at once, and hands you anything it shouldn't answer alone. | [Dashboard](docs/dashboard.md) |
- Only want the list? Stop after verifying and run `sellbird export` for a sequencer-ready CSV of everything it found.
- ```
- $ sellbird run
- ============================================================
- Sellbird is online.
- ============================================================
- Checking pipeline state...
- Decision: write_campaign (3 new prospects with no drafts)
- handler → Elena Park, Harbor Dental Studio interested, answer drafted
- handler → Priya Nair, Highline Roofing objection, answer drafted
- writer → 2-email sequence: Phoenix HVAC hiring a dispatcher
- outbox → 5 emails waiting for your approval
- Cycle complete. Sleeping for 15 minutes.
- ```
- ## No model API bill
- Sellbird thinks through the Claude Code CLI on your Claude Pro or Max plan, or through Codex on a ChatGPT plan. There's no API key and no per-token billing, and Sellbird throttles itself to leave room for your own work.
- | | |
- |---|---|
- | Claude Pro or Max, or a ChatGPT plan with Codex | the subscription you already have |
- | Finding businesses | **$0** on the default source, or about $0.37 per 1,000 on the cheapest paid one |
- | Reading their websites | **$0**: three HTTP requests each, no model call |
- | Writing and sending | your subscription and a mailbox (about $7 a month for Google Workspace) |
- | Prospecting tools | **None.** No Apollo, ZoomInfo, Clearbit or Clay. |
- How the loop, the budget and the isolation work: [How Sellbird works](docs/how-it-works.md).
- ## Quick start
- You need:
- - **Python 3.11 or newer.** macOS ships 3.9, so run `brew install python@3.13` first if `python3 --version` says so.
- - **Claude Pro or Max** with the CLI signed in (`claude login`), or a **ChatGPT plan with the Codex CLI** ([Codex setup](docs/codex.md)).
- - **A mailbox to send from**, ideally Google Workspace on a separate sending domain. [Microsoft 365](docs/microsoft365.md) and SMTP work too.
- - **Warmup on that mailbox.** We recommend [TrulyInbox](https://trulyinbox.com/?via=sellbird): it warms a new mailbox before cold email and keeps it out of spam after, and Sellbird reads its inbox rate to tell you when you're ready.
- ### Let Claude set it up
- ```bash
- git clone https://github.com/ethanplusai/sellbird.git
- cd sellbird
- claude
- ```
- Then say **"set up Sellbird for me"**. The repo's `CLAUDE.md` turns Claude Code into the setup guide: it checks where you are, installs what's missing, asks what it needs and trains Sellbird on your product.
- ### Or do it yourself
- ```bash
- # 1. Install. Use python3.13, not python3: on macOS bare python3 is 3.9.
- python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
- # 2. Add credentials. Every variable is documented inline.
- cp .env.example .env && $EDITOR .env
- # 3. Learn your product from your website (writes sellbird.local.yaml).
- sellbird train https://your-company.com
- # 4. Confirm what makes a good prospect.
- sellbird signals --confirm free
- # 5. Find businesses. The default source is free and needs no account.
- sellbird discover
- # 6. Open the dashboard and start the loop.
- sellbird dashboard # prints a private link to http://127.0.0.1:5555
- sellbird run
- ```
- On Linux you can also [run it with Docker](docs/docker.md).
- ## Nothing sends without you
- Every outgoing email waits in the Outbox for your approval until you turn on autopilot yourself. Before anything leaves, a pre-send check with no model involved rejects unfilled merge tags, banned phrases, overlong emails, extra links and undeliverable addresses. Autopilot still holds back any email that links to a domain that isn't yours or quotes Sellbird's own instructions. `sellbird sending pause` stops everything at once.
- Details: [Approval and sending](docs/approval-and-sending.md) and [Legal and deliverability](docs/deliverability.md).
- ## Upgrading from Harvey
- Harvey was renamed Sellbird in 0.4.0. Your configuration, data and dashboard sign-in carry over:
- ```bash
- git pull
- pip install -e . # once, to get the new `sellbird` command
- sellbird dashboard
- ```
- - On first run Sellbird renames `harvey.local.yaml` to `sellbird.local.yaml` and `data/harvey.db` (and its log) to `data/sellbird.*`. It never overwrites a file that already exists under the new name, and waits if a Harvey process is still running from the folder. Stop that first.
- - `HARVEY_*` environment variables still work when the `SELLBIRD_*` one isn't set; rename them when convenient.
- - The `harvey` command and `python -m harvey` still work for now and say they moved. They will be removed in a later release.
- - If you edited the tracked `harvey.yaml` directly, `git pull` stops with "your local changes would be overwritten". Run `git stash`, `git pull`, then `git stash pop`. Git carries your edits into `sellbird.yaml`. If it reports a conflict there, keep your lines, delete the conflict markers, and run `git stash drop`. Better still, put your settings in `sellbird.local.yaml`, which git never touches.
- - Docker: the service is now `sellbird`. Run `docker compose down`, `git pull`, `docker compose build`, then `docker compose up -d`. `HARVEY_UID`/`HARVEY_GID` are still read.
- Links to `github.com/ethanplusai/harvey` keep working: GitHub redirects them here.
- ## Where your files live
- Your config, knowledge and data live in one home folder. Which one, first match wins:
- 1. `SELLBIRD_HOME`, if you set it (the Docker image sets it to `/app`).
- 2. A checkout: the checkout folder itself, as before.
- 3. Otherwise, for an installed package (`pip` or `pipx`), your user data folder:
- | | Home folder |
- |---|---|
- | macOS | `~/Library/Application Support/sellbird` |
- | Windows | `%APPDATA%\sellbird` |
- | Linux | `~/.local/share/sellbird` (or `$XDG_DATA_HOME/sellbird`) |
- Inside it are `sellbird.yaml` (and `sellbird.local.yaml` once you train), `.env`,
- `prompts/` and `skills/`, all yours to edit. An installed package copies the defaults in on
- first run and never overwrites them, so your edits survive upgrades. `data/` holds the
- database, the logs and the dashboard token.
- ## Documentation
- | Guide | What's in it |
- |---|---|
- | [How Sellbird works](docs/how-it-works.md) | The heartbeat loop, the subscription budget, project structure and the ideas behind it |
- | [Signals and the prospecting pipeline](docs/signals-and-pipeline.md) | The 29 signals, cohorts, and the discover, profile, enrich and verify stages |
- | [Skills and sub-agents](docs/skills-and-agents.md) | The editable sales playbooks and which agent uses which |
- | [Approval and sending](docs/approval-and-sending.md) | The Outbox, autopilot, office hours and email signatures |
- | [The dashboard and the data](docs/dashboard.md) | Every screen, how sign-in works, and how the data is stored |
- | [Configuration and commands](docs/configuration.md) | `.env`, `sellbird.yaml` and every command |
- | [Extensions](docs/extensions.md) | Adding routes, heartbeat steps and commands from a separate package |
- | [Using a ChatGPT plan (Codex)](docs/codex.md) | Running on Codex instead of Claude |
- | [Legal and deliverability](docs/deliverability.md) | The rules you're sending under, and warmup |
- | [Microsoft 365](docs/microsoft365.md) · [Precleared](docs/precleared.md) | Provider setup guides |
- | [Docker](docs/docker.md) · [Troubleshooting](docs/troubleshooting.md) · [Roadmap](docs/roadmap.md) | Running, fixing and what's next |
- ## Contributing
- Pull requests are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first: it covers keeping real contact data out of the repo, test email, and signing off your commits. Found a security problem? Follow [SECURITY.md](SECURITY.md) instead of opening an issue.
- See [CHANGELOG.md](CHANGELOG.md) for what changed in each release, and [follow @sellbirdagent on X](https://x.com/sellbirdagent) to hear about new ones first.
- ## License
- Sellbird is licensed under the [GNU Affero General Public License v3.0](LICENSE). Harvey releases up to 0.3.x were released under MIT, and that code keeps its MIT notice in [NOTICE](NOTICE).
- TrulyInbox links in this project are affiliate links: the maintainer may earn a commission, at no extra cost to you.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.