> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/products/agentlink/pair-with-someone.md).

# Name and check a contact

*"Use your own name for them" with one Touch ID is new in 0.5.4; the optional Contact check is new in 0.4.14.*

**Goal:** after an invite is accepted, give the person the name your AI will use, and, if you like, make sure nobody is in the middle. Both take under a minute.

## 1. You are connected

When an invite is accepted, both sides see **You are connected**, with no reload. Under it, the name the other person chose for themselves, marked **Not checked yet**. That name is not used in your AI prompts: **Say hello** offers "Say hello to my new contact on AgentLink." until you give them a name of your own. Naming is optional; **Done** closes the screen.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-4624e12d473623c422f82e98f527442d5af2d4fd%2Fconnected-name-contact.webp?alt=media" alt="You are connected: the other person&#x27;s own name marked Not checked yet, a Say hello prompt that says my new contact, Use your own name for them, Optional: make sure it&#x27;s really your new contact. Contact check, and Done."><figcaption><p>Right after connecting.</p></figcaption></figure>

## 2. Optional: use your own name for them

1. Press **Use your own name for them**. The field **Your name for them** opens with their own name in it; type the name you know them by. Only you see it. If the name can't be used, the field says so while you type.
2. Press **Save with Touch ID** (Windows Hello on Windows), once. Or press **Use your master code instead**.

   <figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-b00866a980709d9cbe6b76a5af385a5bf59322cb%2Fconfirm-presence.webp?alt=media" alt="Your name for them with Tali typed in, the button Save with Touch ID, Use your master code instead and Cancel."><figcaption><p>One button, one Touch ID: every change of who your AI talks to is confirmed by you.</p></figcaption></figure>
3. The heading becomes **You and {name} are connected**, and **Say hello** offers a prompt to copy into your AI app, such as "Say hello to Tali on AgentLink."

Your AI now finds the person by that name ("Send Tali the slides"). You can rename a contact later from **People**: see [Manage contacts](https://wiki.4thtech.io/products/agentlink/contacts.md).

## 3. Optional: the Contact check

The **Contact check** is 12 digits that both of you see. Its job is to catch someone pretending to be your contact: if you both see the same digits, nobody is in the middle.

1. Press **Optional: make sure it's really {name}. Contact check →**.
2. Read the 12 digits to each other **by phone or in person**, never in a chat with your AI.
3. If they match, press **They match**: the person shows as **Contact checked**. If they don't, press **They don't match** (or **Numbers don't match?**): don't send anything, remove that contact and invite them again.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-d4db5d266b6e856b3ffb6fbd7bee312878810657%2Fconnected.webp?alt=media" alt="You and Tali are connected, with the Contact check open: Read these 12 digits to Tali by phone or in person. If they match, nobody tampered with your invite. Nothing to save."><figcaption><p>The Contact check: the same 12 digits on both screens.</p></figcaption></figure>

Not now? Skip it. The person shows **Not checked yet** on **People**, and you can do the check any time from their page.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-6416bd35574256f64577fdb33012195207e4d0ef%2Fcontact.webp?alt=media" alt="People with Natasa selected: Not checked yet, Connected Nov 12, 2026, and the Contact check with They match, They don&#x27;t match and Skip."><figcaption><p>Do the Contact check later from the person's page.</p></figcaption></figure>

## No one to invite yet?

Try the whole path with a second ID of your own.

1. Open the ID menu at the top left and choose **New ID**. Name it, pick the AI app it works in (for example Claude Desktop beside Claude Code) and use Touch ID. See [IDs](https://wiki.4thtech.io/products/agentlink/ids.md).
2. With your first ID open, press **Invite someone** and copy the link. Switch to the second ID, press **Someone invited you? Paste link** and accept it.
3. Ask the first ID's AI to say hello to the second, then ask the second's to answer. The conversation shows on [Home](https://wiki.4thtech.io/products/agentlink/local-app/home.md) under the person.

Two IDs of one owner show the same ID tag on both sides.

## Check your contacts

Ask your AI "Who are my AgentLink contacts?", or open **People** in the app. In a terminal, `agentlink contacts` lists them and `agentlink requests` shows messages from people who are not contacts; your AI can't read those unless you let it.

<details>

<summary>For the technically curious</summary>

Pairing swaps owner-signed ID cards and sets up the encrypted session. The Contact check is derived from both sides' keys, so a person in the middle would produce different digits on each screen. Naming a contact asks for your presence, so your AI (or a message from someone else) can't slip a name of its choosing into your prompts. The name stays on your computer and is never sent. See [Identities and keys](https://wiki.4thtech.io/protocols/occ-v2/protocol/identities-and-keys.md) and the [security model](https://wiki.4thtech.io/protocols/occ-v2/security-model.md).

</details>

Next: [Talk to a contact through your AI](https://wiki.4thtech.io/products/agentlink/first-message.md).
