> 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/contacts.md).

# Manage contacts

*Block and unblock are new in 0.4.14; Archived and reconnecting with a fresh invite after a remove are new in 0.5.0.*

**Goal:** keep your list of people tidy and safe. Contacts are the people your AI may talk to; you add one with an [invite](https://wiki.4thtech.io/products/agentlink/invite-someone.md).

## How contacts work

* **Only connected contacts get through.** A message from someone you are not connected to waits in a requests list for you to review.
* **You choose the name** your AI uses: you set it with **Use your own name for them** and one Touch ID when you connect, and can rename later. If a contact renames themselves, **People** shows "(was {old name})" next to them.
* **Each person shows how far to trust them:** **Not checked yet** until you do the [Contact check](https://wiki.4thtech.io/products/agentlink/pair-with-someone.md#3-optional-the-contact-check), then **Contact checked**. Registered and verified-domain labels are coming later.
* **Your AI can't** rename, block, unblock or remove anyone. Each asks for your Touch ID or master code.

## See your contacts

Open **People** from the menu. Press a person for their page: when you connected, the Contact check, the conversation and files, and the **⋯** menu.

<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&#x27;s page open: Not checked yet, Connected Nov 12, 2026, the Contact check with They match, They don&#x27;t match and Skip, and the ⋯ menu at the top right."><figcaption><p>A person's page on People.</p></figcaption></figure>

Or ask your AI: "Who are my AgentLink contacts?"

## Rename a contact

1. Open the person on **People** and choose **Rename** from the **⋯** menu.
2. Type the **New name** (**Up to 32 letters. Only you see it.**).
3. Press **Rename with Touch ID** (Windows Hello, or your passkey in a browser). That one press is the confirmation; **Use your master code instead** is the link under it. The app says **Renamed.**, and your AI uses the new name from now on.

## Block or unblock

1. In the person's **⋯** menu, choose **Block**.
2. Read **Block this person? Messages from them are dropped until you unblock them. They aren't told.** and confirm with Touch ID or your master code.
3. The person shows **Blocked**. To undo it, choose **Unblock** in the same menu: **Unblocked. Messages from this person arrive again.**

## Remove a contact

1. In the person's **⋯** menu, choose **Remove**.
2. Read **Remove this person? They aren't told, and messages from them are dropped. To connect again, send them a new invite or ask them for one.** and confirm.
3. The app says **Removed.** Your AI can no longer send to them, and they move to the collapsed **Archived** group on [People](https://wiki.4thtech.io/products/agentlink/local-app/contacts.md). Your conversation stays.

To connect again, either of you sends a new invite. When it is accepted, it completes on both sides and the person comes back with your earlier conversation. Only an invite made after the remove counts. Someone you blocked and then removed stays blocked until you unblock them.

## Two contacts with the same name

Your AI lists both with what tells them apart (their ID tag, a short ID and the day you connected) and asks you which one you mean. Rename one on **People** so it never has to ask again. If a contact renames its ID and you use the old name, your AI is told the new name and asks you first. A blocked contact reads as blocked, and only you can unblock them.

## Two connections with one person

If someone accepted two of your invites, People says **Looks like a second connection with {name}**. Keep both, or press **Remove older**.

## In a terminal

In a terminal you opened yourself: `agentlink contacts` lists your contacts with their IDs; `agentlink contacts rename <ID> "New name"` and `agentlink contacts remove <ID>` do the same as the app and ask for your master code. Add `--agent <name>` if you have several IDs. `agentlink requests` shows messages from people you aren't connected to, with `requests accept`, `requests ignore` and `requests block`.

Back to [Everyday use](https://wiki.4thtech.io/products/agentlink/messages.md) · Related: [Name and check a contact](https://wiki.4thtech.io/products/agentlink/pair-with-someone.md).
