Social Blade for everyone you know.

One private contact book. Bring your contacts together and let your agent help you stay in touch.

macOS

Terminal

bun add --global @hraness/peopleblade@latest

Requires Bun 1.3.14+. Apple Contacts and iMessage imports are Mac only.

Linux

Terminal

bun add --global @hraness/peopleblade@latest

Requires Bun 1.3.14+

Windows

Not tested on Windows. Runs in WSL2 with the Linux command.

WSL2 terminal

bun add --global @hraness/peopleblade@latest

See how it works Try it in a minute

#Apple Contacts, read on this Mac

$peopleblade contacts sync --json

{"people_created": 2, "emails_touched": 2, "conflicts": 0}

#LinkedIn, from the official data export

$peopleblade linkedin import ~/Downloads/linkedin-export.zip --json

{"connections_linked": 1, "people_created": 1}

#iMessage: who and when, never what was said

$peopleblade imessage sync --json

{"messages_matched": 12, "caught_up": true}

Step 1 of 4. Each import prints what it added. iMessage adds who and when, never the words.

Bring your contacts: One book from 14 import sources, including contacts, chat apps, and exports.
Private by default: Your book lives on your computer. Conversation text stays out.
No account required: Start for free. Add free sync whenever you want it.
No lock-in: Keep your database, export your contacts, and take them anywhere.
Your choice of AI: Use the agent and AI subscription you already have.
Build on your book: Open data and a full command line for any workflow you imagine.

Watch

See it work, start to finish.

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

**PeopleBlade in 44 seconds.** Recorded with PeopleBlade 0.13.1.

How it works

Bring your contacts together.

Bring together your address book, chat contacts, and exports. Review matches once; keep the context in one place.

Every source and its limits

Your contacts come together, with the source of each detail preserved.

Import what you already have
Bring in contacts from your accounts and exports. Your original address books stay intact.
Accept the matches
Review suggested matches by email or phone. You choose what to join, and can undo it.
Ask your agent
Ask your agent to find someone, add a note, or show who you meant to follow up with.

What you can do

Find people and keep the context.

A little context makes it easier to keep in touch.

Find people: Search names, organizations, titles, and contact details across every import. Filter by source or tag, and sort by last contact.
Keep notes: Add dated Markdown notes to a person, search them, and edit them with a full history of changes.
Follow up: Set a reminder or a rhythm, such as every six weeks. Ask your agent who is due a follow-up.
Correct a detail: Edit a name, title, or organization. Later imports never overwrite your edit, and you can reset it to the imported value.
Research a person: Add cited public research to a contact, using your agent or optional paid enrichment.

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 in your own words. Your agent finds the answer in your contact book.

Use your own agent: Keep the AI tools and subscriptions you already use. Any agent that runs terminal commands can work with your book.
Share just enough context: Give your agent one person's background and cited research. Your notes and other contacts stay out of that file.
Build on your book: Your local data, an open-source CLI, and a hosted API let you build your own tools and workflows.

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": 13,
      "lastInteractionAt": "2026-09-03T10: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

You need Bun 1.3.14 or newer on macOS or Linux. Run the install command, then create your contact book.

Read the guide

peopleblade init
peopleblade stats

Follow the guide to import your first contacts or connect an account.

Package and release details

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 npm Read the release guide

Sync

Sync only when you choose.

Keep your book on one computer, or sync it for free. You choose.

Privacy details

Your book stays on your computer. Device sync and free cloud sync are optional.

Device sync: Keep contacts and notes together across your devices, with end-to-end encryption.
How device sync works
Cloud sync: Make selected contact details available to connected tools and optional paid enrichment. 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
	PeopleBlade	Hosted 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
Take your data	Full database + exports	Export limits vary
Build your own workflows	Open command line	API and plan limits
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. The name is a nod. Social Blade tracks public stats for creators' accounts. PeopleBlade keeps a private book of the people you know and shows which app or export each contact came from. Its X import counts your own following, followers, and mutuals. It offers no creator grades, rankings, or audience growth tracking.

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.

Which contacts can I bring?

PeopleBlade imports from 14 sources, each verified end to end: two on your Mac, four signed-in accounts through GhostGet, three official data exports, and five kinds of file you choose. Two more need setup first and are not counted yet: Gmail interactions and X live mutuals. The verified ones are Apple Contacts, iMessage, Google Contacts, Beeper, WhatsApp, Substack subscribers, LinkedIn, Instagram, X data archive, Contact CSV, vCard contacts, Outlook contact export, Calendar invitations, and Apple Photos. Apple Contacts and iMessage need macOS. Substack sync handles publications up to 500 subscribers. The sources page lists each one with its limits.

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. The code is MIT licensed, and your AI subscription is separate. Hosted research is optional and costs at most $0.16 per contact. Previewing a run is free and shows the contacts it would research. The final price is set when a run settles, from what it actually used, and you pay only for contacts where it saves at least one detail. Credits are prepaid, one credit per cent, in packs of $10, $25, $50, or $100. You pay through Stripe Checkout; Stripe sells the credits through Link and adds any tax at checkout.

What do I need to run it?

macOS or Linux with Bun 1.3.14 or newer. Install from the terminal, then point your agent, such as Claude Code or Codex, at the peopleblade command. Apple Contacts and iMessage imports require a Mac.

Your account

Add free cloud sync and manage enrichment credits. Your local book works without an account.

Create account Sign in

The contact book you own, built for your agent

Read as Markdown

Social Blade for everyone you know.

See it work, start to finish.

Bring your contacts together.

Import what you already have

Accept the matches

Ask your agent

Find people and keep the context.

Let your agent work with your contacts.

Try it in a minute

Sync only when you choose.

Choose the contact book that fits.

Questions

Your account

TextButler

GhostGet

Soulscrape

Wordcell

Excalibur (xcb)

Gobstopper

aicharts

Social Blade for everyone you know.

See it work, start to finish.

Bring your contacts together.

Import what you already have

Accept the matches

Ask your agent

Find people and keep the context.

Let your agent work with your contacts.

Try it in a minute

Sync only when you choose.

Choose the contact book that fits.

Questions

Your account

Relationships

TextButler

GhostGet

Soulscrape

Knowledge

Wordcell

Tools for Token Maximalists

Excalibur (xcb)

Gobstopper

aicharts