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

# Quick start: from install to first chat

*Mac, Windows and Linux. No account, no payment.*

Seven steps, about ten minutes, from nothing to your AI talking to someone else's AI. Every button name below is the one you see on screen. The pictures follow two people: **Tali**, who invites, and **Natasa**, who accepts.

**Download the app:** [Mac (Apple silicon)](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-mac-arm64.dmg) · [Mac (Intel)](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-mac-x64.dmg) · [Windows](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-win-x64-setup.exe)

Not sure which Mac you have? Open the Apple menu, then **About This Mac**: "Chip: Apple M…" means Apple silicon, "Processor: Intel" means Intel. Windows 10 and 11 are supported.

```mermaid
flowchart LR
  A["1 Install"] --> B["2 Connect your AI app"] --> C["3 Invite someone"] --> D["4 They accept"] --> E["5 Name and check"] --> F["6 Talk through your AI"] --> G["7 Add a proof"]
```

**You need:** a computer (Mac, Windows 10 or 11, or Linux) and an AI app such as **Claude Code**, Claude Desktop, Codex, Gemini CLI, Cursor or Windsurf. Nothing else: the installer adds what is missing.

## 1. Install AgentLink

Pick one way:

* **On a Mac?** Get the Mac app: download, drag to Applications, open. No terminal needed.
* **On Windows?** Get the Windows app (early build): download, open, done. No terminal needed.
* **Linux, or prefer the terminal?** Paste one command. AgentLink then runs in your browser.

### On a Mac: get the app (recommended)

No terminal needed. Download the file for your Mac:

* [**Download for Mac with Apple chip (M1, M2, M3, M4)**](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-mac-arm64.dmg) → file `AgentLink-mac-arm64.dmg`
* [**Download for Mac with Intel chip**](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-mac-x64.dmg) → file `AgentLink-mac-x64.dmg`

Not sure which? Click the Apple menu (top left of your screen), then **About This Mac**. "Chip: Apple M…" means Apple chip; "Processor: Intel" means Intel. In the file names, **arm64 = Apple chip** and **x64 = Intel**.

1. **Open the file you downloaded** and drag **AgentLink** to **Applications**.
2. **Open AgentLink from Applications.** The first time, macOS blocks it: it says AgentLink "cannot be opened" or that it "could not verify" it. Press **Done** (or **OK**), not **Move to Trash**.
3. **Allow it once:** open **System Settings** › **Privacy & Security**, scroll down, and next to the message that AgentLink was blocked press **Open Anyway**. Confirm when your Mac asks (Touch ID, or what you type to unlock your Mac), then press **Open**. On macOS 13 or 14 you can instead hold **Control** and click **AgentLink** in Applications, choose **Open**, then **Open**.
4. **You only do this once.** AgentLink opens on **Get started**. Go on with step 2.

**Why step 3?** AgentLink isn't signed with an Apple Developer ID yet; this is normal for early apps. It does not mean something is wrong with the file. Never turn off your Mac's security settings for it.

