Skip to content

Managing People

Atlas includes a built-in contact manager — a lightweight CRM that lives entirely in your vault. Everything you know about the people in your life is stored as plain markdown files, readable and editable by Atlas during any conversation.

Open the People tab from the left sidebar to see all your contacts. Each person appears as a card showing their name, title, and company. Click a card to open the full contact record.

FieldDescription
NameFull name
TitleJob title or role
CompanyEmployer or organization
RoleYour relationship context (e.g., “client”, “mentor”, “colleague”)
EmailContact email
PhoneContact phone number
LocationCity, region, or country
TagsLabels for filtering (e.g., “investor”, “engineering”, “VIP”)
RelationshipsLinks to other people and organizations
NotesFree-form notes — anything that doesn’t fit above

None of these fields are required. Add as much or as little as is useful to you.

There are two ways to add a new contact:

Through the UI: Click the + button in the People tab and fill in the form.

Through chat: Ask Atlas directly — “add John Smith to my contacts, he’s a product manager at Acme Corp” — and Atlas will create the record for you.

Each person is saved as a markdown file at:

<vault>/atlas/network/people/{id}.md

An index.json file in the same folder keeps a searchable index of all contacts. Because these are plain .md files, you can open, edit, or read them in any text editor or directly in the Files tab.

Use the search bar in the People tab to find contacts by name, company, or any field. You can also filter by tags to show only contacts with a specific label — useful if you want to see all your “investors” or everyone tagged “London”.

You can control whether your contacts are accessible to the AI in Settings > Privacy:

  • Local AI access — allows Atlas to read your contacts when answering questions on your machine (recommended)
  • Cloud AI access — controls whether contact details are sent to the cloud as part of AI conversations

Next: Organizations