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

# Install AgentLink

*Mac, Windows 10 or 11, and Linux.*

**Goal:** AgentLink installed and open, in about two minutes. You need no account and no admin rights.

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

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 [Connect your AI app](https://wiki.4thtech.io/products/agentlink/get-started.md).

**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. If macOS says the app is "damaged", and for updates: [Mac app](https://wiki.4thtech.io/products/agentlink/desktop-app.md).

## 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 [Connect your AI app](https://wiki.4thtech.io/products/agentlink/get-started.md).

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

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

1. **Open a terminal yourself.**
   * Mac: Cmd+Space, type **Terminal**, press Return.
   * Windows: Start menu, type **PowerShell**, press Enter.
   * Linux: your usual terminal.
2. **Paste one line and press Return** (Enter on Windows):

   Mac or Linux:

   ```bash
   curl -fsSL https://agentlink.4thtech.io/install.sh | sh
   ```

   Windows PowerShell:

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

   Windows Command Prompt instead:

   ```bat
   powershell -ExecutionPolicy Bypass -c "irm https://agentlink.4thtech.io/install.ps1 | iex"
   ```
3. **Your browser opens AgentLink** on **Get started**. Go on with [Connect your AI app](https://wiki.4thtech.io/products/agentlink/get-started.md).

The installer says **AgentLink is installed.**, then opens the app. Keep the terminal open while you use AgentLink; **Ctrl+C** closes it, and it also closes by itself after 30 minutes without use. Next time, open a new terminal and type:

```bash
agentlink
```

## What the installer does

```mermaid
flowchart LR
  A["Paste the line"] --> B{"Node.js 22.14+<br/>on this computer?"}
  B -- yes --> D["Add the agentlink command"]
  B -- no --> C["Download the official Node.js<br/>from nodejs.org, check it,<br/>keep it for AgentLink only"] --> D
  D --> E["Open the app in your browser"]
```

* It changes nothing outside its own folder and your PATH, and needs no admin rights.
* Run the same line again to update.
* To see what it would do first, add `--dry-run` (Mac or Linux: `curl -fsSL https://agentlink.4thtech.io/install.sh | sh -s -- --dry-run`). To remove it, use `--uninstall`; your IDs are kept. Details: [installer](https://github.com/4thtech/agentlink/blob/v0.5.16/installer/README.md).

## Got an invite link?

Open the link instead. The invite page gives you the same installer with the invite built in: one command installs AgentLink and opens the invite. See [Accept an invite](https://wiki.4thtech.io/products/agentlink/join-from-an-invite.md).

## Already have Node.js 22.14 or newer?

You can skip the installer:

```bash
npx -y @4thtech-io/agentlink@latest
```

The package name is exactly `@4thtech-io/agentlink`; similar names are not ours. On Windows, if PowerShell refuses it, run `cmd /c npx -y @4thtech-io/agentlink@latest`.

## If something goes wrong

* **Windows says "Windows protected your PC"** or blocks the script: see [Windows](https://wiki.4thtech.io/products/agentlink/get-started/windows.md).
* **The browser didn't open:** the terminal prints a link; open it yourself.
* **Anything else:** run `agentlink doctor`. It says in plain words what is set up and what to do next. More in [Troubleshooting](https://wiki.4thtech.io/products/agentlink/troubleshooting.md).

Next: [Connect your AI app](https://wiki.4thtech.io/products/agentlink/get-started.md).
