Keep everyone you know in one private book.

Bring contacts from your phone, messaging apps, and data exports into one private book on your computer, searchable by your agent. Keep the book local and share only what you choose.

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

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

Pause scrolling

Three sources, one private book.

Apple ContactsRead on this Mac2 peopleSynced
LinkedInFrom the official data export1 connectionImported
iMessageWho and when, never the words12 messagesMetadata

Step 1 of 4. Each import prints what it added.

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 41 seconds.** Made from a recorded run of the released CLI on sample data.

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. 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.

Which contacts can I bring?

PeopleBlade has 14 import sources across address books, messaging apps, official exports, and contact files. The sources page lists setup and availability for each one.

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?

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

Keep everyone you know in one private book.

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

Keep everyone you know in one private book.

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