> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# People

> The people in your life: a card and timeline for each, when you were last in touch, their dates, and a brief before you meet.

People keeps the people in your life: a card for each, their timeline, when you were last in touch and when you are due, their birthdays and other dates. It is on by default and appears in the sidebar as **People**, under **Notifications**. For turning plugins on and off, see [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

People is for your own host; a company's host has none. Its records stay on this computer.

## A person's card

* **Who**: name, relationship, notes, organisation and title, emails, phones, links, how you met, who introduced you, up to ten other names.
* **How close**: work or life, a tier from 1 to 4 and how often to be in touch. People works out the day you were last in touch (from chats, mail and calls) and the day you are next due; those due are listed first.
* **Dates**: a birthday, anniversaries and other dates. A date can be marked **Lunar** when lunar dates are on in **Manage → Dates**. **Coming up** lists the next 30 days.
* **Timeline**: moments noted by you or the agent, days with messages in their chats, mail threads, calls, recordings they were in, and calendar events they attend.

## The page

* **Import…**: a `.vcf` from iPhone or Google Contacts, a CSV from Outlook, Google Contacts or Remember, or a folder of person pages. It shows what it would do first, and fills only empty fields of people already here. Bringing the same file in again keeps what you typed.
* **Link chats…**: links each one-to-one chat titled with one person's name to that person.
* **Maybe the same person**: compare two cards side by side, choose what to keep, and merge. A merge can be undone from the kept card's merge history.
* **Tidy…**: offers what People can tidy (duplicates, chats or sources written in notes, records that are not people); only what you choose is done.
* A removed person can be brought back with **Undo**.

## What the agent can do

| Tool | What it does |
| - | - |
| `query_people` | Finds people, or those with a date in a month or soon (read only) |
| `people_candidates` | Lists people you deal with who are not in People yet (read only) |
| `save_person` | Adds or updates a person |
| `note_person` | Adds a moment to a timeline |
| `remove_person` | Removes a person (kept to restore) |
| `merge_people` | Merges two cards, after showing you the pair |

Changes follow the conversation's [permission mode](https://docs.archetype.ing/en/use/approvals.md).

## Notices

| Notice | When |
| - | - |
| **Birthdays and dates, each morning** | One a day listing the day's dates |
| **A brief before a meeting** | Before an event with someone in People: who each attendee is, the last touch, open questions, latest moments, how you met. Only what People keeps |
| **The morning's people** | Each morning from 8: up to seven people with a date coming up or due to be in touch, each with its reason |
| **People you deal with, to add** | New people found in your mail, calendar, chats and calls |

Each person found waits in **Notifications** to add, add to someone you have, or never ask again. No one is added on their own.

**`person.date`** is sent on a date's day, from 8 in the morning, and a few days ahead. A [trigger](https://docs.archetype.ing/en/use/automations.md) can wake on it.

## Settings

In **Manage → Plugins → People**:

| Setting | Default | What it does |
| - | - | - |
| **Days ahead to tell of a date** | 3 | 0 to 30; 0 tells only on the day |
| **Time zone** | this computer's | The time zone your morning is counted in |
| **Minutes before a meeting to brief** | 30 | 0 to 240; 0 turns the brief off |
| **The morning's people** | On | The morning notice |
| **Propose the people you deal with** | Off | Looks for people to add, every few hours |
| **Read this Mac's call history** | Off | Counts calls as being in touch. Mac only; may need Full Disk Access |
| **Call files** | Empty | JSON call files another tool keeps, for a computer that is not a Mac |
| **Read this Mac's Contacts** | Off | Brings in and keeps current your Mac's Contacts (iPhone's through iCloud). Read only |
| **Google Contacts connection** | Empty | Path to a Google OAuth credential file. Then editing a card linked to a Google contact updates its name, work, emails and phones there too |
| **Relationship workspace** | Off | Everyone, Follow up, Work, Life and Review contacts views, and sources for each field |

## Works with

People reads, when they are on: [Messenger](https://docs.archetype.ing/en/plugins/messenger.md) for chats, [Mail](https://docs.archetype.ing/en/plugins/mail.md) for mail, [Calendar](https://docs.archetype.ing/en/plugins/calendar.md) for events and briefs, and [Recordings](https://docs.archetype.ing/en/plugins/recordings.md) for the recordings someone was in. Without one, that part is left out. The sidebar's search finds people through People. People offers no profile.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.