sellbird
Sellbird (formerly Harvey): the open-source outreach platform that runs on your Claude or ChatGPT plan. Finds companies and decision makers, verifies emails, writes personal cold email, sends it and handles the replies.
Install / Use
npx skills add ethanplusai/sellbirdInstalls into whichever agent you are using.
CLAUDE.md
Claude Code project instructions
Quality Score
Category
AutomationSupported Platforms
Our assessment of sellbird
sellbird scores 96/100 on our quality scale, 172nd of 2,771 Automation skills we index (top 7%).
Its CLAUDE.md is 12 KB long, well organised into 17 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
With 6,734 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated yesterday, so sellbird is actively maintained.
- It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit โ read the skill file before letting an agent act on it.
sellbird compared with similar skills
All 4 of these similar skills score higher than sellbird; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| sellbird (this skill)by ethanplusai | 96 | 6.7k | 1d ago | CLAUDE.md |
| taste-skillby Leonxlnx | 100 | 118.9k | 11d ago | CLAUDE.md |
| claude-memby thedotmack | 100 | 118.5k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.3k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install sellbird?
- Run
npx skills add ethanplusai/sellbird. The install tabs above show the steps for each supported agent. - Which AI agents does sellbird work with?
- It is written for Claude Code and OpenAI Codex, as a CLAUDE.md file. Other agents that read the same format can often use it too.
- Is sellbird safe to use?
- It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is sellbird still maintained?
- The repository was last updated yesterday, so sellbird is actively maintained.
Skill content
View source on GitHubHarvey is now Sellbird. Same project, same history, new name. Already running Harvey? Your setup carries over: see Upgrading from Harvey.
New releases, features and the roadmap go out first on X: follow @sellbirdagent.
Prefer not to run it yourself? 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 | | 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 | | Find who decides | Finds the owner or manager named on the company's own pages, two people per company at most. | Enrich | | 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 | | 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 | | 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 |
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.
Quick start
You need:
- Python 3.11 or newer. macOS ships 3.9, so run
brew install python@3.13first ifpython3 --versionsays so. - Claude Pro or Max with the CLI signed in (
claude login), or a ChatGPT plan with the Codex CLI (Codex setup). - A mailbox to send from, ideally Google Workspace on a separate sending domain. Microsoft 365 and SMTP work too.
- Warmup on that mailbox. We recommend TrulyInbox: 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
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
# 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.
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 and Legal and deliverability.
Upgrading from Harvey
Harvey was renamed Sellbird in 0.4.0. Your configuration, data and dashboard sign-in carry over:
git pull
pip install -e . # once, to get the new `sellbird` command
sellbird dashboard
- On first run Sellbird renames
harvey.local.yamltosellbird.local.yamlanddata/harvey.db(and its log) todata/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 theSELLBIRD_*one isn't set; rename them when convenient.- The
harveycommand andpython -m harveystill work for now and say they moved. They will be removed in a later release. - If you edited the tracked
harvey.yamldirectly,git pullstops with "your local changes would be overwritten". Rungit stash,git pull, thengit stash pop. Git carries your edits intosellbird.yaml. If it reports a conflict there, keep your lines, delete the conflict markers, and rungit stash drop. Better still, put your settings insellbird.local.yaml, which git never touches. - Docker: the service is now
sellbird. Rundocker compose down,git pull,docker compose build, thendocker compose up -d.HARVEY_UID/HARVEY_GIDare 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:
SELLBIRD_HOME, if you set it (the Docker image sets it to/app).- A checkout: the checkout folder itself, as before.
- Otherwise, for an installed package (
piporpipx), 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 | The heartbeat loop, the subscription budget, project structure and the ideas behind it |
| Signals and the prospecting pipeline | The 29 signals, cohorts, and the discover, profile, enrich and verify stages |
| Skills and sub-agents | The editable sales playbooks and which agent uses which |
| Approval and sending | The Outbox, autopilot, office hours and email signatures |
| The dashboard and the data | Every screen, how sign-in works, and how the data is stored |
| Configuration and commands | .env, sellbird.yaml and every command |
| Extensions | Adding routes, heartbeat steps and commands from a separate package |
| Using a ChatGPT plan (Codex) | Running on Codex instead of Claude |
| Legal and deliverability | The rules you're sending under, and warmup |
| Microsoft 365 ยท Precleared | Provider setup guides |
| Docker ยท Troubleshooting ยท Roadmap | Running, fixing and what's next |
Contributing
Pull requests are welcome. Read 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 instea
Truncated for display โ read the full file on GitHub.
Related Skills
taste-skill
118.9kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
claude-mem
118.5kPersistent Context Across Sessions for Every Agent โ Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu โ one CLI, zero API fees.
Understand-Anything
93.3kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit โ see the Safety scan above for what the skill file itself contains.
