Esta página aún no está traducida.

Sealed workspaces

This page is for organization admins who keep sensitive instructions, and for the people who work in a sealed workspace. A sealed workspace keeps its instructions encrypted, so that only the people and agents you give its key to can read them. instruction.md stores them and delivers them, every version included, but can't read them.

Plans On Team and Enterprise

In plain words

Each person who works in a sealed workspace has an encryption key of their own. It is made in their browser, and instruction.md never sees it. The workspace has a key too. An admin gives the workspace's key to each person, locked so that only that person's own key opens it.

When you write in a sealed workspace, your browser locks the text before it leaves your computer. When you open an instruction there, your browser unlocks it. In between, instruction.md only ever holds the locked text.

instruction.md stores sealed text locked; only people and agents with the key read it.

What instruction.md still sees

instruction.md never sees the text of a sealed instruction, its drafts or its versions. It still sees what it needs to store and deliver them:

  • each instruction's name and title, its description and its tags
  • the note you write when you publish a version
  • who reads it and changes it, and when
  • how many versions it has, and roughly how long each one is
  • which agents follow it
  • who holds the workspace's key

What doesn't work on sealed instructions

Some things only instruction.md's own computers can do, and they can't read sealed text. These don't work on sealed instructions:

  • The assistant. It runs on instruction.md's servers, so it can't read them.
  • Everyone. A sealed instruction can't be shared with Everyone, so it has no public page and isn't in Explore.
  • Read links. A read link can't open a sealed version.
  • The server's checks. Your editor checks the text instead, once it is open.
  • Searching inside them. Search finds them by their name, title, description and tags, never by their text.
  • Publishing later. A sealed instruction is published at once. The editor says A sealed instruction can't be released later yet. Release it now instead.
  • Copies to other places. A sealed instruction can't be forked, and it can't move to another workspace yet.
  • Sealing what you have. Only an empty workspace can be sealed. Instructions you already have can't be moved into it yet.
  • Writing together. One person edits a sealed draft at a time. See When two people edit at once.

Before you start

  • Plan: sealed workspaces are on the plans shown above. They don't count toward your plan's workspace limit. See Plans, limits and billing.
  • Who seals a workspace: the organization's owners and admins.
  • Who gives the key: anyone who already holds the workspace's key.
  • What everyone needs: their own encryption key, set up once. See the next section.

Set up your encryption key

Everyone who works in a sealed workspace needs their own key, including the admin who seals it.

  1. Open Your account ▸ Security

    Under Encryption key, it says No encryption key yet.

  2. Choose Set up

    The editor asks How do you want to unlock your key? Pick one now. You can add more later.

    • Use a passkey: your fingerprint, face or device PIN.
    • Use a security key: a YubiKey or another security key, with a touch.
    • Use a passphrase: a long phrase only you know, at least 12 characters. It unlocks your key on any device.
  3. Save your recovery key

    The editor shows your recovery key, once. Choose Copy and keep it somewhere safe, such as a password manager. If you lose every other way to unlock, it is the only way back to your sealed instructions.

  4. Tick I saved my recovery key, then choose Finish

    The editor says Your encryption key is ready. The section now shows your ways to unlock, and your key's Fingerprint.

Set up your encryption key in Your account ▸ Security.

Add another way to unlock

Two or more ways keep you from losing your key. Under Add another way to unlock, choose Passkey, Security key, Passphrase or This device. This device lets this browser unlock your key with one press, without a passkey or a passphrase. Remove a way you no longer use with Remove. The last one, and the recovery key, can't be removed.

Unlock your key

Your key starts locked each time you open the editor. When you open a sealed instruction, the editor asks you to Unlock your encryption key. Under Ways to unlock, choose one, such as Use this device, then Unlock.

The editor asks you to unlock your key before it opens a sealed instruction.

Your key stays in this tab's memory only. It locks after 30 minutes away, or when you close the tab. To lock it sooner, choose Lock now in Your account ▸ Security, or Lock encryption key in the command palette.

A sealed instruction shows a Sealed mark next to its name. Press it to see your key.

Seal a workspace

Who can do this: the organization's owners and admins, once they have set up their own key.

  1. Make a new workspace

    In Settings ▸ Workspaces, add a workspace under New workspace. See Organizations and workspaces. Only an empty workspace can be sealed.

  2. Choose Seal workspace

    It is in the workspace's Seal this workspace row. The editor asks you to unlock your key first, if it is locked.

  3. Confirm

    The editor asks Seal …? and says what changes. Choose Seal workspace. It says … is sealed. The workspace's row now says Workspace key, with a Sealed mark and how many people have the key.

