Цю сторінку ще не перекладено.

Share an instruction

This page is for anyone who keeps an instruction and wants other people to read it or work on it. You will choose who can read its versions, give people a role, and answer requests for access.

Share: add people, choose their roles, and choose who can read its versions.

Before you start

  • You need an account and an instruction that is kept in your workspace. Something written in the editor without an account is shared another way: see Write without an account.
  • Who can do this: an Admin of the instruction changes who has access. The organization's owners and admins are Admins of every instruction in it. A Maintainer can make read links, but can't add people. A Contributor or a Maintainer who opens Share sees "Only its admins change who has access to it." Someone who can only read it sees Request access in the header instead of Share.
  • People you add need an instruction.md account already. Someone new joins your organization first: see Invite people and choose their roles.

Who can read it

Who can read an instruction is called its visibility. It applies to its published versions. You choose it when you publish the first version, and you can change it at any time.

The editor shows the three choices in two places, in slightly different words:

When you publish the first version In Share, under General access Who can read its versions
Only you Only people with access You, the people and agents you add, and the workspace's people when you let them in
Your organization Everyone in the organization Every member of your organization. Guests of the organization can't, unless you add them
Everyone Everyone, on instruction.md Anyone, signed in or not. It is listed in Explore and can be found in search

Whatever you choose, the draft, its suggestions and its comments stay with the people who work on it. Making an instruction public shows its versions, never its draft. If nothing is published yet, people see it once the first version is.

An instruction in a sealed workspace can never be public. (Sealed workspaces are in beta, not yet independently reviewed. See Sealed workspaces.)

Share it with people

  1. Open Share

    Open the instruction. Press Share in the header, then Share a link…. The Share window opens with the instruction's name in its title.

  2. Add a person

    Type their email address or handle in Add people by email or handle. Choose Their access: Reader, Contributor or Maintainer. Contributor is chosen for you. Press Add.

  3. Confirm

    The editor asks you to confirm, and says what changes, for example "dana@example.com gets Can propose." Press Share. You see "Shared — they're told in their notifications."

The person gets a notification, and the instruction appears in their Shared with me.

What each role may do on this one instruction:

Role What they can do
Reader Read it, and connect their agents to it
Contributor Read the draft, suggest changes and comment. A Maintainer accepts their suggestions
Maintainer Change the draft, accept suggestions, publish versions and make read links
Admin All of that, and change who has access to it

To make someone an Admin, add them first, then change their role in the list. The roles are the same as a workspace's: see Invite people and choose their roles.

To change someone's role, choose another one next to their name under People with access. To take their access away, choose Remove.

Agents your organization gave access to appear in the same list, marked Agent. Their choices are Reads, Suggests, Edits and Publishes. An agent never changes who has access.

Let everyone in the workspace in

Under People with access there is a switch: Let everyone in the workspace in, with the number of people. It is on for a new instruction. Each person then has the role they have in the workspace.

Turn it off to keep an instruction to the people you add by name. The workspace's people then lose their workspace role on it. The organization's owners and admins keep theirs. Turning it on again asks you to confirm first.

Change who can read it

  1. Open Share

    Press Share, then Share a link….

  2. Choose General access

    Under General access, choose Only people with access, Everyone in the organization or Everyone, on instruction.md. The line under it says what your choice means.

  3. Confirm a public instruction

    Choosing Everyone, on instruction.md asks first: "Make … public?" It says that anyone, signed in or not, can read its versions, find it in search and follow it, and that its draft, suggestions and comments stay with the people who work on it. Press Make it public.

Ask for access to someone else's instruction

When you can read an instruction but can't change it, the header shows Request access.

Request access: ask an instruction's maintainers to let you use, edit or maintain it.
  1. Press Request access

    The Request access window opens: "You can read this instruction. Ask its maintainers for more:"

  2. Choose what you need

    • Use: connect your agents to it. They follow its live version.
    • Edit: suggest changes and comment. A maintainer accepts them.
    • Maintain: change it, accept suggestions and publish versions.

    Add a note in Why you need it (optional) if it helps them decide.

  3. Send it

    Press Send request. The button in the header now says Requested. You hear back in your notifications.

