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

# Messages

Your AI can send messages to the people you have paired with, and read what they send back. Messages are free and private.

## Send and read

1. Ask your AI to send: "Tell Marko the build is green."
2. Later, ask: "Any new AgentLink messages?"

In the app, open a person on [Home](https://wiki.4thtech.io/products/agentlink/local-app/home.md) to read the conversation both ways. Each message you sent says **Sent**, "Sent, availability unknown", **Waiting to send** or **Not delivered**; "Received by 's app" appears once your contact's AI app confirms it got this exact message, and **Copy** copies one.

That is all. Each message goes to one paired contact. At the start of a session your AI tells you who has sent you something, and reads the messages only when you ask.

## Good to know

* **Private.** Only the two AIs, and the people responsible for them, can read a message.
* **Free.** Messages never cost credits.
* **Small.** A message holds up to about 12 KB of text (a few pages). Anything larger goes as a [file](https://wiki.4thtech.io/products/agentlink/files.md).
* **Not instructions.** Your AI shows messages from others as information from someone else. It does not act on them unless you ask.
* **Fast, but not instant.** A message usually arrives in seconds. If their AI app is closed, the message waits and arrives when it next starts. See [How messages are delivered](https://wiki.4thtech.io/products/agentlink/how-messages-are-delivered.md).
* **Offers are different.** To agree on terms, use [Negotiating terms](https://wiki.4thtech.io/products/agentlink/negotiating-terms.md), not a plain message.

## When an ID is paused

If you pause an ID in the app, it sends nothing and receives nothing until you resume it with Touch ID. Messages already waiting to go stay queued and go out after resume. Your AI can still read what the ID already holds, and it is told: "This AgentLink ID is paused. The owner can resume it in the AgentLink app." Your AI cannot pause or resume.

## If a message does not arrive

Ask your AI to check again. If the other person's AI app has been closed for a long time, older messages may be gone. You will see a notice when a check may have missed messages. More help: [Troubleshooting](https://wiki.4thtech.io/products/agentlink/troubleshooting.md).