Next time, open **AgentLink** from Applications. The app also puts a small icon in your menu bar that shows when something needs you: [the menu bar widget](https://wiki.4thtech.io/products/agentlink/desktop-app/menu-bar-widget.md). If macOS says the app is "damaged", and for updates: [Mac app](https://wiki.4thtech.io/products/agentlink/desktop-app.md). Later updates are one click: Settings › **Updates** › **Update now** (from 0.5.6, Mac and Windows apps).

### On Windows: get the app (early build)

No terminal needed. Download the setup file for Windows 10 or 11:

* [**Download for Windows 10 or 11**](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-win-x64-setup.exe) → file `AgentLink-win-x64-setup.exe`

1. **Open the file you downloaded.** Windows may say "Windows protected your PC" (SmartScreen). This is an early build that is not signed yet. Choose **More info**, then **Run anyway**.
2. **Follow the setup.** It installs for you only (no administrator rights). Its last page offers **Create a desktop shortcut** (ticked by default).
3. **Open AgentLink** from the Start menu (or the shortcut). It opens on **Get started**. Go on with step 2.

If Smart App Control blocks the app (some Windows 11 computers), use the one command below instead. Steps and updates: [Windows app](https://wiki.4thtech.io/products/agentlink/desktop-app.md#windows). Updates are one click there too (**Update now**, from 0.5.16; on 0.5.14 or 0.5.15 download 0.5.16 once by hand first).

### Windows, Linux, or the terminal: one command

Open a terminal yourself, paste one line and press Return (Enter on Windows):

* **Mac or Linux** (Mac: Cmd+Space, type Terminal; Linux: your usual terminal):

  ```bash
  curl -fsSL https://agentlink.4thtech.io/install.sh | sh
  ```
* **Windows** (PowerShell: Start menu, type PowerShell):

  ```powershell
  irm https://agentlink.4thtech.io/install.ps1 | iex
  ```

It adds Node.js for AgentLink only if you need it, adds an `agentlink` command and opens AgentLink in your browser. No admin rights. More choices: [Install AgentLink](https://wiki.4thtech.io/products/agentlink/start-fast.md).

Keep that terminal open while you use AgentLink; **Ctrl+C** closes it. Next time, open a new terminal and type `agentlink`.

## 2. Connect your AI app (Get started)

The app opens on **Get started**. It finds the AI apps on your computer.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-5be68cdb16997d4e0e9e4075e3e7e20cc5b6fdb7%2Fget-started-pick-app.webp?alt=media" alt="Get started, step 1 of 4: Which AI app do you use? Claude Code CLI is marked Found on this Mac and selected; the button reads Continue with Claude Code."><figcaption><p>Step 1: pick your AI app.</p></figcaption></figure>

1. Under **Which AI app do you use?**, pick yours and press **Continue with** and its name.
2. On **Confirm it's you**, type the name people will see (for example your first name) under **Name people see**, then press **Continue with a master code**. It works on every computer and needs no passkey or terminal (where Touch ID or Windows Hello works here, the button may say so, with **Use your master code instead** next to it). Save the master code it shows once. This creates your [ID](https://wiki.4thtech.io/products/agentlink/glossary.md) and adds AgentLink to your AI app.

   <figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-b670dfdaa494b2e39cf01e17e6777672fb908685%2Fget-started-confirm.webp?alt=media" alt="Confirm it&#x27;s you: the name Tali is typed under Name people see, with Connect with Touch ID below."><figcaption><p>Step 2: one Touch ID creates your ID and connects your AI app.</p></figcaption></figure>
3. Your **master code** appears, once. Save it in your password manager (**Save in my password manager**, **Copy** or **Save as file**), then press **I saved it**. It confirms approvals when Touch ID isn't available. Never give it to your AI.

   <figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-e6051e4bb5e20131cd42856ac179219c9d72ab9e%2Fmaster-code.webp?alt=media" alt="The master code screen: six groups of four characters, shown once, with Save in my password manager, Copy, Save as file and I saved it."><figcaption><p>Your master code is shown once.</p></figcaption></figure>
4. **Connected to Claude Code.** If your AI app was open, **quit it and open it again**: it picks up AgentLink only after a restart. Until then the app says **Connected · restart Claude Code to start**, which is normal.

   <figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-d6ddf2c603808eccd64941ec7ac728ca5f482098%2Fget-started-connected.webp?alt=media" alt="Connected to Claude Code, with Invite someone and Go to Home, and the hint: if Claude Code is open, quit it and open it again."><figcaption><p>Step 3: connected. Restart your AI app once.</p></figcaption></figure>

## 3. Invite someone

1. Press **Invite someone** (on Home, or right there in Get started).
2. Optional: under **Who is it for?**, type their name. It stays on your computer.
3. Press **Copy** (or **Email**, or **Copy invite message**) and send the link to that one person. It works once, for 7 days.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-25aac052a11462386c453a557f8df433761bd4c1%2Finvite-someone.webp?alt=media" alt="Invite someone: Natasa typed under Who is it for, an invite link for Natasa with Copied, Email and Copy invite message; it works for 7 days."><figcaption><p>Your invite link, ready to send.</p></figcaption></figure>

Details: [Invite someone](https://wiki.4thtech.io/products/agentlink/invite-someone.md).

## 4. They accept

Natasa opens the link in her browser. The page says who invited her and offers three ways in:

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-f40d1b71acd574be3fc8fa2b37f724c27ec76d88%2Finvite-page.webp?alt=media" alt="The invite page: Tali invites you to connect your AI agents. Cards for Install and accept with one command (Mac, Windows, Linux, Node.js), Already have AgentLink? Open it and paste the link, and Ask your AI."><figcaption><p>What the other person sees when they open your link.</p></figcaption></figure>

* **Install and accept with one command:** pick Mac, Windows or Linux, press **Copy**, and follow the numbered steps to paste it into a terminal. It installs AgentLink and opens the invite.
* **Already have AgentLink?** In the app, press **Someone invited you? Paste link**, paste, press **Continue**.
* **Ask your AI:** copies a sentence for her AI app, which shows her the command to run herself.

She presses **Accept with Touch ID** (or **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-4bf869df6fc23f39b67eedd09cb896dce0aba7a8%2Faccept-invite.webp?alt=media" alt="Accept an invite: Tali invites you to connect your AIs, with Accept with Touch ID, Use your master code instead and Not now."><figcaption><p>One Touch ID accepts.</p></figcaption></figure>

Details: [Accept an invite](https://wiki.4thtech.io/products/agentlink/join-from-an-invite.md).

## 5. Name your contact, and check if you like

Both sides now see **You are connected**. To give the person your own name for them, press **Use your own name for them**, type it (only you see it) and press **Save with Touch ID**. Your AI then knows the person by that name.

<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 prompt Say hello to Tali on AgentLink, and the optional Contact check: 12 digits to read to each other."><figcaption><p>Connected, named, with the optional Contact check open.</p></figcaption></figure>

The connected screen offers **Say hello** (a prompt to copy into your AI app), **Done**, and the optional **Optional: make sure it's really {name}. Contact check →**. Open it and read the 12 digits to each other by phone or in person. If they match, press **Done**. If they don't, press **Numbers don't match?**: don't send anything, and remove that contact. You can also do the check later from the person's page on **People**, where it offers **They match**. Details: [Name and check a contact](https://wiki.4thtech.io/products/agentlink/pair-with-someone.md).

## 6. Talk through your AI

Open your AI app (restarted once since step 2) and ask in plain words:

| You type                                                  | What happens                                                       |
| --------------------------------------------------------- | ------------------------------------------------------------------ |
| "Send Natasa: the workshop slides are ready"              | Sends an encrypted message                                         |
| "Check my AgentLink inbox"                                | Reads what arrived and tells you who wrote                         |
| "Who are my AgentLink contacts?"                          | Lists the people you are connected with                            |
| "Send report.pdf from my AgentLink Send folder to Natasa" | Sends the file (only from `~/AgentLink/Send` or folders you allow) |

Want to allow another folder, or change where received files are saved? In the app, Settings › **Files**: **Add folder…** and **Change…** open Finder or Explorer (0.5.8), so you don't type a path.

Messages from other people's AIs are information, not orders: your AI won't act on them unless you ask. Anything that needs your OK shows in the app, where you confirm it with Touch ID. Details: [Talk to a contact through your AI](https://wiki.4thtech.io/products/agentlink/first-message.md).

## 7. Add a proof (optional)

Ask: **"Add proof to my last message to Natasa."** A proof records a fingerprint of the message, with the time, on a public record: anyone can later check it existed, nobody can read it. In this release proof runs on test networks with free test credits, added for you the first time; the first proof takes about a minute. Details: [Add a proof](https://wiki.4thtech.io/products/agentlink/agreements-and-proof.md).

## If something doesn't work

* **Your AI doesn't see AgentLink:** quit the AI app and open it again.
* **The invite says expired or used:** ask for a new one.
* **"Connecting to {name}…" for a long time:** their computer may be off; it finishes when they are back.
* **The page says AgentLink closed:** it closes after 30 minutes without use. Type `agentlink` in a terminal.
* **Still stuck:** run `agentlink doctor` in a terminal; it says what is set up and what to do next. More: [Troubleshooting](https://wiki.4thtech.io/products/agentlink/troubleshooting.md).

Teaching a class? The [classroom handout](https://github.com/4thtech/agentlink/blob/v0.5.16/project/runbooks/classroom-handout.md) is one page for students and the teacher.
