Get started
Theme
Appearance

Local personal CRM

A local personal CRM, made for your agent.

PeopleBlade keeps everyone you know in one private book on your computer. Import contacts, mail, and messages with every source kept, let your agent search, note, and research, and sync between your devices only if you choose.

Install PeopleBladeWatch the film
  • Free CLI
  • macOS and Linux
  • No account needed
Three imports become one Maya Chen. Her phone keeps its Apple Contacts tag, her organization and title keep LinkedIn, and the last conversation keeps iMessage.

Imports

Bring your contacts together.

Address books, chat apps, and exports become one book from 14 sources, and every detail keeps its source.

  • iMessage
  • LinkedIn
  • WhatsApp
  • Apple Contacts
  • Instagram
  • Google Contacts
  • X data archive
  • Beeper
  • Substack subscribers
  • Apple Photos
  • Outlook contact export
  • Contact CSV
  • Calendar invitations
  • vCard contacts
Every source and its limits

Watch

See it work, start to finish.

Three imports become one person, your agent answers with its sources, and sync copies the book to a second computer.

Image
PeopleBlade in 41 seconds. Made from a recorded run of the released CLI on sample data.

Agents

Let your agent work with your contacts.

Claude Code, Codex, or your preferred agent can search your book and help you keep in touch.

Ask your agent who you know at Fieldwork Studio. It finds Maya Chen in your contact book.Ask in your own words. Your agent finds the answer in your contact book.Ask a questionWho do I know atFieldwork Studio?Your agentFinds the answerin your contact bookMaya ChenProduct designerLast spoke September 3
Ask your agent who you know at Fieldwork Studio. It finds Maya Chen in your contact book.Ask in your own words. Your agent finds the answer in your contact book.Ask a questionWho do I know atFieldwork Studio?Your agentFinds the answerin your contact bookMaya ChenProduct designerLast spoke September 3
Ask in your own words. Your agent finds the answer in your contact book.
See an example search result

For example: “Who do I know at Fieldwork Studio?”

$ peopleblade query --search "Fieldwork Studio" --json
{
  "items": [
    {
      "id": 1,
      "displayName": "Maya Chen",
      "organization": "Fieldwork Studio",
      "title": "Product designer",
      "primaryEmail": "maya@example.com",
      "primaryPhone": "+1 415 555 0142",
      "interactionCount": 14,
      "lastInteractionAt": "2026-09-03T17:30:00.000Z",
      "sources": ["apple", "imessage", "linkedin"]
    }
  ],
  "total": 1
}
The Maya Chen records with a shared email become one. The Maya who shares only the name stays separate.

Get started

Try it in a minute

Install the command line, create your book, and import your first contacts.

Read the guide

macOS

Terminal
bun add --global @hraness/peopleblade@latest

peopleblade init
peopleblade stats
Requirements and release details

Runs with Bun 1.3.14 or newer on macOS and Linux. Apple Contacts and iMessage need macOS. Telegram is not available. See every import and its limits, or connect an account.

Public CLI · npm 0.15.1

The CLI is on npm as @hraness/peopleblade 0.15.1, for Bun on macOS and Linux. Your contact book is a SQLite file on your computer, and you need a web account only for the optional device sync, cloud sync, /api/v1 connector, and hosted research.

View on npmRead the release guide

Sync only when you choose.

Keep your book on one computer, or sync it for free. You choose.
Device sync
Contacts and notes travel between your devices, end to end encrypted. How device sync works
Cloud sync
Selected contact details reach connected tools and optional research. Notes and message text stay out. What cloud sync uploads

Alternatives

Choose the contact book that fits.

Your contacts, your tools, your choice.

PeopleBlade and hosted personal CRMs
PeopleBladeHosted personal CRM
Master copy
On your computer
On their servers
Works without an account
Yes
No
Your own AI
Bring your agent
Varies by service
Cost
Free, including sync
Free or subscription
Hosted enrichment
At most $0.16 / contactFree preview
Pricing varies

Dex and Mesh are hosted personal CRMs with apps that sync your accounts and remind you to keep in touch. Monica is an open-source web app you self-host or rent. Clay builds prospect lists for sales teams. PeopleBlade is free, has no app, and keeps your book on your computer for your agent.

FAQ

Questions

Do I need an account?

No account is needed for your local book. Create a free account when you want device sync, cloud sync, connected tools, or paid enrichment.

Is PeopleBlade related to Social Blade?

No. Social Blade tracks public creator statistics. PeopleBlade keeps a private contact book and records where each detail came from.

Is there an app or a web view of my contacts?

PeopleBlade works through your agent or the terminal. There is no contact-browsing app. The website manages your optional account.

How does matching work?

A shared name never joins two people. An exact email or phone match joins them after you accept it, or when you opt in to auto-accept. You can undo an accepted match.

What does it cost?

The CLI and optional sync are free. Hosted research costs at most $0.16 per contact, with a free preview. You use your own AI subscription.

What do I need to run it?

A terminal and an agent such as Claude Code or Codex. Install from the terminal, then point your agent at the peopleblade command. The install section lists the platform requirements.

Other tools from our studio

Relationships

Knowledge

Tools for Token Maximalists

Local personal CRM that your agent runs from the command line

Read as Markdown