BetaUse sample details. They're sealed so we can't read them, but may not be kept. Keep your original files.

Hesimesi

Help

How to use your vault

Written for someone who has never used anything like this. Start at the top, or jump to whatever you are trying to do.

What this is

A place to keep things that must not be read by anyone else — including us.

You put a file or a piece of information in, and it is locked before it leaves your device. What arrives on our servers is sealed, apart from the names you give things, which stay readable. We cannot open the sealed part, and neither can anyone who takes our servers. The one exception is a file you lock only to a date: once that date passes, anyone who holds it, us included, can open it.

That is the whole idea. Most services promise they will not look. This one is built so that looking is not possible.

The trade is that you hold the key. There is no 'forgot my password' link that quietly unlocks everything, because such a link would mean we could unlock it too.

You do not need to understand encryption to use this. You need to keep one passphrase safe — everything else is ordinary buttons.

Your vault passphrase

The one thing only you know. It never leaves your device.

Your account password gets you into the website. Your vault passphrase is different: it is what actually unlocks your things, and it is never sent to us. Not when you set it, not when you use it.

Because we never receive it, we cannot reset it, look it up, or recover it for you. If it is lost, what it protects is lost with it.

That sounds frightening until you see the other side of it: nobody can be tricked, pressured, or hacked into handing over something they do not have.

  1. Choose something long rather than complicated — four unrelated words beat one word with symbols in it.
  2. Write it down and keep it somewhere physically safe, or store it in a password manager.
  3. When you first set up My details, turn on “Set up recovery for these fields”, so a lost passphrase is not the end of the story.

Worried about losing it? That is the right worry, and recovery is the answer to it. Turn it on when you first set up My details.

Recovery — what happens if you forget

Split a spare key between people you trust, so no single one of them can use it.

Recovery lets you break a spare key into several pieces and give them to people you trust. A piece on its own is useless. Only when enough of them are brought back together does the key exist again.

You choose how many pieces there are and how many are needed. Three of five is a common choice: any three of your five trustees can help you back in, and any two of them working together still cannot get in on their own.

This is the answer to the obvious problem with holding your own key. Set it up while you still remember your passphrase, not after.

  1. For your saved details: turn on “Set up recovery for these fields” when you first set up My details.
  2. For a locked file: turn on “Set up recovery” when you lock it.
  3. Decide how many people will hold a piece, and how many are needed to restore.
  4. Send each person their piece.
  5. Tell them what it is for. A piece nobody understands is a piece nobody keeps.

Your trustees never see what is in your vault. They hold a fragment of a key, not a copy of your things.

Open this screen

Locking a file

Pick a file, it is locked on your device, and if you save it here, the sealed result is uploaded with its name.

The locking happens in your browser, before anything is sent. If you watch your network connection while it uploads, you will see the sealed version going out with the file's name beside it, and nothing else. The name is stored readable, so choose one that gives nothing away.

While it is stored here, you can unlock it on any device you can sign in from, with its box key. During the beta, what is stored may not be kept, so keep your own copy.

  1. Open Files and choose a file.
  2. Choose a box key and seal it.
  3. Press “Save to my vault” to store the sealed file, and download a copy to keep yourself. The original never left your device.
Open this screen

Documents and fields

A record, like a passport, built from separate pieces that can be used one at a time.

A document is a record you would otherwise keep on paper — a passport, a bank account, an ID card. Instead of one blob, it is made of named fields: 'passport number', 'expiry date', and so on.

The point of splitting it up is that something can be given one field without being given the rest. An assistant filling in a form needs the passport number and has no reason to see anything else.

Every field is sealed on your device, one at a time, the same way a file is.

  1. Open Documents and create one — give it a name you will recognise.
  2. Add a field for each piece of information.
  3. Enter each value with your passphrase to seal it.
  4. Set how each field may be used: freely, only after you approve, or never.

Adding a field does not make it reachable by anything. Nothing can use a field until you say so.

Open this screen

The browser add-on

Fills your saved values into web forms, without the page ever seeing them typed.

The add-on is what puts a value into a form for you. It runs on your own computer, which is why you install it yourself rather than us running it somewhere.

It asks for your passphrase when you unlock it, then keeps your values available while you work. It locks itself again after an hour without use, twelve hours after you unlocked it at the latest, when your screen locks, or when you close your browser — that is deliberate, so a machine left unattended is not a machine left unlocked.

  1. Download it from the Downloads page and follow the installation guide.
  2. Sign in to this site in the same browser.
  3. Open the add-on and enter your vault passphrase.
  4. Open a site you want to fill on, then open the add-on and press its 'Enable on …' button. Your browser asks you to confirm, for that one site.
  5. On a site you enabled, click into a form field — a small icon appears, and you choose what to fill.