Give the key to people who join

Giving someone a role in a sealed workspace isn't enough. They also need its key.

  1. They set up their own key

    The person sets up their key in Your account ▸ Security. Until they have the workspace's key, a sealed instruction tells them You don't have this workspace's key yet.

  2. Find them in Settings ▸ Workspaces

    Under the sealed workspace, a row says how many people are waiting for the key. Each person shows with their key's fingerprint, a long code of letters and numbers.

  3. Compare the fingerprint

    Ask the person to read you the Fingerprint they see in Your account ▸ Security, in person or on a call. It must match the one shown next to their name. This makes sure the key is theirs and not someone else's.

  4. Choose Give the key

    The editor asks Give the key to …? and shows the fingerprint again. Choose Give the key. It says … can now open this workspace's sealed instructions.

Compare the fingerprint, then give the key.

A row may also say that some people haven't set up a key. They can't be given one until they do.

Rotate the key

Rotate the key when someone leaves, or on a schedule you choose. Rotating makes a new workspace key, on your device, and gives it to everyone who keeps reading. New versions use the new key. Earlier versions keep the key they were locked with.

Who can do this: the organization's owners and admins who hold the workspace's key.

In Settings ▸ Workspaces, choose Rotate key in the workspace's Workspace key row. The editor asks Rotate the key of …? Choose Rotate key. It says … has a new key.

Someone you gave the key to can keep what they read while they had it. Rotating protects what comes after.

When two people edit at once

A sealed draft is saved whole each time you change it. If someone else saved it while you were editing, the editor says Someone else saved this sealed instruction while you were editing. Your next change replaces theirs.

  • To keep your text, carry on. Your next change replaces theirs.
  • To see theirs instead, choose Load theirs. Your unsaved change is replaced by their text.

Agree who edits a sealed instruction at a time, so nobody's change is lost.

Lost your key

If you lose a passkey or a device, unlock with another way, then remove the lost one and add a new one.

If you lose every way to unlock, use your recovery key. The unlock prompt offers Lost your passkeys? Use your recovery key or Forgot your passphrase? Use your recovery key.

If you have lost your recovery key too, nobody can get your key back: not an admin, and not instruction.md. What only your key could open stays locked. Keep your recovery key somewhere you won't lose it, and add a second way to unlock.

AI apps and agents

AI apps and agents read sealed instructions through a program your company runs, which holds a key of its own. instruction.md still decides who may read what. Your developers or IT team set this up: see Sealed instructions.

If it doesn't work

You see What to do
Sealed workspaces are on Team and Enterprise. Upgrade in Settings ▸ Billing. See Plans, limits and billing.
It has … instructions. Only an empty workspace can be sealed. Make a new, empty workspace and seal that.
You don't have this workspace's key yet. Set up your key, then ask someone who holds it to give it to you.
Unlock your encryption key first. Unlock your key, then try again.
That didn't unlock your key. Check what you entered and try again. Check your passphrase or recovery key, or use another way.
This browser no longer keeps its key. Use another way to unlock. Use a passkey, a passphrase or your recovery key, then add This device again.
There's no way to unlock your key in this browser. Use your recovery key, or set up another way on a device you have used before.
Still stuck Write to us.

Questions

What is a sealed workspace?

A workspace whose instructions are encrypted on its people's devices. Only the people and agents given its key can read them. See In plain words.

Can instruction.md read my sealed instructions?

No. instruction.md stores only the locked text. It still sees names and titles, who changes what and when, sizes and which agents follow them. See What instruction.md still sees.

What if I lose my key?

Unlock with another way, or with your recovery key. If you have lost all of them, nobody can recover your key, not even instruction.md. See Lost your key.

Can I seal a workspace that already has instructions?

Not yet. Only an empty workspace can be sealed, and instructions can't be moved into it yet. Make a new workspace for sealed instructions.

Does a sealed workspace count toward my plan's workspaces?

No. Sealed workspaces don't count toward the workspace limit. Which plans include them is shown at the top of this page.

For developers: how agents and AI apps read sealed instructions, and how to run your company's own key service, are in Sealed instructions.

Last checked against the product:

Was this page helpful? Report a problem