Cette page n’est pas encore traduite.

Publish, schedule and write a version message

This page is for Maintainers who are ready to send their draft to agents. You will publish a version now or at a time you choose, and say in a line what changed.

Publishing makes a version: a numbered copy of your draft (v1, v2, v3…) that never changes. Agents follow versions, never your draft. Each version is signed for you, so agents can check who published it.

Before you start

Publish a version

  1. Open Changes

    In the toolbar above the text, choose Changes. It says what publishing will make, for example Changes since v3 and Publishing makes them v4. Until then, agents use v3.

  2. Say what changed

    In the What changed box at the bottom, write a line about this version, such as "Refunds over €150 need approval". It is optional, up to 500 characters, and shows beside the version in History.

  3. Choose whether it goes live

    Leave Make it live — agents switch to it ticked to send it to agents now. Untick it to publish quietly (see Make it live, or publish quietly).

  4. Publish

    Choose Publish, or press Ctrl+Enter (⌘↵ on a Mac) in the message box. The editor says Published v4 — agents that follow it get it now.

Changes: what isn't live yet, the message and Publish.

If you choose Publish with the message box empty, the editor asks What changed? first. Its box starts with a summary of your changes, built from your checkpoints and the list of what changed. Keep it, edit it, or write your own. The box Make it the live version — connected agents switch to it works like the tick in Changes. Then choose Publish.

You can also publish from the command palette, with Publish…, or press Ctrl+Enter (⌘↵ on a Mac) anywhere in the editor.

The first publish asks who can read it.

The first version

The first time you publish an instruction, a sheet opens under the button: Publish “Refunds”. It asks one thing, who can read it:

  • Only you: only you, and the agents you connect, can read it.
  • Your organization: everyone in your organization can read it.
  • Everyone: anyone can read it at its address and find it in Explore.

Only you is chosen to start with. You can change who reads it later, in Share. See Share an instruction.

Choose Publish v1. The first version always goes live, because there is nothing else for agents to follow yet. The sheet's last line says what happens: It goes live, and you get the line that connects your agent.

If the draft has problems, the sheet says 2 problems to fix first and Publish v1 is off. Choose Show to go to the first one.

In a sealed workspace (beta, not yet independently reviewed), Everyone isn't offered. See Sealed workspaces.

Pending suggestions

A version is made of the accepted text only. If suggestions are still waiting, the editor asks first: Publish without the 2 suggestions?

  • Choose Publish without them to publish now. The suggestions stay in the draft until a Maintainer accepts or rejects them.
  • Choose Cancel to review them first. Changes shows 2 suggestions waiting — not in a version until accepted, with Review beside it. See Suggest changes and review them.

The draft without the suggestions must be free of problems too. If it isn't, the editor says how many are left, for example 1 problem to fix before you publish (without the suggestions).

Make it live, or publish quietly

When Make it live is ticked, the new version becomes the live version: the one agents get. History marks it Live.

When it is unticked, you make a quiet version. It is kept and numbered, but agents stay on the version they have. The editor says Made v4 — agents keep the latest until you mark it latest. Use a quiet version to try a change on one agent first, or to prepare a version you will switch to later.

To make a quiet version live later, open History, choose the version, then ⋯ More options ▸ Promote to live…. Roll back or withdraw a version explains promoting. To keep some agents on a version you trust, see Keep agents on a stable version.

Publish it later

You can ask instruction.md to publish your draft at a time you choose, between a couple of minutes from now and 90 days ahead.

  1. Choose Later…

    In Changes, choose Later… beside Publish. For a first version, open More options in the publish sheet and tick Publish it later instead.

  2. Pick a day and a time

    Fill in When — your time (in the sheet, When to publish it — your time). It is the time on your computer. Add a line in What changed if you like.

  3. Schedule it

    Choose Schedule… (in the sheet, Schedule v1). The editor shows the exact time once more, in UTC and your own time. Choose Schedule it. It says Scheduled — the draft is published and the time, as it is then.

Publish it later: a day and a time, up to 90 days ahead.

What to know about a scheduled publish:

  • It publishes the draft as it is then, not as it is now. Edits you make before that time are in it. Suggestions still waiting then are left out.
  • It runs as you. Nobody is asked again. It doesn't run if you can no longer publish this instruction then, if the draft has a problem, or if nothing changed since the live version.
  • It always goes live. Later… shows only while Make it live is ticked. There is no quiet scheduled version.
  • You are told. Your Inbox says when it ran and which version it made, or why it didn't run.
  • You can see and cancel it in Changes. Under Scheduled to publish, each one says when, who asked for it and its message. Choose Cancel to stop it. The editor says Cancelled — nothing is published and the time. Any Maintainer can cancel it. Changes also lists the ones that ran or failed in the last 30 days.
  • A sealed instruction can't be published later yet. Publish it now instead.

What agents do next

As soon as a version goes live, agents that follow the instruction's live version switch to it. They don't need to be restarted.

  • A coding agent such as Claude Code or Codex gets the new version at your next prompt. Make your team's coding agents follow an instruction explains when each tool switches.
  • An agent that stays on one exact version, or follows a name such as stable, doesn't switch.
  • A quiet version reaches no one until you promote it.

To see which agents have which version, see See which agents follow an instruction.

Check it worked

  • The version in the header shows the new number, such as v4.
  • History has the new version at the top, marked Live (unless you published quietly), with your message.
  • Changes says No changes since v4.

Undo or stop

  • A version can't be deleted or changed. To send agents back to an earlier one, promote it in History. To stop agents using a version, revoke it. Both are in Roll back or withdraw a version.
  • A scheduled publish can be cancelled in Changes until it runs.
  • Your draft is never touched by publishing. Keep editing; nothing reaches agents until you publish again.

If it doesn't work

What you see Why, and what to do
Publish is greyed out Hover over it to see why. Common reasons: The draft is live v3 already — nothing to publish, Nothing written yet — nothing to publish, or Maintainers publish versions — your suggestions go in once accepted.
2 problems to fix before you publish. Fix them first. The editor shows the first one. See Check your instruction before you publish.
Sign in to publish You are writing without an account. Sign in, then publish. See Write without an account.
Pick a time at least a couple of minutes from now or Pick a time within 90 days Choose a time inside that window.
A message that your plan makes a number of versions a month You have reached this month's versions. See Plans, limits and billing.
Still stuck Ask us.

Questions

Do I have to write a version message?

No, it is optional. It helps the people who read History later, and the people who review what an agent was told. If you leave it empty, the editor offers a summary of your changes to start from.

Can I change a version after publishing it?

No. A version never changes, so every agent that has it reads exactly the same text. Edit the draft and publish a new version instead.

Who can publish?

Maintainers of the instruction. Contributors suggest changes, and a Maintainer accepts and publishes them. See Invite people and choose their roles.

What happens to a scheduled publish if I edit the draft afterwards?

Your edits are in it. A scheduled publish takes the draft as it is at that time, as you.

Does publishing quietly reach any agent?

Not through the live version. Agents keep the version they have until you promote the quiet one. See Roll back or withdraw a version.

For developers: publishing, quiet versions and scheduled publishing are also available to agents and scripts. See the Tool reference.

Last checked against the product:

Was this page helpful? Report a problem