When you pick a value yourself, it fills at once unless the field is set to Never. When an agent asks for a fill, your fill policies decide, and where none applies the field's access rule does: Allow fills without asking, Ask me waits for your approval.

Assistants and automations

Give an AI assistant a key of its own — one that can ask to use things but is never handed them.

If you use an AI assistant or an automation tool, you can let it work with your vault. It gets a key of its own, so you can take that key away later without disturbing anything else.

What it can see is deliberately thin: the labels of your things. It knows there is a field called 'passport number'. It does not know what the number is, and there is no request it can make that returns one to it.

When it needs a value used, it asks. Depending on your settings, either you approve it or a rule you wrote beforehand approves it, and a field set to Allow does not ask at all. No answer it gets ever contains the value. A browser fill is the one case to watch: the value lands in a page, and an assistant that drives that browser could read it.

  1. Open Agents and create a key.
  2. Copy the key into your assistant's settings, or send it as a bearer token over plain HTTP, as the “Connect your agent” page shows. It is shown once.
  3. Give it only the permissions it needs.

You can revoke a key at any moment. What it did is written to your activity log as it happens, though a refused request, or a rare failure, leaves no entry.

Open this screen

Approvals

Where you say yes or no when something asks to use one of your values.

When an assistant asks for something that needs your permission, it appears here. You see what was asked for, by which key, and where it would go.

Nothing happens until you decide. If you never look, nothing is released.

There is no way for a request to approve itself, and no timeout that counts silence as a yes.

Open this screen

Destinations

The short list of places a value is ever allowed to go.

A destination is somewhere you have decided a value may be sent. Today that means a web address, belonging to you or to a company you deal with. A page's form field or an upload target can be added too, but nothing is delivered to them yet.

This exists so that an assistant cannot invent a place to send something. It can only choose from the list you built. If it is not on your list, it cannot be a destination, however the request is phrased.

  1. Open Destinations and add the address.
  2. Verify it. For a web address, that proves control: the address has to send back a code we send it. For the other kinds, verifying is only your own word.

Nothing is ever sent to an unverified destination: not automatically, and not even when you approve the request yourself.

Open this screen

The helper you run yourself

The only part that unlocks values for delivery — and it runs on your machine, not ours.

When a value is released to a destination, something has to unlock it first. That something is a small program you run on your own computer, called the sidecar.

It matters that it is yours. Our servers hand out only the sealed version; your machine turns it back into a value and sends it onward. So even at the moment a secret is being used, it is not on our side of the line.

If it is not running, nothing is delivered. That is not a fault — it is the guarantee working.

  1. Download it from the Downloads page for your computer.
  2. Enrol it here, which gives you two secrets shown once.
  3. Run it, and leave it running while you expect deliveries.
Open this screen

Opening a file without us

A small program you keep, that opens your sealed files with no account and no internet, except time-locked ones.

A file you lock with a passphrase can also be opened by a command-line tool you download once and keep, with that passphrase or, if you set up recovery, with enough recovery shares. It needs no account, no internet connection, and no server of ours to be running. It is the same engine your browser uses, built as a standalone program. Time-locked files are the exception: the tool cannot open them, and they open in the browser once their date arrives, which needs an internet connection.

This is the answer to the fair question: what happens to my files if this company stops existing? Keep a copy of the tool alongside your sealed files, and the answer is nothing happens to them — they still open, with your passphrase, on your own machine.

It is published under the Apache 2.0 licence, which matters more than it sounds: it means the right to keep and run it is yours permanently and cannot be withdrawn. A promise about a tool you can keep is only true if you are actually allowed to keep it.

  1. Download the version for your computer from the downloads page.
  2. Keep it wherever you keep the files it protects — an external drive is a good choice.
  3. To check a file without opening it: secretbox inspect yourfile.rbx
  4. To open it: secretbox decrypt yourfile.rbx --pass "your passphrase"

Worth testing once, now, while everything works — seal something small, open it with the tool, and you will know the escape hatch is real rather than a sentence on a website.

Activity

What happened, in order, each entry linked to the one before it.

Meaningful actions are written down as they happen: what was asked, what you decided, what was delivered. Each entry is linked to the one before it, so a careless edit shows. A refused request, or a rare failure, leaves no entry.

It is the answer to 'how do I know what that assistant actually did'. During the beta the list is not yet protected against someone who can write to our database, and we can't promise to keep it, so treat it as a record rather than proof.

Open this screen

Still stuck?

If something here is unclear, that is our fault and we would like to know. Write to support@hesimesi.com and we will fix the wording. Bugs and questions go there too. Security issues go to security@hesimesi.com.