What happens next:

  • Approved: the button says Reload to edit. Press it to use your new access.
  • Declined: you can ask again.
  • You can have one request waiting on an instruction at a time.

Don't need their approval? Press Fork instead to make a copy of your own. See Copy an instruction and offer changes back.

Answer a request

The instruction's Maintainers and Admins are told when someone asks. An Admin answers it, in either of two places:

  • Your account ▸ Notifications. The request's row says what they ask for, for example "Asks to suggest". Choose Access to give, then press Approve or Decline. You can give more or less than they asked.
  • Share. Requests appear at the top, under Waiting for access, with Approve and Decline.

They are told your answer either way. A request that someone else answered, or that was withdrawn, says "No longer waiting: answered elsewhere, or withdrawn".

The editor has several links, for different needs:

Link Where What it does
Copy the link Share menu Makes a read link for 30 days and copies it. Anyone with it can read the live version, as it changes, without an account. Only Maintainers and Admins can make one
Copy link Command palette Copies its address in the editor. Only people it is shared with can open it
Copy permalink Command palette Copies a link to the live version as it is now. The text at that link never changes. Only people who can read the instruction can open it
Permanent link Share ▸ Links Its address that keeps working after a rename or a move. Whoever opens it still needs access to read it

The command palette is in Keyboard shortcuts and the command palette.

To give someone a copy as a file, press Share, then Download .md under As a file. You get the text that is in the editor now. To keep a copy with its history, see Download and back up.

Defaults and limits

New instructions. Your organization's admins choose who can read new instructions, in Settings ▸ Security, under Who can read new instructions: Private, Organization or Public. It applies until someone shares them. It starts as Private. See Set your organization's rules.

Private instructions. Each plan keeps a number of instructions that aren't public. "Only you" and "Your organization" both count. Instructions in the trash don't.

Plans Community 3 · Pro 100 · Team 1,000 · Enterprise unlimited

At the limit, you can't make another private one, and you can't make a public one private again. Make one public, delete one, or change your plan. See Plans, limits and billing.

Check it worked

  • The person you added is listed under People with access, with their role.
  • They see the instruction in Shared with me.
  • The line under General access describes the choice you made.

Undo or stop

  • To take someone's access away, choose Remove next to their name.
  • To make a public instruction private again, choose another option under General access. People who already made a copy keep it.

If it doesn't work

What you see What to do
"no one with that handle or email has an account; invite them to the organization instead" They have no account yet, or haven't confirmed their email. Invite them to your organization
"more than one account has that email; use their handle" Type their handle instead of the email
"Someone changed who has access meanwhile — this is it now. Try again." Someone else changed it at the same time. Look at the list again, then make your change
"Only its admins change who has access to it." You aren't an Admin of it. Ask one of them to share it
"this plan keeps … private instructions; make one public, delete one, or upgrade" You reached your plan's limit. See Defaults and limits
"a sealed instruction is end-to-end encrypted and can't be public" Instructions in a sealed workspace can't be public. Choose Only people with access or Everyone in the organization

More fixes are in Something isn't working.

Questions

If I make an instruction public, are my drafts and comments public too?

No. Making it public shows its published versions. The draft, its suggestions and its comments stay with the people who work on it. Nothing is shown until the first version is published.

How do I ask for edit access to someone else's instruction?

Open it and press Request access in the header. Choose Edit to suggest changes, or Maintain to publish, and press Send request. An Admin of the instruction approves or declines it, and you are told in your notifications.

Can I share with someone who has no account?

Not by name: people you add need an account. You can send them a read link, which opens without an account. Or invite them to your organization first.

Who sees an instruction set to Your organization?

Every member of your organization. Guests of the organization don't, unless you add them by name.

Does sharing an instruction share the rest of my workspace?

No. Sharing works on one instruction at a time. The person sees only what you share with them.

For developers: the same actions are MCP tools, listed in the tool reference.

Last checked against the product:

Was this page helpful? Report a problem