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

# Your master code and recovery kit

*Saving a recovery kit in the app is new in 0.4.14; one kit for all your IDs, the save checklist and restoring in the app are new in 0.5.0. The words "backup code" and "owner code" became **master code** in 0.4.14; it is the same code.*

Two things keep you in charge of your IDs when your fingerprint reader or your computer is not there: your **master code** and your **recovery kit**.

|                  | Master code                                                                                            | Recovery kit                                                                   |
| ---------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| What it is       | A code that confirms approvals instead of Touch ID                                                     | One locked file with all your IDs, your people and your messages               |
| When you get it  | Once, during [Get started](https://wiki.4thtech.io/products/agentlink/local-app/get-started-wizard.md) | When you press **Save recovery kit**                                           |
| Where to keep it | Your password manager                                                                                  | Somewhere safe, apart from its recovery code                                   |
| Use it for       | **Use your master code instead**, on any confirm                                                       | Getting your IDs back on a new computer or this one: **I have a recovery kit** |
| Never            | Give it to your AI or paste it into a chat                                                             | Share it with anyone                                                           |

## First run on any computer

Since 0.5.5, first run works the same on a Mac, a Windows PC and in any browser (Firefox too), in the desktop app or in the browser app. You never need a passkey, a security key or a terminal.

1. Pick your AI app, then type the name people see. The button says **Continue with a master code** (or **Use Touch ID** / **Use Windows Hello** where your browser says they work here).
2. AgentLink shows your **master code** once. Save it, then press **I saved it**.
3. In the desktop app, AgentLink then offers Touch ID (on a Mac) or Windows Hello (on Windows) for approvals. You can choose **Not now**: your master code works until you turn it on. In a browser, Touch ID, Windows Hello or a passkey is offered only where the browser says it works here. On Windows the master code always comes first, and **Use Windows Hello instead** is the alternative.
4. Connect your AI app, then **Go to Home**.

**Use your master code instead** makes no passkey request at all, so Windows never asks you to "Insert your security key". **Skip to Home** is not offered until your first ID exists, so you can't end up on a Home that does not work yet.

The same page for each step is in [Get started](https://wiki.4thtech.io/products/agentlink/local-app/get-started-wizard.md).

## Your master code

The master code is shown once, when your first ID is created.

<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: Approvals on this computer are protected. The code in groups of four, Shown once, Hide, Save in my password manager, Copy, Save as file and I saved it."><figcaption><p>Shown once. Save it before you press I saved it.</p></figcaption></figure>

If you reload the page before you press **I saved it**, you see the same code again, not a new one. The app keeps it in its memory for this window only, for at most 10 minutes, and never writes it to disk. If the app was closed before you saved it, it says **Your master code wasn't saved** and offers a new one with Touch ID (or your passkey), instead of asking for a code you never saw. Leaving the screen with **Skip to Home** or **Cancel** asks first, because the code is shown once.

1. Press **Save in my password manager**, **Copy** (it says **Copied**) or **Save as file**. **Hide** covers it if someone is looking.
2. Press **I saved it**.

Every place that asks for Touch ID also offers **Use your master code instead**. Fields accept a pasted code even with line breaks, spaces or long dashes. Nobody can get your master code back for you, not even 4thTech. To test it or replace it, open **Settings** › [**Touch ID & master code**](https://wiki.4thtech.io/products/agentlink/local-app/touch-id-and-master-code.md).

## Your recovery kit

A recovery kit holds your IDs, their contacts and their messages, locked under a new **recovery code** that is shown once. It is everything you need to get AgentLink back on any computer; keep the file and the code safe, and apart.

1. Open **Settings** › **Backup & restore** (an ID's **Back up** leads there too).
2. Press **Save a recovery kit** and confirm with Touch ID or your master code. One kit covers all your IDs.
3. The kit is saved to your Downloads folder (or your home folder when there is none). A checklist follows: move the file off this computer (**Show in Finder**), write down the recovery code shown once (**Print** or **Copy**), and check that it opens (**Check now**). **Done** turns on when all three are ticked.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-344974c7e04bb3c0ac1c8b92783041a7b6ea3943%2Fbackup-restore.webp?alt=media" alt="Settings, Backup and restore: Your kit is out of date, it covers Ana, not yet Studio and Work, with Save a new kit. Three columns: the kit file with Show in Finder, the recovery code, and getting back in with Check that my kit opens. Below: what comes back from a kit, what to set up again afterwards, Restore from a kit and Moving to a new computer."><figcaption><p>Settings › Backup &#x26; restore.</p></figcaption></figure>

Until you check that the kit opens, Backup & restore says **Your last kit isn't finished**. The full page, and how to restore, is in [Backup & restore](https://wiki.4thtech.io/products/agentlink/backup-and-restore.md).

Nothing is sent anywhere. To restore, choose **I have a recovery kit** when you set up AgentLink on the new computer, or **Restore…** in **Settings** › **Backup & restore**.

## If you set up before 0.3.0

If you set up AgentLink in the terminal before the app existed, your approvals use a code. The app offers **Switch to Touch ID** (**Switch to Windows Hello** or **Switch to a passkey** elsewhere): press it, type your master code once (the code `owner init` printed), touch the sensor, and the page says **Touch ID is on**. Your master code keeps working when the sensor isn't available.

## If your browser has no passkey

Nothing breaks. First run makes your master code in the app, with no passkey request. See [Protect your approvals](https://wiki.4thtech.io/products/agentlink/protect-your-approvals.md).

## If you forgot your master code

Choose **Forgot your master code?** under any master code field. AgentLink first offers **Restore from recovery kit**, so you keep your IDs, people and history. Only if you have no kit do you start over: see [Start over on this computer](https://wiki.4thtech.io/products/agentlink/local-app/touch-id-and-master-code.md#start-over-on-this-computer).

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

See [One AgentLink, browser or app](https://wiki.4thtech.io/products/agentlink/desktop-app.md#one-agentlink-browser-or-app).

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