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

# Get started

*Before your first ID exists there is no **Skip to Home**. Since 0.5.6 every step shows **Check for updates** and **Help** as a way out, see* [*Updates*](https://wiki.4thtech.io/products/agentlink/local-app/updates.md)*. Since 0.5.5 there are five steps, with a Files step, and no passkey is needed.*

Get started is a short guided path: pick your AI app, create your ID with your master code (Touch ID or Windows Hello is optional), see that you are connected, check your Files, then invite someone if you like. Step by step with every screen: [Connect your AI app](https://wiki.4thtech.io/products/agentlink/get-started.md).

<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? with tiles for the AI apps on this computer."><figcaption><p>Step 1 of 5.</p></figcaption></figure>

## When it opens

It opens by itself only until you are set up, which means you have an ID with an AI app connected. After that the app opens on [Home](https://wiki.4thtech.io/products/agentlink/local-app/home.md). Get started is always available from:

* the **?** Help menu,
* **Go to** (Cmd+K),
* a card on Home, **Get started · n of 3 done**, until you hide it.

Each step shows where you are, for example **Step 2 of 5 · Connect**. **Skip to Home** leaves once your first ID exists; before that it is not offered, and a Home without an ID offers **Create your first ID** in the app. Leaving the once-shown master code (**Skip to Home**, or **Cancel** after a restore) asks first. **Enter** confirms your name on the first screen. The Get started card follows what really happened: a person who accepted shows as done, on any ID, and stays done. Get started no longer opens on every launch once you have an ID.

## The steps

1. **Pick your AI app.** AgentLink looks in the usual places on your computer for the AI apps it can connect to. Pick yours, or choose **I'll choose later**. Nothing is written yet.
2. **Confirm it is you.** Type the name people see, then press the button: **Continue with a master code** (always works, no passkey), or **Connect with Touch ID** / **Connect with Windows Hello** where your browser or the app says it works here. Under the name, **Your AI may send files from \~/AgentLink/Send** shows the folder your AI may send from (a Change link picks another). One confirmation does three things together: it creates your ID, protects your approvals, and adds AgentLink to the AI app you picked. With the master code, AgentLink then shows it once: save it and press **I saved it** (see [Your master code and recovery kit](https://wiki.4thtech.io/products/agentlink/first-run.md)). When it is done, it says "{label} is ready in {app}. Restart {app} to finish." AgentLink never restarts the app for you. Untick **Connect to {app}** (or choose **Not now**) to connect later from [AI apps](https://wiki.4thtech.io/products/agentlink/local-app/ai-apps.md). If the app's settings can't be written, your AI is still ready and the app offers **Connect**. If you cannot use Touch ID, a link offers your master code instead.
3. **Connected to {app}.** The page confirms the connection. Press **Continue**.
4. **Files** (new in 0.5.5), titled **Sending and receiving files**. It shows your Send folder (**Allowed**, **Not allowed** or **Not found**) and your Inbox, each with **Show in Finder** (**Show in Explorer** on Windows), and a short tip for the AI app you picked. **Add folder…** (called **Choose another folder** before 0.5.8) asks for your master code in the desktop app. **Skip for now** and **Continue** change nothing: the Send folder allowed when you connected stays allowed. Connecting another AI app later has four steps, without Files.
5. **Invite someone.** Make your invite link right there, or skip it. See [Invite someone](https://wiki.4thtech.io/products/agentlink/invite-someone.md).

## Adding another ID

From the ID menu or **IDs**, adding an ID uses the same steps in this order: its **name**, which **AI app** it works in, then one confirmation (Touch ID, Windows Hello or your master code), then Files. When it is done you can open the new ID. See [IDs](https://wiki.4thtech.io/products/agentlink/ids.md).

## Connecting another AI app

Connecting an AI app to an ID later uses the same steps. You can also do it from [AI apps](https://wiki.4thtech.io/products/agentlink/local-app/ai-apps.md).

Back to [The local app](https://wiki.4thtech.io/products/agentlink/local-app.md).
