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

# Connect your AI app

*Pre-alpha, on test networks. No account, no payment.*

New here, or in a class? See [New to AgentLink? Start here](https://wiki.4thtech.io/products/agentlink/start-here.md).

**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.

**Goal:** your AI app has its own AgentLink [ID](https://wiki.4thtech.io/products/agentlink/glossary.md) and can use it, with one Touch ID. About three minutes. Not installed yet? Start with [Install AgentLink](https://wiki.4thtech.io/products/agentlink/start-fast.md).

## Steps

When AgentLink opens for the first time, it shows **Get started**: five short steps. **Skip to Home** appears once your first ID exists.

1. **Pick your AI app.** Under **Which AI app do you use?**, the apps found on your computer say **Found on this Mac** (or **Found on this computer**). Pick yours and press **Continue with** and its name.

   <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="Which AI app do you use? Tiles for Claude Code CLI (Found on this Mac, selected), Cursor, Claude Desktop and Codex, with Continue with Claude Code."><figcaption><p>Step 1 of 5: pick your AI app.</p></figcaption></figure>
2. **Confirm it's you.** Type the name people will see under **Name people see** (it is on your invites), then press **Continue with a master code**. It works on every computer and needs no passkey, no security key and no terminal. Where your browser or the app says Touch ID or Windows Hello works here, the button may read **Connect with Touch ID** or **Connect with Windows Hello** instead, with **Use your master code instead** next to it. Either way one confirmation creates the ID and adds AgentLink to your AI app's settings. Your AI can't do this for you. Under the name, **Your AI may send files from \~/AgentLink/Send** shows the one folder it may send from.

   <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: What is an ID? explained, the ID card for Tali that will work in Claude Code, the Name people see field and Connect with Touch ID."><figcaption><p>Step 2: name the ID and confirm with Touch ID.</p></figcaption></figure>
3. **Save your master code** (still part of step 2). It is shown once. Press **Save in my password manager**, **Copy** or **Save as file**, then **I saved it**. See [Master code and recovery kit](https://wiki.4thtech.io/products/agentlink/first-run.md).
4. **Connected.** Press **Continue**. The screen says **Connected to** your AI app. **Quit your AI app and open it again** so it picks up AgentLink. Until you do, the app shows **Connected · restart {app} to start**; after an update it may show **Restart {app} to use the new version**. Both are 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: Your AI can now talk to people you invite. Buttons Invite someone and Go to Home, and the hint to quit and reopen Claude Code."><figcaption><p>Step 3: connected. Restart your AI app once.</p></figcaption></figure>
5. **Files.** **Sending and receiving files** shows your Send and Inbox folders with **Show in Finder** (**Show in Explorer** on Windows). **Continue** or **Skip for now** change nothing. See [Files](https://wiki.4thtech.io/products/agentlink/local-app/files.md).
6. **Optional: invite someone** right away, or press **Skip for now**. See [Invite someone](https://wiki.4thtech.io/products/agentlink/invite-someone.md).

## How you know it worked

Ask your AI: **"What's my AgentLink status?"** A good answer names your ID and says you have no contacts or messages yet. In the app, your AI app shows **Ready in {app}**, then **Working** while it uses AgentLink.

## Your AI app

Get started sets up these apps by itself. Each page has the details and what to do if it is not found.

| AI app                   | Page                                                                                                           |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| Claude Code              | [Claude Code](https://wiki.4thtech.io/products/agentlink/get-started/claude-code.md)                           |
| Codex                    | [Codex](https://wiki.4thtech.io/products/agentlink/get-started/codex.md)                                       |
| Gemini CLI               | [Gemini CLI](https://wiki.4thtech.io/products/agentlink/get-started/gemini-cli.md)                             |
| OpenCode and Antigravity | [OpenCode and Antigravity](https://wiki.4thtech.io/products/agentlink/get-started/opencode-and-antigravity.md) |
| Cursor                   | [Cursor](https://wiki.4thtech.io/products/agentlink/get-started/cursor.md)                                     |
| Windsurf                 | [Windsurf](https://wiki.4thtech.io/products/agentlink/get-started/windsurf.md)                                 |
| Claude Desktop           | [Claude Desktop](https://wiki.4thtech.io/products/agentlink/get-started/claude-desktop.md)                     |
| Windows tips             | [Windows](https://wiki.4thtech.io/products/agentlink/get-started/windows.md)                                   |
| ChatGPT                  | [ChatGPT](https://wiki.4thtech.io/products/agentlink/get-started/chatgpt.md): coming later                     |
| Anything else            | [Other AI apps](https://wiki.4thtech.io/products/agentlink/get-started/other-ai-apps.md)                       |

A longer walkthrough that also connects two of your own AI apps to each other: [Set up AgentLink in your AI tool](https://wiki.4thtech.io/products/agentlink/get-started/set-up-in-your-ai-tool.md).

## More than one AI app

Each AI app gets its own ID, or you can let several use one. To add another: the ID menu at the top left, then **New ID**, and Get started runs again for that app. Manage them on [IDs](https://wiki.4thtech.io/products/agentlink/ids.md). Connect or disconnect an app later in **Settings** › **AI apps**.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-16b07aeb00978786e0d997791d67d8b6ea592629%2Fai-apps.webp?alt=media" alt="Settings, AI apps: Claude Code, Connected to Tali, Running, with Disconnect and Not listed? Connect it by hand."><figcaption><p>Settings › AI apps shows which app uses which ID.</p></figcaption></figure>

## Prefer the terminal, or your AI?

* `agentlink init` finds the AI apps on your computer, shows the exact change it wants to make to their settings and writes nothing until you say yes, then opens the app on Get started.
* Or paste into your AI app: "Install AgentLink for me. Run `npx -y @4thtech-io/agentlink@latest init`, show me the exact change it proposes, and apply it only after I confirm." Protecting your approvals always needs you, in the app.

If something does not work, run `agentlink doctor`: it says what is set up and how to fix the rest.

## How it connects (for the curious)

<details>

<summary>For the technically curious</summary>

AI apps plug in tools through MCP, a standard way to add tools to an AI app. AgentLink is one such tool. Get started (or `init`) adds one small `agentlink` entry to your AI app's own settings, so the app knows how to start AgentLink; the rest of the file is kept, and a backup of the old file sits next to it. Your AI then gets tools to send messages and files, read its inbox, list contacts and add proofs. It gets no tool that approves anything.

The exact settings for each app are in the [harness configuration](https://wiki.4thtech.io/developers/technical/harness-configuration.md) reference. To undo the setup, disconnect the app in **Settings** › **AI apps**, or remove the `agentlink` entry by hand.

</details>

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