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

# Approve with Touch ID or your master code

*"Use your master code instead" is on every confirm since 0.4.14; since 0.5.4 each confirmation is one press, on a compact card (see* [*Approvals in the app*](https://wiki.4thtech.io/products/agentlink/local-app/approvals.md)*).*

**Goal:** know what your AI must ask you about, and how you say yes or no. Your AI can ask; only you can approve.

## What needs you

| Action                                                      | Who starts it                    | You confirm with        |
| ----------------------------------------------------------- | -------------------------------- | ----------------------- |
| Creating an ID and connecting an AI app                     | You, in Get started              | Touch ID                |
| Accepting an invite                                         | You                              | Touch ID or master code |
| Naming or renaming a contact, blocking or removing one      | You, on **People**               | Touch ID or master code |
| Renaming, resuming or removing an ID; saving a recovery kit | You, on **IDs** or **Settings**  | Touch ID or master code |
| Accepting terms, sending a firm offer                       | Your AI asks                     | Touch ID or master code |
| A proof or a spend above your rules                         | Your AI asks                     | Touch ID or master code |
| Creating an invite, keeping a contact your AI connected     | You, on **People**               | Touch ID or master code |
| Saving or changing your rules                               | You, in **Settings** › **Rules** | Touch ID or master code |

Your **rules** set what your AI may do on its own, for example whether a proof needs approval and how much it may spend per day. Your AI cannot change your rules, and no tool it has can approve anything. Above your hard spending limits nothing is asked: the proof is refused (see [Rules](https://wiki.4thtech.io/products/agentlink/local-app/rules.md)).

```mermaid
flowchart LR
  A["Your AI asks"] --> C["Card on Home<br/>in the AgentLink app"]
  C --> D{"You"}
  D -- "Approve: Touch ID<br/>or master code" --> E["Your AI carries on"]
  D -- "Deny" --> F["Nothing happens"]
  A -. "cannot approve itself" .-x E
```

## Steps

1. Your AI says something needs your approval and shows a link, or the card simply appears at the top of [Home](https://wiki.4thtech.io/products/agentlink/local-app/home.md). It says who, what and any cost, and shows the full message as AgentLink decoded it, with a **Check code** you can compare with the other side. A long message is folded: press **Show all** before you can approve.
2. Read it, then press **Approve with Touch ID** or **Deny with Touch ID** (**Windows Hello** on Windows). That one press asks your computer for your fingerprint, face or PIN. On a Mac the Touch ID prompt names who and the cost ("for Ana, $0.10"); the Windows Hello prompt has fixed text, so check the card.
3. Or press **Use your master code instead**, then **Approve** or **Deny**, and type your master code.

<figure><img src="https://3688459944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjy5DevDUBRwNkiXddc0%2Fuploads%2Fgit-blob-b00866a980709d9cbe6b76a5af385a5bf59322cb%2Fconfirm-presence.webp?alt=media" alt="A confirm box: Confirm it&#x27;s you. Never give your master code to your AI. Buttons Confirm with Touch ID, Use your master code instead and Cancel."><figcaption><p>The same confirm box everywhere: Touch ID, or your master code.</p></figcaption></figure>

While the app is open, your AI waits briefly for your decision; you don't need to tell it "done". When several wait, Home shows the first and **+2 more**. With **Under the hood** on, several free requests can be approved together; anything that costs money is approved one at a time.

## Your master code

Your **master code** is shown once when you set up. Keep it in your password manager. Use it when Touch ID or Windows Hello isn't available, or in another browser. Type it only into the AgentLink app or your own terminal, never into a chat, and never give it to your AI. See [Master code and recovery kit](https://wiki.4thtech.io/products/agentlink/first-run.md).

## In a terminal

Prefer the terminal? In a terminal you opened yourself (not one your AI runs):

* `agentlink approve <approval ID>` shows the request, with the message, its length and check codes (a very long message is cut there; the app shows all of it); check it and type your master code.
* `agentlink approve` with no number lists what waits; `agentlink deny <approval ID>` says no; `agentlink cancel <approval ID>` withdraws a request.
* `agentlink policy show` lists your rules.

## If it does not work

* **The app didn't open:** run `agentlink` in a terminal, or use `agentlink approve`.
* **Touch ID isn't offered:** use **Use your master code instead**. To turn Touch ID on later, see [Protect your approvals](https://wiki.4thtech.io/products/agentlink/protect-your-approvals.md).
* More in [Troubleshooting](https://wiki.4thtech.io/products/agentlink/troubleshooting.md).
