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

# Windows

**Download the Windows app:** [AgentLink-win-x64-setup.exe](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-win-x64-setup.exe) (Windows 10 or 11, early build, no Node.js needed). On a Mac? See [Install AgentLink](https://wiki.4thtech.io/products/agentlink/start-fast.md).

*Windows 10 and 11. Windows support for AI apps arrived in 0.4.7. Pre-alpha, on test networks. No account, no payment.*

AgentLink works on Windows the same way as on a Mac. These are the Windows details.

## Prefer an app? (early build)

From 0.5.4 there is also an early **Windows app**: AgentLink in its own window, no Node.js and no PowerShell needed. Download [AgentLink-win-x64-setup.exe](https://github.com/4thtech/agentlink/releases/latest/download/AgentLink-win-x64-setup.exe) and open it. The last page of the setup offers **Create a desktop shortcut** (ticked by default; new in 0.5.5). It is not signed yet, so Windows may say "Windows protected your PC": choose **More info**, then **Run anyway**. If Smart App Control blocks it, use the command above instead. Steps and details: [Desktop app, Windows](https://wiki.4thtech.io/products/agentlink/desktop-app.md#windows).

Or use the one command below (needs Node.js and PowerShell).

## What you need

* **Node.js 22.14 or newer.** Open PowerShell and run `node --version`. If it is older or missing, install the current LTS from [nodejs.org](https://nodejs.org), then open a new PowerShell window.
* **PowerShell** (the blue "Windows PowerShell" or "PowerShell" in the Start menu). Open it yourself; do not let your AI open it for you.

## Install

In PowerShell:

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

Your browser opens on **Welcome**. The first line in the window says "Opening AgentLink in your browser…". If the page has not loaded after 15 seconds, the window says "Your browser didn't open AgentLink. Press Enter here to try again." Set up there, as in [Get started](https://wiki.4thtech.io/products/agentlink/get-started.md). Keep the PowerShell window open while you use the app. AgentLink stays open while you use it and closes after 30 minutes without use; the window and the page both say "AgentLink closed. Run `agentlink` to open it again." Press Ctrl+C to close it yourself. Check that the package name is exactly `@4thtech-io/agentlink`.

If PowerShell refuses to run it, run the command from **Command Prompt** (`cmd`) instead, or run `cmd /c npx -y @4thtech-io/agentlink@latest` in PowerShell.

## How your AI app starts AgentLink

On Windows, AgentLink adds this to your AI app's settings: `cmd /c npx -y @4thtech-io/agentlink mcp`. The `cmd /c` part is needed because many AI apps cannot start `npx` directly on Windows. If you connected AgentLink with an earlier version and your AI app says it cannot start it ("spawn npx ENOENT"), open AgentLink and connect the app again from [AI apps](https://wiki.4thtech.io/products/agentlink/local-app/ai-apps.md), or run `npx -y @4thtech-io/agentlink@latest init` once more. It shows the exact change before it writes anything.

If your home folder already has a folder named `agentlink` in another letter case (for example `Agentlink`), setup now uses that folder under its own name instead of stopping at "Confirm it's you". This also applies on a Mac, which ignores letter case by default.

## Windows security prompts

* **SmartScreen.** Windows may say "Windows protected your PC" when you open a downloaded file. That is not specific to AgentLink: it appears for any file that few people have downloaded yet. Check the file against `SHA256SUMS` on the release page (`certutil -hashfile <file> SHA256`), then choose **More info** and **Run anyway** only if the fingerprint matches.
* **Smart App Control** (some Windows 11 computers) blocks apps that are not signed, with no way to allow them. The early Windows app is not signed yet, so where Smart App Control is on, use the command above. Do not turn Smart App Control off for AgentLink.
* **The `.mcpb` download is not signed with a certificate Windows knows.** 4thTech signs it with its own beta certificate, so Windows and Claude Desktop can warn. The one-click download for Claude Desktop is optional; the command line works without it. See [Claude Desktop](https://wiki.4thtech.io/products/agentlink/get-started/claude-desktop.md).
* **Windows Hello.** Since 0.5.5 you never need a passkey or a USB security key to set up. First run gives you a **master code** (shown once; save it), and Windows Hello is the optional extra: in the Windows app, **Turn on Windows Hello** (Settings › **Windows Hello & master code**) asks for your master code once, then the Windows Hello prompt opens in front of AgentLink. In a browser, **Use Windows Hello instead** appears only where the browser says it works. **No Windows Hello PIN?** AgentLink says so and uses your master code. To set Hello up: open Windows **Settings**, then **Accounts**, then **Sign-in options**, set up a **PIN (Windows Hello)**, and come back. A PC without the security chip Windows Hello needs keeps using the master code. See [Protect your approvals](https://wiki.4thtech.io/products/agentlink/protect-your-approvals.md).

## Start in the browser, move to the app later

The browser app and the Windows app share the same IDs, contacts and AI apps. Start with the one command, install the app later and open it: it continues with no new setup, and the browser window says "AgentLink moved to the AgentLink app." See [One AgentLink, browser or app](https://wiki.4thtech.io/products/agentlink/desktop-app.md#one-agentlink-browser-or-app).

## If something does not work

If the Windows app does not open, `core.log` in `%LOCALAPPDATA%\AgentLink\logs` says why (a fixed reason and error code only, never keys or message content).

Run `npx -y @4thtech-io/agentlink@latest doctor` in PowerShell. It shows what is set up, why AgentLink last closed, whether anything was left behind, and how to fix the rest.
