How-to

Connect your agent to Ledger Lite

Your agent — the AI assistant you talk to day to day — can file things into Ledger Lite and read them back for you. This guide connects the two. It takes about ten minutes, and you stay in charge the whole way: nothing can reach your Ledger Lite data until you hand out a key, and you can take that key back whenever you like.

One thing before you start: the agent connects to your phone over Tailscale, a free app that links your own devices into a private network nobody else can join. If Tailscale is not set up yet, do that first — it is quick: Set up Tailscale.

  1. 1 Open "Connect your agent" in Ledger Lite. You will find it on the app's Home screen, at the top of Settings, and in the Vault. The first screen explains the idea in one line: your agent connects to this phone over your private Tailscale network.
  2. 2 Make sure both devices are on Tailscale. Tailscale needs to be installed and signed in — with the same account — on this phone and on the machine your agent runs on. The app checks and walks you through it if something is missing.
  3. 3 Name your agent. One short name, using lowercase letters, numbers, and dashes — for example home-assistant. The name is how you will recognize this agent later, in the app and in the Vault's access log.
  4. 4 Choose what it may do. Four separate switches, in plain words: read your records (already on — most agents need at least this); add, change, and delete records; read chosen Vault secrets; and create or replace chosen Vault secrets. Be aware that reading and writing cover your Ledger Lite data broadly — expenses, notes, forms, health — not just one corner of it. Turn on only what your agent actually needs.
  5. 5 Pick Vault secrets, if it needs any. This step only appears if you allowed secret access. Tick the secrets the agent may use, or type the exact name of a secret it will create later. If a switch elsewhere in the app would block what you picked, the app tells you here rather than letting the setup fail quietly later.
  6. 6 Check the summary, then confirm it is you. The app shows the agent's name, its permissions, and its secrets one more time. Keys expire after 90 days unless you change the date or choose no expiry. Confirm with your phone's fingerprint, face, or PIN — nobody can hand out a key without passing that check.
  7. 7 Hand the agent its address and key. The app shows two things: the address, which looks like http://100.x.x.x:8080/api/v1 (that is your phone's address on your private Tailscale network), and the agent's own key. There are separate copy buttons for the address, for plain-English setup instructions you can paste to your agent, and for the key itself. The key is shown once — if you lose it, you simply make a new one.
  8. 8 Turn agent access on, and let it keep running. Start access from the app and leave it running — you will see a small ongoing notification while it is on, with a Stop button. On Android, if the phone asks whether Ledger Lite may keep working in the background, say yes: that is what lets your agent reach the phone while the app is closed. On iPhone there is no ongoing notification — agent access runs while the app is open, so keep it open while your agent works. Your phone and Tailscale both need to stay on and reachable.
  9. 9 Test it from your agent. Ask your agent to introduce itself to the phone and read something harmless, like your expense categories. A working connection answers with the agent's name and your real category list. One honest exception: a key that can only write, or only fetch secrets, cannot run this test — that is on purpose, and the app says so.
  10. 10 Connected. The app now shows when your agent last reached the phone. From here you manage everything in one place: pause access, change what an agent may do, or replace a lost or expired key. Nothing about this is permanent — every grant can be undone.
One direction only. This guide points your agent at the app — Ledger Lite has no AI of its own and does not connect outward to AI servers. Your agent does the thinking; the app keeps the records. (The connection itself is described in the "Your data, open to your agents" section on the home page.)

← Back to Ledger Lite