See which agents follow an instruction

Every agent and AI app that follows a published instruction shows up in the editor, with the version it has. This page shows you where to look, what each line means, and how to pause or disconnect one.

Before you start

Open the Agents card

  1. Open the instruction

    Open the instruction in the editor. In the header, beside the publish button, you see faces: the agents that follow it, and the people who have it open. A line such as 3 agents read this sums them up. Agents in trouble come first.

  2. Choose the faces

    Choose the faces. The Agents card opens, with how many there are, and the instruction's name and version. You can also open it from the command palette with Agents following this. Use the palette when no agent follows it yet: then there are no faces to choose.

The card keeps itself up to date while it is open: a new version, an agent that switches, an agent that reports in.

The Agents card: each agent's state, version and app.

Read the card

Each row is one agent: its name, what it runs on (for example on build-server-2), and one line about its state. The first word of that line is the state:

State What it means What the rest of the line can say
Up to date It has the version it should have. has v7, with ✓ when the agent itself reported it; seen 2 min ago
Behind A newer version is out, and it doesn't have it yet. has v6, not v7; told, not switched: it was told about the new version and hasn't moved yet
Paused An Admin paused its updates. stays on v6, or updates held
Problem It can't follow it as it should. has v5, which was revoked, or it can't follow it

The line can also say:

  • pinned to v3: it follows one exact version, which never changes;
  • follows stable: it follows a name other than the live version;
  • listening (push) or listening (poll): it gets live updates now;
  • offline 3 h ago: it had live updates, and stopped.

Hover over the line to see whose agent it is and since when it follows, for example As dev · following since 8 Nov 2026, 10:04.

The rows are in order: problems first, then agents that are behind, then up to date, then paused.

Under the list, a line counts the agents by the app they run in, for example By app: 3 in Claude Code and 1 in Codex.

An agent that the runner starts for you has one more button, Open the chat with …, which opens its conversation in the Agents app.

The ⋯ menu has Copy the instruction's address. At the bottom, Connect an agent (or Connect another agent) opens the setup for a new one.

Pause, resume or disconnect an agent

  1. Pause its updates

    To keep an agent on the version it has, choose the pause button on its row (Pause updates to …). It keeps its last version and is told that its updates are paused. Its line says Paused · stays on v6. Only Admins of the instruction can pause.

  2. Resume them

    Choose the same button again (Resume updates to …). The agent gets the current version again.

  3. Disconnect it

    Choose the disconnect button on its row (Disconnect …). The card asks in place: Disconnect …? It stops counting as following this. What it may read stays as Share has it. Choose Disconnect to confirm, or Cancel. You can disconnect your own agents; Admins can disconnect anyone's.

Disconnecting only takes the agent off the list. It doesn't take away what it may read. To stop an agent reading the instruction, change who can read it under Share (Share an instruction), or disconnect the AI app itself under Your account ▸ Connected apps (Connected apps).

See what your agents have for one line

While you change a published instruction, you can check what your agents have for any line you changed.

  1. Find a changed line

    In the text, rest the pointer in the margin to the left of a line you added or changed. You can also put the cursor on the line and choose What your agents have for this line in the command palette.

  2. Read the peek

    A small card opens under the line. It says one of:

    • Not with your agents yet: the line is new, and the version your agents follow doesn't have it. It shows the faces of those agents.
    • What your agents read now · v7: the line changed. It shows the line as published, with what you removed and added.
    • Renumbered: the rule has another number in the published version. Agents that cite the old number mean this rule.
  3. Act on it

    Choose All changes to see every change since the published version, Revert line to put the line back as published, or Publish v8 to publish your changes.

The peek isn't shown on a phone.

The peek shows what your agents have for one line.

Live updates on the free plan

Some plans give live updates to only a set number of agents and AI apps at a time. This is how many each plan allows:

Plans Community 1 · Pro unlimited · Team unlimited · Enterprise unlimited

On such a plan, the card says so under the list, with your plan's name and number, and that the others still read the latest version whenever they check.

An agent without live updates still works. It reads the latest version whenever it checks, and it still shows on the card. It may just be Behind for a little longer, until it next checks. Plans and limits.

Analytics

The Analytics page, which you open from the command palette, counts your instructions, how many are live, your favorites and your folders. Its Agents' reads section doesn't show reads yet. For which version each agent has, use the Agents card.

If something doesn't look right

What you see Why What to do
Not published yet Agents follow published versions only. Choose Publish… on the card.
No agent yet Nobody follows it yet, or no agent has read it since it was published. Connect one with Connect an agent. It shows once it reads the instruction.
No agent of yours yet You aren't an Admin of the instruction, so you see only your own agents. Ask an Admin, or connect an agent of your own.
Couldn't load the agents The editor couldn't reach instruction.md. Check your connection. The card tries again every minute while the page is open.
An agent stays Behind, told, not switched It was told about the new version and hasn't taken it yet. A coding agent takes it at the developer's next prompt. Wait for its next step, or check that its updates aren't paused.
Couldn't pause … or Couldn't disconnect … instruction.md refused, and says why after the name. Check your role on the instruction.

Still stuck? Ask us, or see Something isn't working.

Questions

How do I see which agents follow an instruction and which version each one has?

Open the instruction and choose the faces in the header. The Agents card lists each agent with its state and the version it has. Admins of the instruction see every agent; others see their own. See Read the card.

How do I pause updates to one agent, or disconnect it?

On the agent's row in the Agents card, choose the pause button, or Disconnect …. Pausing keeps it on its version until you resume. Disconnecting takes it off the list, but doesn't change what it may read. See Pause, resume or disconnect an agent.

What does the ✓ after a version mean?

The agent itself reported that it applied that version. Without the ✓, the version is the one it last read. See Read the card.

Why is an agent behind?

A newer version is out and the agent hasn't taken it yet. It may be between steps, its updates may be paused, or it may check only from time to time. See If something doesn't look right.

Last checked against the product:

Was this page helpful? Report a problem